smoke-check

!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys automation,workflow,qa.level,testing.strict

冒烟检查

此技能是“实现完成”与“准备好移交 QA”之间的关卡。它会运行自动化测试套件，检查测试覆盖缺口，与开发者批量验证关键路径，并生成 PASS/FAIL 报告。

规则很简单：冒烟检查未通过的构建不得移交 QA。 把有问题的构建交给 QA 会浪费他们的时间，也会打击团队士气。

输出： production/qa/smoke-[date].md

---

每次 AskUserQuestion 调用都遵循 .claude/docs/automation-modes.md （协作模式始终提问 · 引导模式仅针对重大事项提问 · 自主模式记录并继续； automation_always_ask 类别始终提问）。

qa.level：设为 minimal 时，冒烟检查可选——如果运行，FAIL 仅作提示，绝不会阻止移交；如果项目没有游戏测试，则仅检查构建、启动和关键路径（第 1 阶段步骤 1）；设为 standard 时，阶段转换前必须进行检查；设为 full 时，每次提交前都必须进行检查。此项优先于第 6 阶段的 testing.strict.config 解析（该解析仅在冒烟检查作为关卡时才有意义）。这是与 workflow 不同的维度。

解析参数

参数可以组合使用：/smoke-check sprint --platform console

基础模式（第一个参数，默认值：sprint）：

• sprint — 针对当前冲刺的用户故事执行完整冒烟检查
• quick — 跳过覆盖率扫描（第 3 阶段）和批次 3；用于快速重新检查

平台标志（--platform，默认值：无）：

• --platform pc — 添加 PC 专属检查（键盘、鼠标、窗口模式）
• --platform console — 添加主机专属检查（游戏手柄、电视安全区域、 平台认证要求）
• --platform mobile — 添加移动设备专属检查（触控、纵向／横向模式、 电池／热行为）
• --platform all — 添加所有平台变体；按平台输出判定结果表

如果提供了 --platform，第 4 阶段会添加平台专属批次，第 5 阶段除整体判定结果外，还会输出按平台划分的判定结果表。

---

第 1 阶段：检测测试配置

现在读取 references/1-detect-setup.md 并按其说明操作——此阶段的步骤位于该文件中，而不在这里。如果在此阶段对话被压缩或恢复，请重新读取该文件。

第 2 阶段：运行自动化测试

现在读取 references/2-run-tests.md 并按其说明操作——此阶段的步骤位于该文件中，而不在这里。如果在此阶段对话被压缩或恢复，请重新读取该文件。

第 3 阶段：检查测试覆盖率

现在读取 references/3-coverage.md 并按其说明操作——此阶段的步骤位于该文件中，而不在这里。如果在此阶段对话被压缩或恢复，请重新读取该文件。

第 4 阶段：运行手动冒烟检查

现在读取 references/4-manual-checks.md 并按其说明操作——此阶段的步骤位于该文件中，而不在这里。如果在此阶段对话被压缩或恢复，请重新读取该文件。

第 5 阶段：生成报告

现在读取 references/5-report.md 并按其说明操作——此阶段的步骤位于该文件中，而不在这里。如果在此阶段对话被压缩或恢复，请重新读取该文件。

第 6 阶段：写入报告并执行关卡检查

现在读取 references/6-write-gate.md 并按其说明操作——此阶段的步骤位于该文件中，而不在这里。如果在此阶段对话被压缩或恢复，请重新读取该文件。

协作协议

适用于 collaborative 模式（默认模式）。 关于 guided 和 autonomous 模式，请参阅 .claude/docs/automation-modes.md——以下规则 说明的是协作模式的要求，并非通用行为。

• 绝不要将 NOT RUN 自动视为 FAIL——应将其记录为 NOT RUN，并让 开发者手动确认状态。未经确认的 NOT RUN 会导致 NOT ASSESSED，而不是 FAIL——也不代表通过。
• 绝不要自动修复失败——应报告失败，并说明需要解决什么问题。 不要尝试编辑源代码或测试文件。
• PASS WITH WARNINGS 不会阻止 QA 交接——应记录建议改进的 缺口，供 /story-done 后续跟进。
• quick 参数会跳过 Phase 3（覆盖率扫描）和 Phase 4 Batch 3。 修复特定失败后，可用它快速重新检查。
• 所有手动冒烟测试验证均使用 AskUserQuestion。
• 未经询问，绝不要撰写报告——Phase 6 要求在创建任何文件前获得明确批准。