菜单
项目 docs 维护编排器。用于非 trivial 的开发任务、功能开发、bug 修复、重构、API 变更、跨模块修改前后：先扫描 docs/OVERVIEW.md、feature-*、reference-*，把相关文档作为半可信上下文；判断是否需要升级使用 project-analysis 做深度分析；实现完成后判断哪些文档受影响，并先询问用户确认后再更新。看到用户要“实现/修改/开发/修复”项目代码时，应优先触发此技能，而不是等用户主动提及 docs。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | project-docs-workflow |
| description | 项目 docs 维护编排器。用于非 trivial 的开发任务、功能开发、bug 修复、重构、API 变更、跨模块修改前后：先扫描 docs/OVERVIEW.md、feature-*、reference-*，把相关文档作为半可信上下文；判断是否需要升级使用 project-analysis 做深度分析；实现完成后判断哪些文档受影响，并先询问用户确认后再更新。看到用户要“实现/修改/开发/修复”项目代码时，应优先触发此技能，而不是等用户主动提及 docs。 |
这是一个薄编排层。
它不替代 CLAUDE.md 的规则，也不替代 project-analysis 的深度分析。它负责把两者接起来。
在代码实施前后，把项目文档工作流跑完整：
docs/ 里的相关文档project-analysis遇到下面这些场景，应主动使用本技能：
下面这些场景通常不要触发：
先检查：
docs/OVERVIEW.mddocs/feature-*.mddocs/reference-*.md优先用 Glob 找文件，再用 Read 读取候选文档。
匹配时重点看：
如果找到相关文档：
如果没找到相关文档：
project-analysis只在下面情况升级：
如果只是普通功能开发或局部 bug 修复：
project-analysis如果升级到 project-analysis：
update-doc 还是 new-docupdate-docnew-docfeature-* / reference-* / OVERVIEW.md代码实施阶段：
代码完成后，主动判断是否有 docs 影响。
重点判断这四类：
feature-xxx.md
reference-xxx.md
docs/OVERVIEW.md
CLAUDE.md 的“历史教训”
如果没有实质变化：
如果确认文档已过时、缺失或与实现不一致：
如果用户确认 patch：
feature-xxx.mdreference-xxx.mddocs/OVERVIEW.md默认只维护这一套长期文档：
docs/feature-*.mddocs/reference-*.mddocs/OVERVIEW.md不要默认再造长期并行文档体系。
如果 project-analysis 产出了时序图、数据流图、性能观察：
feature-* / reference-* / OVERVIEW.mdupdate-docnew-docanalysis-only 作为默认返回形态在实施前，如果找到了相关 docs，可以简短说明：
在实施后，如果发现 docs 可能过时，要明确指出：
project-analysis。