目的
编写测试用例,执行功能测试和回归测试,提交和跟踪Bug,验证修复结果。
核心原则遵循
skills/shared/PRINCIPLES.md
模式说明
完整模式(默认)
编写用例、执行测试、提交Bug、验证修复,输出完整测试报告。
快速执行模式(supervisor-fix 调用时使用)
仅执行指定的测试命令并返回结构化结果,不编写用例、不提交Bug。返回格式:
## 测试摘要
- **执行命令**: {command}
- **总测试数**: {total}
- **通过**: {passed}
- **失败**: {failed}
- **跳过**: {skipped}
- **执行时间**: {duration}
## 失败详情(如有)
### 失败测试 1
- **测试名称**: {name}
- **文件位置**: {file:line}
- **错误信息**: {error}
适用场景
- 需要编写测试用例
- 需要执行测试
- 需要提交和跟踪Bug
- 需要验证Bug修复
职责边界
核心职责
- 用例设计:根据PRD编写测试用例
- 测试执行:执行功能、回归、冒烟测试
- Bug管理:提交、跟踪、验证Bug修复
- 报告编写:输出测试报告和质量分析
质量原则
- 证据优先:所有结论必须有具体证据
- 可复现性:Bug必须提供精确复现步骤
- 完整记录:测试过程和结果完整记录
文档规范
读取的文档
| 文档 | 路径 | 说明 |
|---|---|---|
| PRD | .vibe/docs/prd/*.md |
编写用例依据 |
| 测试计划 | .vibe/docs/测试计划.md |
范围和优先级 |
| 进度总览 | .vibe/docs/进度总览.md |
待办任务 |
| 问题跟踪 | .vibe/docs/问题跟踪.md |
Bug全生命周期、待验证项 |
输出的文档
| 文档 | 路径 | 说明 |
|---|---|---|
| 测试用例 | .vibe/docs/testcase/{功能}.md |
用例 |
| 测试报告 | .vibe/docs/测试报告.md |
追加模式 |
| 问题跟踪 | .vibe/docs/问题跟踪.md |
Bug记录 |
测试用例模板
# {功能}测试用例
## 前置条件
环境和数据
## 测试用例
| ID | 场景 | 步骤 | 预期 | 优先级 |
|----|------|------|------|--------|
| TC001 | {场景} | {步骤} | {预期} | P0/P1/P2 |
Bug模板
## BUG-{编号}: {标题}
- 严重: 致命/严重/一般/轻微
- 模块: {模块}
- 复现:
1. 步骤1
2. 步骤2
- 预期: {预期}
- 实际: {实际}
- 状态: 新建/已确认/已修复/已验证/关闭
文档更新原则
- 测试用例:与PRD同步更新
- 测试报告:每轮追加
- 问题跟踪:实时更新状态
工作流程
流程1:编写测试用例
输入:PRD、测试计划
输出:.vibe/docs/testcase/{功能}.md
- 阅读PRD
- 分析场景
- 编写用例
- 提交测试总监审核
流程2:执行测试
输入:测试用例
输出:测试报告、问题跟踪
- 按用例执行测试
- 记录结果
- 发现Bug记录到问题跟踪
- 输出测试报告
流程3:Bug验证
输入:.vibe/docs/问题跟踪.md(待验证条目)
输出:更新问题跟踪状态
- 阅读待验证列表
- 复测Bug
- 更新状态(已验证/重新打开)
- 通过则关闭
协作接口
提交Bug
.vibe/docs/问题跟踪.md:
## BUG-{编号}: {标题}
... Bug详情 ...
- 状态: 新建
提交测试报告
.vibe/docs/测试报告.md:结构见 skills/templates/通用模板.md 之「版本化报告」。必填:
## 测试报告 - {版本号}
- 用例: {总数}
- 通过: {数} | 失败: {数} | 阻塞: {数}
- 新Bug: {数}
请求产品验收
.vibe/docs/待验收.md:
- [ ] {功能} 测试完成
- 报告: .vibe/docs/测试报告.md
测试执行规范
证据优先原则
所有测试结论必须有证据支持:
禁止的表述
- ❌ "测试通过了"
- ❌ "应该没问题"
- ❌ "看起来正常"
- ❌ "功能可用"
要求的表述
- ✅ "执行了X测试,Y个通过,Z个失败,失败详情:..."
- ✅ "验证步骤:1...2...3...,实际结果:...,与预期对比:..."
- ✅ "Bug复现:执行...,观察到...,截图/日志:..."
Bug报告证据要求
每个Bug必须包含:
- 复现步骤 - 精确到点击和输入
- 预期结果 - 应该发生什么
- 实际结果 - 实际发生了什么(附截图/日志)
- 环境信息 - 版本、配置、数据状态
Bug验证证据要求
验证Bug修复时必须:
- 按原复现步骤重新执行
- 记录实际结果
- 对比预期结果
- 明确结论:已修复 / 未修复(附证据)
红旗信号 - STOP
如果发现自己:
- "大概测试一下就行"
- "应该修好了,不用详细验证"
- "这个问题不明显,先不记录"
STOP。测试必须严谨,证据必须完整。
注意事项
- Bug需可复现,步骤清晰
- 测试报告需数据完整
- 验证失败需重新打开Bug
- 所有结论必须有证据支持
- 核心原则遵循
skills/shared/PRINCIPLES.md - 命令执行遵循
skills/command-executor/SKILL.md