smoke-check

Prompt file imported from zls3434/Software-Engineering-Studios (.windsurf/workflows/smoke-check.md). Copyright stays with the author.

/smoke-check — 运行关键路径冒烟测试，快速验证系统核心功能可用性并生成通过/失败报告。

触发方式

在 Cascade 对话框中输入 /smoke-check 触发此工作流。

工作流内容

smoke-check — 关键路径冒烟测试

技能目的

识别系统关键路径并运行冒烟测试套件，在最短时间内验证核心功能可用性，生成通过/失败报告，作为发布前与回归后的快速健康检查。

参数说明

本技能无参数。自动识别关键路径并执行冒烟测试。

分阶段工作流

阶段 1：识别关键路径

• 输入：项目目录
• 处理：
  1. 使用 Glob 查找 docs/srs/ 中的核心用例与主流程描述
  2. 使用 Read 读取 docs/epics/index.md 获取核心 Epic
  3. 使用 Grep 搜索标记为 @critical、@smoke、@p0 的测试用例
  4. 使用 Glob 查找 tests/smoke/ 或 e2e/smoke/ 目录
  5. 若无现成冒烟套件，根据 SRS 关键路径推导必要用例清单
• 输出：关键路径与冒烟用例清单

阶段 2：运行冒烟测试套件

• 输入：冒烟用例清单
• 处理：
  1. 使用 Read 读取测试运行配置（jest.config、playwright.config 等）
  2. 使用 Bash 执行冒烟测试命令（带 --grep smoke 或指定目录）
  3. 设置合理超时（单套件不超过 5 分钟）
  4. 捕获 stdout 与 stderr，记录失败用例堆栈
  5. 若环境未就绪，使用 Bash 检查服务依赖（数据库、缓存）是否可达
• 输出：原始测试结果

阶段 3：收集结果

• 输入：原始测试结果
• 处理：
  1. 解析测试报告（JUnit XML、JSON、终端输出）
  2. 统计通过数、失败数、跳过数、耗时
  3. 对失败用例归类：断言失败、超时、环境错误、未实现
  4. 关联失败用例与对应的 SRS 关键路径
• 输出：结构化结果数据

阶段 4：生成通过/失败报告

• 输入：结构化结果
• 处理：
  1. 使用 Write 生成报告 docs/test/smoke-report.md
  2. 报告包含：执行摘要（通过率）、关键路径覆盖矩阵、失败详情、环境信息
  3. 给出明确结论：SMOKE PASS / SMOKE FAIL
  4. 对 FAIL 情况标注阻塞发布，并指明最小修复范围
• 输出：冒烟测试报告

协作协议引用

• 遵循 .claude/docs/coding-standards.md 编码规范
• 冒烟报告写入 docs/test/ 目录
• 冒烟失败即视为发布阻塞，不得跳过

推荐下一步

使用 /gate-check 进行阶段门禁评估。使用 /regression-suite 补充回归用例。使用 /launch-checklist 在发布前执行最终验证。