ln-620-codebase-auditor

路径： 文件路径（references/、../ln-*）均相对于此技能目录。

类型： L2 协调器 类别： 6XX 审计

代码库审计员

必读

必读： 加载 references/evaluation_coordinator_runtime_contract.md、references/evaluation_summary_contract.md、references/evaluation_research_contract.md 必读： 加载 references/audit_final_report_contract.md 必读： 加载 references/codebase_audit_worker_boundaries.md 必读： 加载 references/research_tool_fallback.md 条件阅读：仅当来源可信度或声明不确定性会影响问题验证时，才加载 references/epistemic_protocol.md。

目的

• 审计运行时／代码库风险：安全性、交付门禁、依赖／复用健康度、可维护性、死代码、可诊断性、并发、生命周期和配置验证
• 协调 ln-621 至 ln-629，且必须包含全部项
• 评分前必须进行符合技术栈特征的研究

运行时契约

运行时系列：

• evaluation-runtime

标识符：

• codebase-audit

阶段顺序：

1. PHASE_0_CONFIG
2. PHASE_1_DISCOVERY
3. PHASE_2_RESEARCH
4. PHASE_3_DELEGATE
5. PHASE_4_AGGREGATE
6. PHASE_5_REPORT
7. PHASE_6_SELF_CHECK

工作器集合

• ln-621-security-boundary-auditor
• ln-622-build-delivery-gate-auditor
• ln-623-duplication-overabstraction-auditor
• ln-624-code-maintainability-hotspot-auditor
• ln-625-dependency-reuse-auditor
• ln-626-dead-code-pruning-auditor
• ln-627-diagnosability-auditor
• ln-628-concurrency-correctness-auditor
• ln-629-runtime-lifecycle-config-auditor

工作器调用（必需）

宿主技能调用： 必须通过 Skill(skill: "...", args: "...") 委派。

• Claude：严格按所示方式调用 Skill 工具。
• Codex：如果没有 Skill 工具，则在可用技能中找到指定技能，读取其 SKILL.md，将 args 视为 $ARGUMENTS，执行该技能工作流，然后携带其结果／产物返回此处。
• 不要内联工作器逻辑，也不要在未执行目标技能的情况下将工作器标记为已完成。

使用 Skill 工具委派工作器。不要在协调器中内联工作器逻辑。

TodoWrite 格式（必需）：

• Resolve audit scope and build manifest
• Load codebase structure and stack
• Run best-practice research
• Delegate to domain audit workers
• Aggregate worker findings
• Generate final audit report and remediation plan
• Verify cleanup and self-check

代表性调用：

Skill(skill: "ln-621-security-boundary-auditor", args: "{scope}")
Skill(skill: "ln-622-build-delivery-gate-auditor", args: "{scope}")
Skill(skill: "ln-623-duplication-overabstraction-auditor", args: "{scope}")
Skill(skill: "ln-624-code-maintainability-hotspot-auditor", args: "{scope}")
Skill(skill: "ln-625-dependency-reuse-auditor", args: "{scope}")
Skill(skill: "ln-626-dead-code-pruning-auditor", args: "{scope}")
Skill(skill: "ln-627-diagnosability-auditor", args: "{scope}")
Skill(skill: "ln-628-concurrency-correctness-auditor", args: "{scope}")
Skill(skill: "ln-629-runtime-lifecycle-config-auditor", args: "{scope}")

工作流

阶段 0：配置

以 required_research=true 启动 evaluation-runtime。

阶段 1：发现

检测项目类型、技术栈以及审计工作器的适用性。

阶段 2：研究

必需的研究来源：

1. 官方文档或标准
2. MCP Ref
3. 相关框架文档适用时使用 Context7
4. 当前网络最佳实践研究

阶段 3：委派

委派适用的审计工作器。子工作器必须使用 evaluation-worker-runtime，并输出兼容评估的摘要。

阶段 4：汇总

使用 references/codebase_audit_worker_boundaries.md 合并运行时／代码库风险发现。读取每个工作器的 report_path，规范化操作、去重重复问题、解决工作器间的冲突，并按照 references/evaluation_research_contract.md 中的来源顺序，使用研究来源验证每个可执行问题。

阶段 5：报告

按照 references/audit_final_report_contract.md，写入 .hex-skills/runtime-artifacts/runs/{run_id}/audit-report/ln-620--final-report.md。报告应包含修复计划、针对每个已确认问题的来源支持验证，以及清理说明。汇总后删除临时工作器 Markdown 报告。evaluation-coordinator 摘要中的 report_path 必须仅指向最终报告。

阶段 6：自检

必需检查：

• 研究已完成
• 已记录所有适用工作者的摘要
• 已使用 codebase_audit_worker_boundaries.md 解决工作者之间的冲突
• 汇总已完成
• 最终修复报告已编写
• 清理已验证
• 临时工作者 Markdown 报告已删除
• 协调者摘要已记录

摘要约定

写入 summary_kind=evaluation-coordinator。

完成标准

• 已启动评估运行时
• 已选择适用的工作者
• 研究已完成
• 已记录所有适用工作者的摘要
• 工作者集合始终恰好为 ln-621 至 ln-629
• 已使用 codebase_audit_worker_boundaries.md 解决工作者之间的冲突
• 最终报告和修复计划已编写
• 临时工作者 Markdown 报告已删除
• 已编写 evaluation-coordinator 摘要
• 运行时已完成

元分析

可选参考：仅当用户要求进行运行后元分析或按协议格式进行运行复盘时，才加载 references/meta_analysis_protocol.md。

在协调者运行完成后收到请求时，请按照协议第 7 节分析会话，并在最终代码库审计结果中附上按协议格式编写的输出。

参考资料

• 工作者：../ln-621-security-boundary-auditor/SKILL.md、../ln-622-build-delivery-gate-auditor/SKILL.md、../ln-623-duplication-overabstraction-auditor/SKILL.md、../ln-624-code-maintainability-hotspot-auditor/SKILL.md、../ln-625-dependency-reuse-auditor/SKILL.md、../ln-626-dead-code-pruning-auditor/SKILL.md、../ln-627-diagnosability-auditor/SKILL.md、../ln-628-concurrency-correctness-auditor/SKILL.md、../ln-629-runtime-lifecycle-config-auditor/SKILL.md

---

版本： 5.0.0 最后更新： 2025-12-23