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 的「分两条路径」与「标准三步」。
- 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只报复核提醒、不自动改写。
- 笔记结论(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)。
- 仅到期复核(未变)→ 续期或退役:decision/architecture 365 天、pitfall/lesson 180、workaround 45 窗口;仍成立
confirm_note续期,不成立reject_note。 - 回源:结论变化源头通常在
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
write-doc-file-content-file-sidechannel
write_doc_file 建档报目标路径已被手写文件占用/路由冲突时——走 content_file 临时文件侧通道:正文写临时文件→删占位文件→write_doc_file(content_file=...) 正式建档→删临时文件
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 核对
windows-dev-env
Windows/PowerShell 下做 git 写操作、跑子进程或批量文件/测试清理时:shell 漂移与中文路径致命令静默失败、无控制台宿主子进程闪窗、GCM 每次弹 OAuth 框、原生 DLL 被锁——须显式复核落盘、subprocess 加 CREATE_NO_WINDOW、gh auth setup-git 持久化凭据,并用 cmd /c 绕 safe-delete 钩子
maintain-fork-pr-merge
当合入 fork 来源的 PR 且 mergeStateStatus=CONFLICTING/DIRTY 时——先 git merge-tree 探测冲突清单,查 maintainer_can_modify,再在 worktree 隔离目录解冲突后 push fork 分支,勿因 CI 绿直接 merge
git-commit-hygiene
在共享 worktree 多会话并行或暂存区有残留时提交代码——用显式 pathspec 只提交自己的文件并排除临时目录,禁止 git add -A 或裸 commit 扫入并行会话的改动
writing-shape
Writing, exploit: shape raw material into an article, paragraph by paragraph.