用途：定期检查仓库文档是否与实现脱节，并给出「更新 / 删除 / 迁移到 ADR」的处理结论。适用于规格书、计划文件、rules/CLAUDE.md 等长期维护文档的清理。
主要能力： Phase 1 机械扫描（每次可跑、成本低）：检测文档中失效的源码路径引用、失效的 markdown 相对链接、DEPRECATED / Superseded / TBD 等自述横幅、文档最后提交日与对应代码 churn 的鲜度差、git 不可见的 ignored/untracked 残留、计划文件中 Issue/PR 编号已全部 closed/merged 的残留计划，以及 rules/CLAUDE.md 中与 lint（Ruff/mypy）或模型默认行为重复的条目。 Phase 2 语义审计：仅对可疑文件并行派发只读 agent，逐条比对文档所述模块/类/函数与当前实现，列出「文档有实现无」「实现有文档无」「名称/签名/算法不一致」，并给出判定：大致准确 / 局部修正即可 / 需全面重写 / 可删除。 Phase 3 处置：按判定矩阵执行删除、更新、迁移 ADR、追加带日期的审计注记，或把需强制执行的规则转为 hook。
使用方式：技能本体只含步骤与提示词。开始前需从目标仓库的 CLAUDE.md / rules / 文档维护策略中取得：文档校验命令（如 make docs-okf、python scripts/validate_docs.py）、审计排除项、计划与设计输出目录、维护历史记录文件、删除的推送规则；缺失时向用户确认。执行后运行校验命令，并在维护历史中记录删改内容与原因。
运行模式：轻审计（约每月）只跑 Phase 1；深审计（约每季度或大规模重构/改名后）跑完整三阶段。周期由使用方自行决定。
限制：Phase 3 必须经用户批准后才执行，不得擅自删除；工具默认输出目录即使显得杂乱也不要删除，应由文档维护策略明确职责划分；agent 报告的「未被引用」需自行复核 tracked/ignored 状态。