[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75XA78546E66PCC3JV2TM3Q":3,"skill-same:01M75XA78546E66PCC3JV2TM3Q":62},{"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":38,"commitSha":39,"skillDirectory":40,"forksCount":41,"repositoryHtmlUrl":42,"repositoryHomepageUrl":43,"ownerHtmlUrl":44,"ownerBlogUrl":45,"ownerDescription":46,"updatedAt":47,"install":48,"resources":61},"01M75XA78546E66PCC3JV2TM3Q","write-doc-file-content-file-sidechannel",null,"write_doc_file 建档报目标路径已被手写文件占用\u002F路由冲突时——走 content_file 临时文件侧通道：正文写临时文件→删占位文件→write_doc_file(content_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\u002Fwrite-doc-file-content-file-sidechannel\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: write-doc-file-content-file-sidechannel\ndescription: write_doc_file 建档报目标路径已被手写文件占用\u002F路由冲突时——走 content_file 临时文件侧通道：正文写临时文件→删占位文件→write_doc_file(content_file=...) 正式建档→删临时文件\ntype: Skill\nstatus: draft\ngenerated:\n  by: codewiki\u002F5.13.1\n  at: \"2026-09-27T05:07:21Z\"\nstale_after: 2026-12-26\nmetadata:\n  summary: write_doc_file 建档遇手写文件占位冲突时的 content_file 侧通道四步流程\n  source_refs: [\"notes\u002F2026-09-27-write-doc-file-建档遇目标路径已被手写文件占用时走-content-file-临时文件侧通道.md\"]\n  revisions:\n    - at: \"2026-09-27T05:07:21Z\"\n      reason: created from candidate materials\n      source: skill_creator\n---\n\n## 工作场景\n需要用 CodeWiki 的 write_doc_file 正式建档 wiki 页面（注入 frontmatter、注册交叉链接与索引），但目标路径上已存在手写文件（如先前用 write_to_file 起草的占位稿），直接调用会触发文件路由冲突被拒绝写入。\n\n## 适用条件\n- 使用 write_doc_file 建档（page_type=module\u002Fentity\u002Fconcept\u002Fquery\u002Fcomparison\u002Fsource 等），且需要工具负责的元数据注入（frontmatter、交叉链接、索引注册）。\n- 目标路径已被手写文件占用，工具报「目标路径已存在 \u002F 路由冲突」类错误。\n- 不适用于普通笔记归档（走 ingest_note，无路径冲突问题）；也不适用于编辑已有正式页面（直接 edit_doc_file）。\n\n## 核心 SOP\n依据: notes\u002F2026-09-27-write-doc-file-建档遇目标路径已被手写文件占用时走-content-file-临时文件侧通道.md 的「content_file 侧通道建档流程」（2026-09-25 agentmemory 调研建档实际跑通）。\n\n1. 把页面正文写入一个临时文件（如 `.codebuddy\u002Ftmp-\u003C页面名>.md`），只写正文、不写 frontmatter——元数据由工具注入；\n2. 删除目标路径上已手写的占位文件（内容已在第 1 步保全，删除无损失）；\n3. 调用 `write_doc_file(content_file=\u003C临时文件路径>, ...)` 让工具从临时文件读正文并正式建档；\n4. 建档成功后删除临时文件，收尾复核新页面 frontmatter 齐全。\n\n## 判断逻辑\n- write_doc_file 报目标路径冲突 → 先确认冲突文件是手写占位（无工具注入的 frontmatter），是则走侧通道；若已是工具建的正式页面，改用 edit_doc_file 编辑，不要删了重建（会丢 revisions\u002Fedit 历史）。\n- 正文很大（接近 MCP 参数限制）→ 更应走 content_file 文件侧通道，顺带规避大载荷内联传输问题。\n- 手写文件内容与拟建页面无关（纯误占位）→ 可直接删，无需第 1 步保全。\n\n## 禁忌与反模式\n- 勿因冲突就放弃 write_doc_file、让手写文件充当正式页面：缺 frontmatter\u002F索引注册，页面不进检索与 wikilink 图。\n- 勿绕过 dispatch 直连 handler 写文件——路由冲突是确定性簿记在保护建档一致性。\n- 勿把临时文件留在仓库工作树里忘记清理（第 4 步必做）。\n- 勿在临时文件里手写 frontmatter：与工具注入的元数据冲突或产生重复段。\n","## 工作场景\n需要用 CodeWiki 的 write_doc_file 正式建档 wiki 页面（注入 frontmatter、注册交叉链接与索引），但目标路径上已存在手写文件（如先前用 write_to_file 起草的占位稿），直接调用会触发文件路由冲突被拒绝写入。\n\n## 适用条件\n- 使用 write_doc_file 建档（page_type=module\u002Fentity\u002Fconcept\u002Fquery\u002Fcomparison\u002Fsource 等），且需要工具负责的元数据注入（frontmatter、交叉链接、索引注册）。\n- 目标路径已被手写文件占用，工具报「目标路径已存在 \u002F 路由冲突」类错误。\n- 不适用于普通笔记归档（走 ingest_note，无路径冲突问题）；也不适用于编辑已有正式页面（直接 edit_doc_file）。\n\n## 核心 SOP\n依据: notes\u002F2026-09-27-write-doc-file-建档遇目标路径已被手写文件占用时走-content-file-临时文件侧通道.md 的「content_file 侧通道建档流程」（2026-09-25 agentmemory 调研建档实际跑通）。\n\n1. 把页面正文写入一个临时文件（如 `.codebuddy\u002Ftmp-\u003C页面名>.md`），只写正文、不写 frontmatter——元数据由工具注入；\n2. 删除目标路径上已手写的占位文件（内容已在第 1 步保全，删除无损失）；\n3. 调用 `write_doc_file(content_file=\u003C临时文件路径>, ...)` 让工具从临时文件读正文并正式建档；\n4. 建档成功后删除临时文件，收尾复核新页面 frontmatter 齐全。\n\n## 判断逻辑\n- write_doc_file 报目标路径冲突 → 先确认冲突文件是手写占位（无工具注入的 frontmatter），是则走侧通道；若已是工具建的正式页面，改用 edit_doc_file 编辑，不要删了重建（会丢 revisions\u002Fedit 历史）。\n- 正文很大（接近 MCP 参数限制）→ 更应走 content_file 文件侧通道，顺带规避大载荷内联传输问题。\n- 手写文件内容与拟建页面无关（纯误占位）→ 可直接删，无需第 1 步保全。\n\n## 禁忌与反模式\n- 勿因冲突就放弃 write_doc_file、让手写文件充当正式页面：缺 frontmatter\u002F索引注册，页面不进检索与 wikilink 图。\n- 勿绕过 dispatch 直连 handler 写文件——路由冲突是确定性簿记在保护建档一致性。\n- 勿把临时文件留在仓库工作树里忘记清理（第 4 步必做）。\n- 勿在临时文件里手写 frontmatter：与工具注入的元数据冲突或产生重复段。\n",{"name":5,"type":24,"status":25,"metadata":26,"generated":35,"description":7,"stale_after":37},"Skill","draft",{"summary":27,"revisions":28,"source_refs":33},"write_doc_file 建档遇手写文件占位冲突时的 content_file 侧通道四步流程",[29],{"at":30,"reason":31,"source":32},"2026-09-27T05:07:21Z","created from candidate materials","skill_creator",[34],"notes\u002F2026-09-27-write-doc-file-建档遇目标路径已被手写文件占用时走-content-file-临时文件侧通道.md",{"at":30,"by":36},"codewiki\u002F5.13.1",1798243200000,"develop","ba8919e7a5182cc94dbe3e9b3a46f4c2e8fa209d","repowiki\u002Fskills\u002Fwrite-doc-file-content-file-sidechannel",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":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add mambo-wang\u002FCodeWiki-Plus --skill write-doc-file-content-file-sidechannel",{"tool":54,"command":55},"bunx","bunx skills add mambo-wang\u002FCodeWiki-Plus --skill write-doc-file-content-file-sidechannel",{"tool":57,"command":58},"pnpm","pnpm dlx skills add mambo-wang\u002FCodeWiki-Plus --skill write-doc-file-content-file-sidechannel","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Fwrite-doc-file-content-file-sidechannel\u002FSKILL.md",true,[],[63,70,77,84,91,98],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"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":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"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":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M75X9H4YYF5C29JR7AF44K84","repowiki-conclusion-update","已落库 repowiki 结论发生变化时，按「结论方向 vs 表述」分流：方向变则新写 decision 笔记+reject_note 旧+confirm 并回源 ADR，仅表述\u002F证据变则 edit_doc_file 原地改","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Frepowiki-conclusion-update\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"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":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"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":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"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",[],[]]