docs-sync
基于可复现 Git 区间、用户确认范围和 workflow 规则,清洁工作区并全量审计同步项目文档与知识资产。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Menu
基于可复现 Git 区间、用户确认范围和 workflow 规则,清洁工作区并全量审计同步项目文档与知识资产。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle 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 已提交;没有未确认的越权写入或遗留工作区改动。