菜单
文档写入协议（去躁点版）。控制 AI 何时写入文档、写入什么内容。当用户说"沉淀到文件"、"记录下来"、"update: xxx.md" 时使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | docs-writing-protocol |
| description | 文档写入协议（去躁点版）。控制 AI 何时写入文档、写入什么内容。当用户说"沉淀到文件"、"记录下来"、"update: xxx.md" 时使用。 |
目标：只有明确指定目标文件时才写入；写入时只记录设计/契约/语义的变化，不把修 bug、重试、风格调整等噪声落进文档。
只有满足任一条件，才允许对 md 文件做持久化更新：
明确指定目标文件路径，例：update: docs/xxx.md
明确要求"生成/落地到某个文件路径"的文档产物
语义上表达"需要沉淀/记录/落地到文件"，例：
→ 若未指定文件名，先询问目标文件路径，确认后再写入。
否则：只在对话中输出，不创建、不修改任何文件。
当用户第一次点名 X.md，设置 DocTarget = X.md，后续交互默认继续更新 DocTarget（仍遵守去躁点规则）。
switch: Y.mdstop writing满足任一条：不写入 DocTarget
口诀：纠错不记账
满足任一条：写入 DocTarget
口诀：改契约/改流程/改规则/改语义，就记账
每次写入只允许：
实现过程、排障、试错、重构细节一律不写入。
update: path/to/doc.md — 指定写入目标switch: path/to/another.md — 切换目标stop writing — 停止写入no-record — 本轮强制不写入（即便命中必须更新，也只在对话说明）对 Markdown 学习笔记做结构重构与精修：两阶段 Plan-and-Execute 工作流——先诊断归类（出清单/大纲/映射/scaffold），再精修交付（重写正文、越界路由、资源追踪）。支持全文或指定章节两种 scope；支持只出清单或直接输出整理后正文。
PRD 渐进式维护协议。多供应商并行开发 + 敏捷迭代场景下维护 PRD 文档。当用户说"prd: path"、"维护 PRD"、"更新需求文档"时使用。依赖 docs-writing-protocol 的去躁点判定。
将 Markdown 文档转换为专业的 PDF 白皮书，采用苹果设计风格 (v2.0)。 v2.0 改进: - 使用 pdfkit + wkhtmltopdf 替代 WeasyPrint (避免 pango 依赖问题) - 支持 WebP 等特殊格式图片处理 - 自动处理无扩展名图片 - 提供完整的图片处理工具链 - 一键式工作流 支持完整的 Markdown 语法 (代码块、表格、引用、列表等)。 自动生成封面、目录、页眉页脚。 使用场景: 技术文档、白皮书、教程、报告等需要专业排版的 Markdown 文档。
脚本化图片 alt/title 补全工具。脚本负责提取和替换，模型只负责看图生成描述。支持 Markdown 和 HTML 图片，严格不改路径、不丢图。