write-doc-file-content-file-sidechannel SKILL.md skillA
write-doc-file-content-file-sidechannel from mambo-wang/codewiki-plus is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add mambo-wang/codewiki-plus/write-doc-file-content-file-sidechannel@git:20260927.ee889f8Pins git:20260927.ee889f8 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- mambo-wang/codewiki-plus
- Path
repowiki/skills/write-doc-file-content-file-sidechannel/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260927.ee889f8, committed Sep 27, 2026
- Size
- 3,201 bytes
- Repository stars
- 21
- License
- MIT
write_doc_file 建档报目标路径已被手写文件占用/路由冲突时——走 content_file 临时文件侧通道：正文写临时文件→删占位文件→write_doc_file(content_file=...) 正式建档→删临时文件.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
## 工作场景 需要用 CodeWiki 的 write_doc_file 正式建档 wiki 页面（注入 frontmatter、注册交叉链接与索引），但目标路径上已存在手写文件（如先前用 write_to_file 起草的占位稿），直接调用会触发文件路由冲突被拒绝写入。 ## 适用条件 - 使用 write_doc_file 建档（page_type=module/entity/concept/query/comparison/source 等），且需要工具负责的元数据注入（frontmatter、交叉链接、索引注册）。 - 目标路径已被手写文件占用，工具报「目标路径已存在 / 路由冲突」类错误。 - 不适用于普通笔记归档（走 ingest_note，无路径冲突问题）；也不适用于编辑已有正式页面（直接 edit_doc_file）。 ## 核心 SOP 依据: notes/2026-09-27-write-doc-file-建档遇目标路径已被手写文件占用时走-content-file-临时文件侧通道.md 的「content_file 侧通道建档流程」（2026-09-25 agentmemory 调研建档实际跑通）。 1. 把页面正文写入一个临时文件（如 `.codebuddy/tmp-<页面名>.md`），只写正文、不写 frontmatter——元数据由工具注入； 2. 删除目标路径上已手写的占位文件（内容已在第 1 步保全，删除无损失）； 3. 调用 `write_doc_file(content_file=<临时文件路径>, ...)` 让工具从临时文件读正文并正式建档； 4. 建档成功后删除临时文件，收尾复核新页面 frontmatter 齐全。 ## 判断逻辑 - write_doc_file 报目标路径冲突 → 先确认冲突文件是手写占位（无工具注入的 frontmatter），是则走侧通道；若已是工具建的正式页面，改用 edit_doc_file 编辑，不要删了重建（会丢 revisions/edit 历史）。 - 正文很大（接近 MCP 参数限制）→ 更应走 content_file 文件侧通道，顺带规避大载荷内联传输问题。 - 手写文件内容与拟建页面无关（纯误占位）→ 可直接删，无需第 1 步保全。 ## 禁忌与反模式 - 勿因冲突就放弃 write_doc_file、让手写文件充当正式页面：缺 frontmatter/索引注册，页面不进检索与 wikilink 图。 - 勿绕过 dispatch 直连 handler 写文件——路由冲突是确定性簿记在保护建档一致性。 - 勿把临时文件留在仓库工作树里忘记清理（第 4 步必做）。 - 勿在临时文件里手写 frontmatter：与工具注入的元数据冲突或产生重复段。
Read the whole file at its exact version.
How to install
mdr add mambo-wang/codewiki-plus/write-doc-file-content-file-sidechannel@sha256:bb6286aa6f1ff850The line at the top of this page pins the label git:20260927.ee889f8, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_gq2z2kfemjmyyh7r)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Sep 27, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3201 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
mambo-wang/codewiki-plus · 21 stars · license MIT · pushed 2026-11-02 · branch develop
API
GET https://markdownregistry.com/api/v1/artifacts/art_gq2z2kfemjmyyh7r GET https://markdownregistry.com/api/v1/resolve?ref=mambo-wang/codewiki-plus/write-doc-file-content-file-sidechannel GET https://markdownregistry.com/api/v1/blob/bb6286aa6f1ff8508580222a532a6f802c7235d8e037368e66c1391127e0e244
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.