[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75X9H4YYF5C29JR7AF44K84":3,"skill-same:01M75X9H4YYF5C29JR7AF44K84":65},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":41,"commitSha":42,"skillDirectory":43,"forksCount":44,"repositoryHtmlUrl":45,"repositoryHomepageUrl":46,"ownerHtmlUrl":47,"ownerBlogUrl":48,"ownerDescription":49,"updatedAt":50,"install":51,"resources":64},"01M75X9H4YYF5C29JR7AF44K84","repowiki-conclusion-update",null,"已落库 repowiki 结论发生变化时，按「结论方向 vs 表述」分流：方向变则新写 decision 笔记+reject_note 旧+confirm 并回源 ADR，仅表述\u002F证据变则 edit_doc_file 原地改","mambo-wang\u002FCodeWiki-Plus","mambo-wang","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F17296917?v=4","01M75489WXT2KCG0TDVRGMTEET","WanderingBug","01M75WY0F23J9DB5GBVTH8F8Q9",21,"MIT","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Frepowiki-conclusion-update\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: repowiki-conclusion-update\ndescription: 已落库 repowiki 结论发生变化时，按「结论方向 vs 表述」分流：方向变则新写 decision 笔记+reject_note 旧+confirm 并回源 ADR，仅表述\u002F证据变则 edit_doc_file 原地改\ntype: Skill\nstatus: stable\ngenerated:\n  by: codewiki\u002F5.9.0\n  at: \"2026-09-10T09:06:45Z\"\nstale_after: 2026-12-09\nmetadata:\n  summary: 已落库结论变更的更新流程：wiki 页 edit_doc_file 原地改 \u002F 笔记 reject+confirm 新写 \u002F ADR 回源同步\n  source_refs: [\"notes\u002F2026-09-10-已落库结论变更的更新流程wiki-页-edit-doc-file-原地改笔记新写reject-note-旧的confir.md\"]\n  revisions: [\"at: \\\"2026-09-10T09:06:45Z\\\"\"]\n  reason: created from candidate materials\n  source: skill_creator\n  installed_at: \"2026-09-10T09:37:32Z\"\n  installed_to: .codebuddy\u002Fskills\u002Frepowiki-conclusion-update\u002F\n  installed_hash: \"sha256:4c47466a3c507d68c911cf1bc514c299dbe4d9cb7989c31ffe4a303cf23bf10a\"\n---\n\n\n## 工作场景\n已落库的 repowiki 结论（wiki 页面或 notes\u002F 笔记）需要变化时使用：知识库维护、方案演进、设计裁决变更、结论到期复核。\n\n## 适用条件\n- 结论已 stable 或 draft 存在于 repowiki（wiki\u002Fqueries\u002F、wiki\u002Fcomparisons\u002F、notes\u002F）。\n- 须先区分「改同一结论的表述\u002F证据」与「改结论方向」两类（见判断逻辑）。\n- 不用于未落库的新结论（直接 ingest_note）；不用于物理删除（用 reject_note 标记而非删文件）。\n\n## 核心 SOP\n依据: notes\u002F2026-09-10-已落库结论变更的更新流程wiki-页-edit-doc-file-原地改笔记新写reject-note-旧的confir.md 的「分两条路径」与「标准三步」。\n\n1. **wiki 页面**（wiki\u002Fqueries\u002F、wiki\u002Fcomparisons\u002F）→ `edit_doc_file` 就地编辑：\n   - `str_replace` 改结论段落（按 body 去重，不受 frontmatter 回声干扰）；\n   - `insert` 补「决策变更记录」小节；\n   - `undo` 回滚（历史在 `.meta\u002Fedit_history.json`，加锁防并发）。\n   - 编辑后自动刷新 page manifest、BM25 索引、`wiki\u002Flog.md`。\n   - ⚠️ 页面带 `sources`(content_hash) 时，改完 `lint_wiki` 的 `stale_evidence` 只报复核提醒、不自动改写。\n2. **笔记结论**（notes\u002F）→ 新写 + 显式退役旧的：\n   - `ingest_note(note_type=\"decision\", ...)` 写新结论，正文点明「修正\u002F取代哪条、为什么」；\n   - `reject_note(note_file=\"notes\u002F旧结论.md\", reason=\"被 \u003C新> 取代：…\")` → 置 `deprecated` 并从检索剔除（note_lifecycle.py:93-116）；superseded 归一成 deprecated；\n   - `confirm_note(note_file=新)` → 转 stable、续期 stale_after。\n   - 同主题多条合成一条用 `note_merge`（标题 replace\u002F正文 append\u002Ftags union，产物仍 draft）。\n3. **仅到期复核（未变）→ 续期或退役**：decision\u002Farchitecture 365 天、pitfall\u002Flesson 180、workaround 45 窗口；仍成立 `confirm_note` 续期，不成立 `reject_note`。\n4. **回源**：结论变化源头通常在 `docs\u002F`，先改 `docs\u002Fadr\u002FNNNN-*.md`（冲突写 `Contradicts ADR-000X`），再更新 repowiki，避免二次漂移。\n\n## 判断逻辑\n- 改「同一结论的表述\u002F证据」→ `edit_doc_file` 原地改（路径 1）。\n- 改「结论方向」→ 新写 decision 笔记 + `reject_note` 旧 + `confirm` 新 + 同步 ADR（路径 2）。\n- 仅过期未变 → 路径 3 续期\u002F退役。\n\n## 禁忌与反模式\n- 勿用 `ingest_note` 想「覆盖」同名旧结论：同 slug 同正文返回 `already_exists`，不同正文只追加新文件，旧结论仍 stable 占坑 → 必须显式 `reject_note` 旧的。\n- 勿直接物理删除 notes 文件：用 `reject_note` 标记 deprecated，保持溯源链与检索剔除可审计。\n- 勿只改 repowiki 不回源 `docs\u002Fadr`：会造成二次漂移（docs 与 wiki 结论打架）。\n- 页面带 `sources` 时改完别指望 lint 自动改写证据，只报提醒。\n\n","## 工作场景\n已落库的 repowiki 结论（wiki 页面或 notes\u002F 笔记）需要变化时使用：知识库维护、方案演进、设计裁决变更、结论到期复核。\n\n## 适用条件\n- 结论已 stable 或 draft 存在于 repowiki（wiki\u002Fqueries\u002F、wiki\u002Fcomparisons\u002F、notes\u002F）。\n- 须先区分「改同一结论的表述\u002F证据」与「改结论方向」两类（见判断逻辑）。\n- 不用于未落库的新结论（直接 ingest_note）；不用于物理删除（用 reject_note 标记而非删文件）。\n\n## 核心 SOP\n依据: notes\u002F2026-09-10-已落库结论变更的更新流程wiki-页-edit-doc-file-原地改笔记新写reject-note-旧的confir.md 的「分两条路径」与「标准三步」。\n\n1. **wiki 页面**（wiki\u002Fqueries\u002F、wiki\u002Fcomparisons\u002F）→ `edit_doc_file` 就地编辑：\n   - `str_replace` 改结论段落（按 body 去重，不受 frontmatter 回声干扰）；\n   - `insert` 补「决策变更记录」小节；\n   - `undo` 回滚（历史在 `.meta\u002Fedit_history.json`，加锁防并发）。\n   - 编辑后自动刷新 page manifest、BM25 索引、`wiki\u002Flog.md`。\n   - ⚠️ 页面带 `sources`(content_hash) 时，改完 `lint_wiki` 的 `stale_evidence` 只报复核提醒、不自动改写。\n2. **笔记结论**（notes\u002F）→ 新写 + 显式退役旧的：\n   - `ingest_note(note_type=\"decision\", ...)` 写新结论，正文点明「修正\u002F取代哪条、为什么」；\n   - `reject_note(note_file=\"notes\u002F旧结论.md\", reason=\"被 \u003C新> 取代：…\")` → 置 `deprecated` 并从检索剔除（note_lifecycle.py:93-116）；superseded 归一成 deprecated；\n   - `confirm_note(note_file=新)` → 转 stable、续期 stale_after。\n   - 同主题多条合成一条用 `note_merge`（标题 replace\u002F正文 append\u002Ftags union，产物仍 draft）。\n3. **仅到期复核（未变）→ 续期或退役**：decision\u002Farchitecture 365 天、pitfall\u002Flesson 180、workaround 45 窗口；仍成立 `confirm_note` 续期，不成立 `reject_note`。\n4. **回源**：结论变化源头通常在 `docs\u002F`，先改 `docs\u002Fadr\u002FNNNN-*.md`（冲突写 `Contradicts ADR-000X`），再更新 repowiki，避免二次漂移。\n\n## 判断逻辑\n- 改「同一结论的表述\u002F证据」→ `edit_doc_file` 原地改（路径 1）。\n- 改「结论方向」→ 新写 decision 笔记 + `reject_note` 旧 + `confirm` 新 + 同步 ADR（路径 2）。\n- 仅过期未变 → 路径 3 续期\u002F退役。\n\n## 禁忌与反模式\n- 勿用 `ingest_note` 想「覆盖」同名旧结论：同 slug 同正文返回 `already_exists`，不同正文只追加新文件，旧结论仍 stable 占坑 → 必须显式 `reject_note` 旧的。\n- 勿直接物理删除 notes 文件：用 `reject_note` 标记 deprecated，保持溯源链与检索剔除可审计。\n- 勿只改 repowiki 不回源 `docs\u002Fadr`：会造成二次漂移（docs 与 wiki 结论打架）。\n- 页面带 `sources` 时改完别指望 lint 自动改写证据，只报提醒。\n\n",{"name":5,"type":24,"status":25,"metadata":26,"generated":37,"description":7,"stale_after":40},"Skill","stable",{"reason":27,"source":28,"summary":29,"revisions":30,"source_refs":32,"installed_at":34,"installed_to":35,"installed_hash":36},"created from candidate materials","skill_creator","已落库结论变更的更新流程：wiki 页 edit_doc_file 原地改 \u002F 笔记 reject+confirm 新写 \u002F ADR 回源同步",[31],"at: \"2026-09-10T09:06:45Z\"",[33],"notes\u002F2026-09-10-已落库结论变更的更新流程wiki-页-edit-doc-file-原地改笔记新写reject-note-旧的confir.md","2026-09-10T09:37:32Z",".codebuddy\u002Fskills\u002Frepowiki-conclusion-update\u002F","sha256:4c47466a3c507d68c911cf1bc514c299dbe4d9cb7989c31ffe4a303cf23bf10a",{"at":38,"by":39},"2026-09-10T09:06:45Z","codewiki\u002F5.9.0",1796774400000,"develop","ba8919e7a5182cc94dbe3e9b3a46f4c2e8fa209d","repowiki\u002Fskills\u002Frepowiki-conclusion-update",4,"https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus","https:\u002F\u002Fpypi.org\u002Fproject\u002Fcodewiki-plus\u002F","https:\u002F\u002Fgithub.com\u002Fmambo-wang","https:\u002F\u002Fblog.csdn.net\u002Fsinat_27143551","专注Java后端开发，喜欢运动","2026-11-13 15:29:46",{"source":8,"skillName":5,"commands":52,"prompt":62,"zipAvailable":63},[53,56,59],{"tool":54,"command":55},"npx","npx skills add mambo-wang\u002FCodeWiki-Plus --skill repowiki-conclusion-update",{"tool":57,"command":58},"bunx","bunx skills add mambo-wang\u002FCodeWiki-Plus --skill repowiki-conclusion-update",{"tool":60,"command":61},"pnpm","pnpm dlx skills add mambo-wang\u002FCodeWiki-Plus --skill repowiki-conclusion-update","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Frepowiki-conclusion-update\u002FSKILL.md",true,[],[66,73,80,87,94,101],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M75XA78546E66PCC3JV2TM3Q","write-doc-file-content-file-sidechannel","write_doc_file 建档报目标路径已被手写文件占用\u002F路由冲突时——走 content_file 临时文件侧通道：正文写临时文件→删占位文件→write_doc_file(content_file=...) 正式建档→删临时文件","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Fwrite-doc-file-content-file-sidechannel\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M75X9YQNDX8B6ZEVMKGM2TYR","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 核对","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Fwindows-python-release\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M75X9MGBPRG6JDCRAY97E5T0","windows-dev-env","Windows\u002FPowerShell 下做 git 写操作、跑子进程或批量文件\u002F测试清理时：shell 漂移与中文路径致命令静默失败、无控制台宿主子进程闪窗、GCM 每次弹 OAuth 框、原生 DLL 被锁——须显式复核落盘、subprocess 加 CREATE_NO_WINDOW、gh auth setup-git 持久化凭据，并用 cmd \u002Fc 绕 safe-delete 钩子","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Fwindows-dev-env\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M75X9CD6FDMX1RDE9NZEFNVY","maintain-fork-pr-merge","当合入 fork 来源的 PR 且 mergeStateStatus=CONFLICTING\u002FDIRTY 时——先 git merge-tree 探测冲突清单，查 maintainer_can_modify，再在 worktree 隔离目录解冲突后 push fork 分支，勿因 CI 绿直接 merge","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Fmaintain-fork-pr-merge\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M75X98KRKX80JQ9Y4PR8WZCK","git-commit-hygiene","在共享 worktree 多会话并行或暂存区有残留时提交代码——用显式 pathspec 只提交自己的文件并排除临时目录，禁止 git add -A 或裸 commit 扫入并行会话的改动","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Fgit-commit-hygiene\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":19},"01M75X974418SW9AX2J45B43Q0","writing-shape","Writing, exploit: shape raw material into an article, paragraph by paragraph.","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002F.trae\u002Fskills\u002Fwriting-shape\u002FSKILL.md",[],[]]