用途
ln-610-docs-auditor 用于审计项目文档，覆盖文档结构、相关性、注释以及事实准确性。它作为 L2 协调器（Coordinator），负责统筹多个专项审计工作单元，并在最终评分前要求基于研究的标准支撑。
主要能力
- 审计文档结构、相关性、注释和事实准确性。
- 协调 ln-611、ln-612、ln-613、ln-614 四个工作单元。
- 在最终评分前要求有研究支撑的标准。
- 将各工作单元的发现聚合为统一的文档审计结果，规范化发现、去重重复问题，并依据研究来源顺序验证每个可操作问题。
- 生成最终审计报告与修复计划。
工作单元
- ln-611-docs-structure-auditor
- ln-612-semantic-content-auditor
- ln-613-code-comments-auditor
- ln-614-docs-fact-checker
使用方式
该技能采用 evaluation-runtime 运行时，标识为 docs-audit，阶段顺序为：
- PHASE_0_CONFIG
- PHASE_1_DISCOVERY
- PHASE_2_RESEARCH
- PHASE_3_DELEGATE
- PHASE_4_AGGREGATE
- PHASE_5_REPORT
- PHASE_6_SELF_CHECK
工作单元调用为强制委派，需使用 Skill 工具，例如：
Skill(skill: "ln-611-docs-structure-auditor", args: "{scope}") Skill(skill: "ln-612-semantic-content-auditor", args: "{scope}") Skill(skill: "ln-613-code-comments-auditor", args: "{scope}") Skill(skill: "ln-614-docs-fact-checker", args: "{scope}")
在 Claude 中按所示调用 Skill 工具；在 Codex 中若无 Skill 工具，则定位对应技能、读取其 SKILL.md，将 args 视为 $ARGUMENTS，执行该技能工作流后返回结果。不得内联工作单元逻辑，也不得在未执行目标技能的情况下标记工作单元完成。
强制阅读的参考文件包括：references/evaluation_coordinator_runtime_contract.md、references/evaluation_summary_contract.md、references/evaluation_research_contract.md、references/audit_final_report_contract.md、references/research_tool_fallback.md。仅当来源置信度或声明不确定性影响问题验证时，才条件性加载 references/epistemic_protocol.md。
工作流程
- Phase 0 配置：以 required_research=true 启动 evaluation-runtime。
- Phase 1 发现：发现文档表面与范围。
- Phase 2 研究：强制研究来源包括官方文档或标准、MCP Ref、框架文档相关时使用 Context7、当前网络最佳实践研究。
- Phase 3 委派：委派专项审计工作单元；子工作单元必须使用 evaluation-worker-runtime 并发出与 evaluation 兼容的摘要，通过 evaluation-runtime 记录。
- Phase 4 聚合：将工作单元摘要合并为一个文档审计结果，读取每个工作单元的 report_path，规范化发现、去重，并依据 references/evaluation_research_contract.md 中的研究来源顺序验证每个可操作问题。
- Phase 5 报告：按 references/audit_final_report_contract.md 写入 .hex-skills/runtime-artifacts/runs/{run_id}/audit-report/ln-610--final-report.md，包含修复计划、每个已确认问题的来源支撑验证和清理说明；整合后删除临时工作单元 markdown 报告；evaluation-coordinator 摘要的 report_path 必须仅指向最终报告。
- Phase 6 自检：必需检查包括强制研究已完成、所有工作单元摘要已记录、聚合摘要存在、最终修复报告已写入、临时工作单元 markdown 报告已删除、清理已验证、协调器摘要已记录。
适用场景
适用于需要对项目文档进行系统性审计的场景，尤其是需要结构、语义内容、代码注释和事实准确性多维度检查，并要求研究支撑和结构化摘要的情况。
限制
- 该技能为协调器，不内联工作单元逻辑，必须通过 Skill 工具委派。
- 最终评分前必须有研究支撑。
- 临时工作单元 markdown 报告在整合后必须删除。
- 元分析为可选，仅在用户要求运行后元分析或协议格式的运行反思时加载 references/meta_analysis_protocol.md。
参考
工作单元：../ln-611-docs-structure-auditor/SKILL.md、../ln-612-semantic-content-auditor/SKILL.md、../ln-613-code-comments-auditor/SKILL.md、../ln-614-docs-fact-checker/SKILL.md
版本：5.0.0 最后更新：2026-03-01