القائمة
基于可复现 Git 区间、用户确认范围和 workflow 规则，清洁工作区并全量审计同步项目文档与知识资产。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
对 workflow 下已完成 change 执行归档移动，从归档 change 中提取知识并合并到 workflow INDEX.md 声明的 _state/ 知识 store（adr/、context/ 等）， 然后审计并清理过时/重复知识。默认 dry-run 返回可确认计划，所有破坏性动作需用户显式确认后执行。 触发场景：workflow 中存在 change_status: completed 的 change 需要归档收尾、知识沉淀、清理过时内容时。
构建一个一次性原型来回答设计问题。当用户想要快速验证某个状态模型或逻辑是否正确，或探索 UI 应该长什么样时使用。
将 Speculo 多文件能力（skill/command/workflow）合并为自包含单 MD 文档，上传到网页 AI 平台（ChatGPT Projects、Claude Projects、NotebookLM）使用。触发：用户要求生成 canonical 文档、要求将能力打包为单文件、或要求上传能力到 AI 平台时。
创建、审计、合并或迁移 Speculo 的可复用 skill。用户要求新增 template/skills 能力、清理 SKILL.md、整合相似 skills、迁移外部 skill 或修复渐进披露时使用。
在指定 workflow 中撰写单个 work 入口文件（X-name/X-name.md）及其渐进披露子文件。用户指定 workflow 和 work 名称，要求新增 work、为已有 work 补充子文件、重构 work 步骤结构、优化完成标准、对齐主导词或修复 <Path> 指针时使用。
在指定 workflow 包中新增、审计或合并 work 入口。用户指定 workflow 名称（如 template/workflows/person）并要求新增具体 work、审计现有 work 的渐进披露结构、合并相似 work、基于参考材料生成 work 或对齐 <Path> 路径引用格式时使用。
| id | docs-sync |
| type | skill |
| name | Docs Sync |
| description | 基于可复现 Git 区间、用户确认范围和 workflow 规则，清洁工作区并全量审计同步项目文档与知识资产。 |
调用方提供 runtime context、command 报告路径、全局 state 路径和 Git 副作用责任；本 skill 只使用这些已校验路径。
全局语言规则：所有项目文档默认使用简体中文书写，除非特定文档类型另有规定（如 README.md 固定为英文、CHANGELOG.md 跟随项目既有语言）。代码实体、命令、URL 和版本号不翻译。
references/git-state-contract.md，清理并提交可验证的既有工作区改动，解析上次基线与本次输入节点。完成标准：输入工作区干净，或已无损阻塞。references/workflow-scope-contract.md，发现全部已安装 workflow，并解析全局范围与每个 workflow 的确认清单。完成标准：首次运行已统一确认范围，每个 workflow 状态根都有合法 sidecar。references/document-lifecycle-contract.md，把输入区间和 workflow 证据映射为 add | update | delete | merge | keep | propose-only。完成标准：每个受影响资产已整份审计，而非只追加新段落。references/readme-contract.md（同步规则）与 references/readme-writing-guide.md（内容写作规范）；更新 CHANGELOG 时读取 references/changelog-contract.md；更新代理手册时读取 references/agents-contract.md。需要创建或重建多层代理手册树时改用 ../agents-md-builder/SKILL.md。assets/report-template.md、assets/state-template.json 与 assets/workflow-scope-template.json 返回原子写入内容。调用方提交显式文件列表并再次确认工作区干净。完成标准：项目文档与当前事实一致，过期和重复内容已删除或合并；报告可复现输入区间；state 与 sidecar 已提交；没有未确认的越权写入或遗留工作区改动。