用途:核对项目 README(或类似文档)中每一项功能声明是否在代码库中有真实实现,属于文档与代码一致性审计,不修改代码或文档。
主要能力:从文档中提取功能声明及子声明;按关键词在源码、测试、配置、样式、类型定义中搜索证据;将每项声明分类为已确认、部分实现、未找到、夸大;按文档章节输出功能、状态、证据表格;对存在问题的声明提出文档修改建议或标记实现缺口。
使用方式:默认读取项目根目录 README.md,也可指定其他文档文件。逐条提取功能点,用 grep/glob 搜索实现并阅读相关代码确认行为,记录文件路径与行号作为证据。可并行验证相互独立的声明,同一文件只读一次。
适用场景:更新功能列表后、发布前、接手新项目时、重构或移除功能后。
限制与注意:文档本身不算证据,只有源码等实现才算;不能仅凭文件名判断;需逐条验证子声明;第三方功能只验证依赖是否声明并使用;可配置功能需同时验证配置项与读取代码;UI 类声明需检查断点、ARIA 等具体实现。结果需引用具体文件与行号,发现缺口应如实报告,修改建议需用户确认后执行。