用途:检查 docs/ 下每个 Markdown 文件所述内容与源代码是否一致,发现文档说 X、代码实际为 Y 的漂移,并给出 file:line 证据。若 docs/ 不存在则干净退出。
主要能力:提取可验证声明(命令标志、状态名与转移顺序、配置键、文件路径、退出码、示例调用),再逐项对照源码核验。六项规范检查:标志一致性、状态一致性、配置键一致性、内部链接有效性、路径是否存在、退出码准确性。
使用方式:调用 /docs-review;支持 --since <date>(用 git log --since 缩小到该日期后修改的 docs/*.md)与 --output <path>(除 stdout 外写入报告文件)。典型命令:/docs-review、/docs-review --since 2026-04-01、/docs-review --output reports/docs-drift.md。发现条目格式含 OK、DRIFT、SKIP 与汇总。退出码:0 无漂移或无文档可查,1 存在漂移。可通过 crew.yml 的 cron 段配置定期执行。
适用场景:每周或每日定时巡检、发布前准确性核查、重构命令或配置架构后复查。
限制:不检查纯叙述性、无法验证的章节;不检查不属于自己的外部 API 文档;不报告格式或风格问题;不要伪造漂移,无法确认时标 SKIP;避免用子串误匹配标志名。资料未提供具体价格、平台或效果信息。