用途:作为 ln-600-docs-auditor 协调器调用的 L3 Worker,对单个项目文档做语义准确性审计,仅针对项目文档(如 CLAUDE.md、docs/README.md、documentation_standards.md、principles.md、requirements.md、architecture.md、tech_stack.md、api_spec.md、database_schema.md、design_guidelines.md、runbook.md),不处理 docs/tasks/、docs/reference/、docs/presentation/、tests/。
主要能力:分四阶段工作。一、SCOPE 提取:读取文档前 20 行,解析 <!-- SCOPE: ... --> 注释,无标签则按文档类型推断。二、内容与范围对齐:识别 OFF_TOPIC、MISSING_COVERAGE、SCOPE_CREEP、SSOT_VIOLATION,并按 1-10 打分。三、事实核验:按文档类型对照代码库,如 architecture.md 检查目录与导入模式、tech_stack.md 对比 package.json/go.mod/requirements.txt 版本、api_spec.md 匹配路由、database_schema.md 对比迁移或 ORM schema、runbook.md 验证路径与命令;发现类型包括 OUTDATED_PATH、WRONG_VERSION、MISSING_ENDPOINT、BEHAVIOR_MISMATCH、STALE_REFERENCE。四、评分与报告:scope_alignment_score 为 coverage/relevance/focus 加权平均,fact_accuracy_score=(verified_facts/total_facts)10,overall_score=scope_alignment0.4+fact_accuracy*0.6,事实准确性权重更高。
使用方式:由协调器传入 doc_path、project_root、tech_stack 等输入;输出 JSON,含 doc_path、scope、scores、summary、findings(severity、type、location、issue、evidence、fix)。规则要求先读后判、每条发现附证据、代码为准、无 SCOPE 时按文件名推断、避免误报、定位到行号、给出可执行修复建议。需加载 references/verification_rules.md 获取各文档类型的核验模式。
限制:仅作为流水线 Worker 被调用,不独立运行;不审计参考文档、任务文档与测试;具体安装与调用命令资料未提供。