ln-510-quality-coordinator

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

**类型：**L2 协调器
**类别：**5XX 质量

质量协调器

用于故事质量审查的评估平台协调器。

必读

**必读：**加载 references/evaluation_coordinator_runtime_contract.md、references/evaluation_summary_contract.md、references/evaluation_research_contract.md、references/loop_health_contract.md
**必读：**加载 references/agent_delegation_pattern.md
**必读：**加载 references/criteria_validation.md、references/gate_levels.md

Agent 审查政策：运行健康检查；没有可用顾问时，记录跳过原因；在作出判定前核实每项顾问声明；将传输、身份验证或工具故障视为操作证据，而非质量问题。仅当需要在评估运行时之外调试生命周期或存活状态细节时，才加载 references/agent_review_workflow.md。

目的

• 调用 ln-511-code-quality-checker
• 调用 ln-512-tech-debt-cleaner
• 调用 ln-513-regression-checker
• 调用 ln-514-test-log-analyzer
• 与只读证据收集并行运行内联 Agent 审查
• 按顺序进行合并、优化和判定
• 返回标准化质量结果

输入

主要输入：

• storyId
• --previous-cycle-focus（可选，来自 ln-500）：以逗号分隔的上一轮 FAIL 周期中的阻塞类别

状态筛选条件：

• To Review

关键规则

不允许跳过研究的快速通道。

每次质量运行都必须包含：

1. 官方文档或标准
2. MCP Ref
3. 涉及框架或库时使用 Context7
4. 当前的 Web 最佳实践研究

运行时契约

运行时系列：

• evaluation-runtime

标识符：

• quality-{storyId}

阶段顺序：

1. PHASE_0_CONFIG
2. PHASE_1_DISCOVERY
3. PHASE_2_READ_ONLY_EVIDENCE
4. PHASE_3_CLEANUP
5. PHASE_4_AGENT_BARRIER
6. PHASE_5_MERGE
7. PHASE_7_REFINEMENT
8. PHASE_8_VERDICT
9. PHASE_9_SELF_CHECK

工作器调用（强制）

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

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

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

TodoWrite 格式（强制）：

• Resolve Story and build runtime manifest
• Load Story metadata and detect changed files
• Run quality checkers and research in parallel
• Apply safe tech-debt cleanup
• Sync agents and wait for all evidence
• Merge and deduplicate all findings
• Run bounded refinement loop
• Compute quality verdict and score
• Verify runtime cleanup and self-check

调用示例：

Skill(skill: "ln-511-code-quality-checker", args: "{storyId}")
Skill(skill: "ln-512-tech-debt-cleaner", args: "{storyId}")
Skill(skill: "ln-513-regression-checker", args: "{storyId}")
Skill(skill: "ln-514-test-log-analyzer", args: "{storyId}")

工作流

阶段 0：配置

1. 解析 storyId。
2. 构建 required_research=true 的评估运行时清单。
3. 启动 evaluation-runtime。

阶段 1：发现

1. 加载故事元数据和已完成的实现任务范围。
2. 检测变更文件和项目技术栈。
3. 如有可用的语义图，则为其建立索引。

阶段 2：只读证据

此阶段允许并行工作：

• 协调器进行内联研究（遵循 references/evaluation_research_contract.md）
• ln-511-code-quality-checker
• ln-513-regression-checker
• ln-514-test-log-analyzer
• 启动外部 Agent

规则：

• 研究为强制要求
• 工作器摘要是唯一的完成信号
• 此阶段不进行合并或修改

提供 previous_cycle_focus 时：

• 优先为所列阻塞类别收集证据。
• ln-511 代码质量检查器应首先关注指定领域。
• 这不会排除其他证据，只会调整优先级。

阶段 3：清理

1. 仅在收集完只读证据后运行 ln-512-tech-debt-cleaner。
2. 清理操作会修改文件，因此仍须按顺序执行。
3. 记录工作者摘要和任何清理证据。

阶段 4：Agent 屏障

1. 通过 evaluation-runtime 同步各 Agent。
2. 在所有必需的 Agent 均已处理或被明确跳过之前，不得越过此屏障。
3. 将 Agent 结果中的 failure_class 视为传输证据：
   • rate_limited、tool_missing、auth_missing、permission_denial 和 asked_question 本身不属于质量 FAIL 结果。
   • 只有在存在输出、日志或会话证据时，timeout_productive 才可继续进入合并／审查阶段。
   • 如果工作者／Agent 连续出现相同故障，且没有新产物，则应通过循环健康检查暂停，然后再进入下一轮。

阶段 5：合并

合并输入：

• 行内研究证据
• ln-511 摘要
• ln-512 摘要
• ln-513 摘要
• ln-514 摘要
• Agent 发现

规则：

• 评分前先去重
• 拒绝缺乏依据的主张
• 安全和正确性问题仍须优先处理

阶段 6：优化

根据 references/agents/prompt_templates/iterative_refinement.md 和 references/agents/prompt_templates/refinement_perspectives.md，优化采用每项两阶段状态机：

• 阶段 1（并行）：dry_run_executor、new_dev_tester、adversarial_reviewer
• 阶段 2（合并后）：final_sweep

规则：

• 阶段 1 并行运行，阶段 2 在合并后运行
• 对已启动的进程，必须提供清理证据
• 不得跳过研究

阶段 7：判定

使用以下指标计算标准化质量判定：

• 代码质量
• 清理结果
• Agent 审查
• 标准验证
• Linter 结果
• 回归结果
• 日志分析结果

最终判定值：

• PASS
• CONCERNS
• FAIL

阶段 8：自检

必需检查：

• 运行时已启动
• 已完成强制研究
• 已记录所有工作者摘要
• 合并前已处理所有必需的 Agent
• 已验证清理结果
• 适用时已记录优化轨迹
• 已撰写协调器摘要

摘要约定

写入 summary_kind=evaluation-coordinator。

建议的载荷：

• status
• final_result
• report_path
• worker_count
• agent_count
• issues_total
• severity_counts
• warnings
• cleanup_verified
• research_completed

完成定义

• 已启动评估运行时
• 已完成强制研究
• 已完成只读证据工作者任务
• 已完成清理工作者任务，或已说明其合理性
• 已解决 Agent 屏障
• 已完成合并
• 已执行优化，或已明确说明其合理性
• 已计算最终判定
• 已写入 evaluation-coordinator 摘要
• 运行时已完成

元分析

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

如果在协调器运行后收到此请求，请按照协议第 7 节分析会话，并在最终质量判定中附上按协议格式编写的输出。

参考资料

• 运行时：references/evaluation_coordinator_runtime_contract.md、references/evaluation_summary_contract.md
• 研究：references/evaluation_research_contract.md
• 工作者：../ln-511-code-quality-checker/SKILL.md、../ln-512-tech-debt-cleaner/SKILL.md、../ln-513-regression-checker/SKILL.md、../ln-514-test-log-analyzer/SKILL.md
• 质量标准：references/criteria_validation.md、references/gate_levels.md

---

版本： 7.0.0 最后更新： 2026-02-09