SuperAPI AI 工具集

ln-510-quality-coordinator

测试与质量

查看项目

更新于 10-15 15:05

技能介绍

用途

ln-510-quality-coordinator 是一个用于故事质量评审的评估平台协调器(Evaluation-platform coordinator)。其目标是在一次质量运行中协调多方证据收集、清理、代理审查与最终裁决,并返回规范化的质量结果。

主要能力

该技能负责:

  • 调用 ln-511-code-quality-checker(代码质量检查器)
  • 调用 ln-512-tech-debt-cleaner(技术债清理器)
  • 调用 ln-513-regression-checker(回归检查器)
  • 调用 ln-514-test-log-analyzer(测试日志分析器)
  • 在只读证据收集的同时并行运行内联代理审查
  • 保持合并、精炼与裁决的顺序执行
  • 返回规范化的质量结果

输入

主要输入:

  • storyId
  • --previous-cycle-focus(可选,来自 ln-500):上一轮 FAIL 周期中的阻塞类别,以逗号分隔

状态筛选:To Review。

关键规则

跳过研究的快速通道是不允许的。每次质量运行都必须包含:

  • 官方文档或标准
  • MCP Ref
  • 涉及框架或库时的 Context7
  • 当前网络最佳实践研究

运行时契约

运行时族:evaluation-runtime 标识符:quality-{storyId}

阶段顺序:

  • PHASE_0_CONFIG
  • PHASE_1_DISCOVERY
  • PHASE_2_READ_ONLY_EVIDENCE
  • PHASE_3_CLEANUP
  • PHASE_4_AGENT_BARRIER
  • PHASE_5_MERGE
  • PHASE_7_REFINEMENT
  • PHASE_8_VERDICT
  • PHASE_9_SELF_CHECK

工作者调用(强制)

宿主技能调用 Skill(skill: "...", args: "...") 属于强制委派。Claude 需按要求调用 Skill 工具。Codex 若无 Skill 工具,则需在可用技能中定位指定技能,读取其 SKILL.md,将 args 视为 $ARGUMENTS,执行该技能工作流,然后携带其结果或产物返回。不得内联工作者逻辑,也不得在未执行目标技能的情况下标记工作者完成。

代表性调用示例:

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}")

工作流程

Phase 0:配置 —— 解析 storyId;构建带有 required_research=true 的评估运行时清单;启动 evaluation-runtime。

Phase 1:发现 —— 加载故事元数据与已完成的实现任务范围;检测变更文件与项目技术栈;在可用时索引语义图。

Phase 2:只读证据 —— 允许并行:协调器内联研究、ln-511、ln-513、ln-514、外部代理启动。规则:研究为强制;工作者摘要为唯一完成信号;此阶段不进行合并或变更。当提供 previous_cycle_focus 时,优先为列出的阻塞类别收集证据,ln-511 应优先关注指定区域,但不排除其他证据,只是重排优先级。

Phase 3:清理 —— 仅在只读证据收集完成后运行 ln-512-tech-debt-cleaner;清理因会修改文件而保持顺序执行;记录工作者摘要与清理证据。

Phase 4:代理屏障 —— 通过 evaluation-runtime 同步代理;在所有必需代理解决或被明确跳过之前不得越过此屏障。将代理结果中的 failure_class 视为传输证据:rate_limited、tool_missing、auth_missing、permission_denial、asked_question 本身不算质量 FAIL 发现;timeout_productive 仅当存在输出/日志/会话证据时才能继续合并或评审;无新产物的重复相同工作者/代理失败会通过 loop health 暂停,等待下一周期。

Phase 5:合并 —— 合并输入:内联研究证据、ln-511 摘要、ln-512 摘要、ln-513 摘要、ln-514 摘要、代理发现。规则:评分前去重;拒绝无依据声明;安全与正确性问题保持高优先级。

Phase 6:精炼 —— 使用两阶段状态机:Stage 1(并行):dry_run_executor、new_dev_tester、adversarial_reviewer;Stage 2(合并后):final_sweep。规则:Stage 1 并行,Stage 2 在合并后;生成进程需清理证据;不得跳过研究。

Phase 7:裁决 —— 使用以下项计算规范化质量裁决:代码质量、清理结果、代理审查、标准验证、linter 结果、回归结果、日志分析结果。最终裁决值:PASS、CONCERNS、FAIL。

Phase 8:自检 —— 必需检查:运行时已启动、强制研究已完成、所有工作者摘要已记录、所有必需代理在合并前已解决、清理已验证、适用时已记录精炼轨迹、已编写协调器摘要。

摘要契约

写入 summary_kind=evaluation-coordinator。建议载荷:status、final_result、report_path、worker_count、agent_count、issues_total、severity_counts、warnings、cleanup_verified、research_completed。

完成定义

评估运行时已启动、强制研究已完成、只读证据工作者已完成、清理工作者已完成或有正当理由、代理屏障已解决、合并已完成、精炼已执行或有明确理由、最终裁决已计算、已写入 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。