SuperAPI AI 工具集

ln-500-story-quality-gate

测试与质量

查看项目

更新于 10-15 16:23

技能介绍

用途:在 Story 进入质量评估就绪状态时执行故事级质量门禁,作为 L2 协调器(Category 5XX Quality),负责快速通道路由、质量与测试摘要、最终 Story 结论与分支收尾。输入 storyId 必需,来源可为参数、git 分支、看板或用户,状态过滤为 To Review。

主要能力:调用 ln-510-quality-coordinator 做代码质量、智能体评审、回归与日志分析;在需要时调用 ln-520-test-planner 做研究/手工/自动测试规划;确定性等待测试任务就绪;计算 PASS(全部通过,Story 置 Done)、CONCERNS(次要问题,置 Done 并加注释)、FAIL(阻塞问题,创建后续任务,不置 Done)、WAIVED(用户批准的例外,置 Done 并带豁免证据)四级结论;将可恢复的门禁运行时持久化到 .hex-skills/story-gate/runtime/。Phase 6 含端到端场景完整性走查,按 Actor 触发、入口点、发现、使用上下文、可观察结果五段追踪;任一段缺失即创建 AC- 前缀问题,结论必须为 FAIL。

使用方式:需加载多个 references 合同文件与 minimum_quality_checks.md、git_worktree_fallback.md 等;通过 node references/scripts/story-gate-runtime/cli.mjs 的 start/status/record-quality/record-test-status/record-stage-summary/checkpoint/advance 子命令驱动运行时;按 Phase 0 至 Phase 8 执行配置、发现、快速通道、质量检查、测试规划、测试验证、结论、收尾与自检。子协调器须以 Skill(skill: "ln-510-quality-coordinator", args: "{storyId} --run-id {childRunId} --summary-artifact-path {childSummaryArtifactPath}") 形式委派;仅通过摘要 JSON 工件消费子结果,不内联子逻辑。

限制:运行时状态是门禁编排的唯一事实来源;测试任务等待是确定性暂停而非隐式停止;FAIL 在正确记录后续动作时是合法的终止门禁结果;ln-1000 消费 Stage 3 协调器工件而非自由文本。资料未提供平台兼容性、收费与性能数据。