AGENT SKILL

repowiki-conclusion-update

已落库 repowiki 结论发生变化时,按「结论方向 vs 表述」分流:方向变则新写 decision 笔记+reject_note 旧+confirm 并回源 ADR,仅表述/证据变则 edit_doc_file 原地改

License 许可
MIT
最近更新
2026-11-13
Stars
★ 21
Forks
4

01 前言 Front Matter

name
repowiki-conclusion-update
type
Skill
status
stable
metadata
{ "reason": "created from candidate materials", "source": "skill_creator", "summary": "已落库结论变更的更新流程:wiki 页 edit_doc_file 原地改 / 笔记 reject+confirm 新写 / ADR 回源同步", "revisions": [ "at: \"2026-09-10T09:06:45Z\"" ], "source_refs": [ "notes/2026-09-10-已落库结论变更的更新流程wiki-页-edit-doc-file-原地改笔记新写reject-note-旧的confir.md" ], "installed_at": "2026-09-10T09:37:32Z", "installed_to": ".codebuddy/skills/repowiki-conclusion-update/", "installed_hash": "sha256:4c47466a3c507d68c911cf1bc514c299dbe4d9cb7989c31ffe4a303cf23bf10a" }
generated
{ "at": "2026-09-10T09:06:45Z", "by": "codewiki/5.9.0" }
description
已落库 repowiki 结论发生变化时,按「结论方向 vs 表述」分流:方向变则新写 decision 笔记+reject_note 旧+confirm 并回源 ADR,仅表述/证据变则 edit_doc_file 原地改
stale_after
1796774400000

03 SKILL.md 正文

工作场景

已落库的 repowiki 结论(wiki 页面或 notes/ 笔记)需要变化时使用:知识库维护、方案演进、设计裁决变更、结论到期复核。

适用条件

  • 结论已 stable 或 draft 存在于 repowiki(wiki/queries/、wiki/comparisons/、notes/)。
  • 须先区分「改同一结论的表述/证据」与「改结论方向」两类(见判断逻辑)。
  • 不用于未落库的新结论(直接 ingest_note);不用于物理删除(用 reject_note 标记而非删文件)。

核心 SOP

依据: notes/2026-09-10-已落库结论变更的更新流程wiki-页-edit-doc-file-原地改笔记新写reject-note-旧的confir.md 的「分两条路径」与「标准三步」。

  1. wiki 页面(wiki/queries/、wiki/comparisons/)→ edit_doc_file 就地编辑:
    • str_replace 改结论段落(按 body 去重,不受 frontmatter 回声干扰);
    • insert 补「决策变更记录」小节;
    • undo 回滚(历史在 .meta/edit_history.json,加锁防并发)。
    • 编辑后自动刷新 page manifest、BM25 索引、wiki/log.md。
    • ⚠️ 页面带 sources(content_hash) 时,改完 lint_wiki 的 stale_evidence 只报复核提醒、不自动改写。
  2. 笔记结论(notes/)→ 新写 + 显式退役旧的:
    • ingest_note(note_type="decision", ...) 写新结论,正文点明「修正/取代哪条、为什么」;
    • reject_note(note_file="notes/旧结论.md", reason="被 <新> 取代:…") → 置 deprecated 并从检索剔除(note_lifecycle.py:93-116);superseded 归一成 deprecated;
    • confirm_note(note_file=新) → 转 stable、续期 stale_after。
    • 同主题多条合成一条用 note_merge(标题 replace/正文 append/tags union,产物仍 draft)。
  3. 仅到期复核(未变)→ 续期或退役:decision/architecture 365 天、pitfall/lesson 180、workaround 45 窗口;仍成立 confirm_note 续期,不成立 reject_note。
  4. 回源:结论变化源头通常在 docs/,先改 docs/adr/NNNN-*.md(冲突写 Contradicts ADR-000X),再更新 repowiki,避免二次漂移。

判断逻辑

  • 改「同一结论的表述/证据」→ edit_doc_file 原地改(路径 1)。
  • 改「结论方向」→ 新写 decision 笔记 + reject_note 旧 + confirm 新 + 同步 ADR(路径 2)。
  • 仅过期未变 → 路径 3 续期/退役。

禁忌与反模式

  • 勿用 ingest_note 想「覆盖」同名旧结论:同 slug 同正文返回 already_exists,不同正文只追加新文件,旧结论仍 stable 占坑 → 必须显式 reject_note 旧的。
  • 勿直接物理删除 notes 文件:用 reject_note 标记 deprecated,保持溯源链与检索剔除可审计。
  • 勿只改 repowiki 不回源 docs/adr:会造成二次漂移(docs 与 wiki 结论打架)。
  • 页面带 sources 时改完别指望 lint 自动改写证据,只报提醒。

04 同仓库更多 Skills

mambo-wang
mambo-wang/CodeWiki-Plus

write-doc-file-content-file-sidechannel

write_doc_file 建档报目标路径已被手写文件占用/路由冲突时——走 content_file 临时文件侧通道:正文写临时文件→删占位文件→write_doc_file(content_file=...) 正式建档→删临时文件

★ 21
mambo-wang
mambo-wang/CodeWiki-Plus

windows-python-release

当要手动发布 Python 包(codewiki-plus)到 PyPI 并建 GitHub Release 时——CI 不发布、Windows 控制台为 GBK、可能无 gh CLI、本机网络对 upload.pypi.org 的 Python TLS 握手有干扰——先核对 tag 区间与工作区未提交改动定 bump 级别,再按 8 步主干执行:同步四处版本→bump 提交(只 add 具体文件)→聚焦+ruff+全量闸门→清 dist 构建→PR 合并 main→tag merge commit 建 Release→uv publish(TLS 超时则 curl.exe 直传)→PyPI JSON API 核对

★ 21
mambo-wang
mambo-wang/CodeWiki-Plus

windows-dev-env

Windows/PowerShell 下做 git 写操作、跑子进程或批量文件/测试清理时:shell 漂移与中文路径致命令静默失败、无控制台宿主子进程闪窗、GCM 每次弹 OAuth 框、原生 DLL 被锁——须显式复核落盘、subprocess 加 CREATE_NO_WINDOW、gh auth setup-git 持久化凭据,并用 cmd /c 绕 safe-delete 钩子

★ 21
mambo-wang
mambo-wang/CodeWiki-Plus

maintain-fork-pr-merge

当合入 fork 来源的 PR 且 mergeStateStatus=CONFLICTING/DIRTY 时——先 git merge-tree 探测冲突清单,查 maintainer_can_modify,再在 worktree 隔离目录解冲突后 push fork 分支,勿因 CI 绿直接 merge

★ 21
mambo-wang
mambo-wang/CodeWiki-Plus

git-commit-hygiene

在共享 worktree 多会话并行或暂存区有残留时提交代码——用显式 pathspec 只提交自己的文件并排除临时目录,禁止 git add -A 或裸 commit 扫入并行会话的改动

★ 21
mambo-wang
mambo-wang/CodeWiki-Plus

writing-shape

Writing, exploit: shape raw material into an article, paragraph by paragraph.

★ 21