smoke-check

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

SKILL.md

GitHub

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 在发布前执行最终验证。