用途:扫描现有业务功能文档,并将结果写入 docs/project-reference/feature-docs-reference.md,内容包含应用与服务映射、文档结构约定、模板使用情况和章节标准。
主要能力:Phase 0 判定文档模式(INIT/SYNC/FORCE)并识别文档结构类型;Phase 1 规划扫描策略;Phase 2 并行子代理执行扫描,分别负责文档结构与应用到服务的映射;Phase 3 分析并生成目标章节(应用-服务映射、目录结构、模板路径、章节结构、文档约定、覆盖率缺口、M1/M2 合规泄漏);Phase 4 写入并验证模板路径与映射。
使用方式:在 Codex 中用 $skill-name 调用;执行前按任务追踪要求创建/更新任务。判定命令:test -f docs/project-reference/feature-docs-reference.md && echo "SYNC mode" || echo "INIT mode"。SYNC 模式先读现有文档,仅做手术式更新,不整体重写。
适用场景:需要梳理功能文档结构、应用与服务对应关系、模板与章节规范、覆盖率缺口及 M1/M2 合规问题。
限制:子代理写入需逐节增量进行;每项发现需 file:line 引用,置信度需大于 80%;Coverage Gaps 为必填章节;Round 2 全新视角校验必做;M1/M2 合规扫描排除证据载体、frontmatter 与 Mermaid 块;模板路径与映射需实际校验存在性。未提供收费标准等信息。