메뉴
基于可复现 Git 区间、用户确认范围和 workflow 规则，清洁工作区并全量审计同步项目文档与知识资产。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| 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 已提交；没有未确认的越权写入或遗留工作区改动。
对 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> 路径引用格式时使用。