Documentation Consistency Reviewer
目标
系统性找出 README + docs/ 中所有「过时」或「与实现不一致」的描述,输出 ≥30 条问题项。
核心原则
- 以代码为真 - 文档与代码冲突时,以源码/配置/合同文件为准
- 有证据再下结论 - 每条问题必须引用代码/配置位置作为依据
- 合同优先 - OpenAPI/proto/schema/TS types 视为 SSOT
- 安全默认收紧 - 安全相关不一致优先标记为高严重级别
审核流程
1. 文档枚举
# 扫描范围
- README.md (根目录)
- docs/**/*.md (所有文档)
- 合同文件: OpenAPI/proto/GraphQL schema/TS types
2. 逐文档审阅
对每份文档:
- 列出关键声明/承诺/配置/接口条目
- 在代码中搜索对应实现
- 对比差异:缺失/重命名/行为不一致/默认值不一致
- 按模板记录问题项
[Description truncada. Veja o README completo no GitHub.]