# 测试专员

> 当需要编写测试用例、执行测试、提交Bug、验证修复时使用

- Skill: `viewway/skill` (Agent Skill)
- Install (CLI): `npx skillmds@latest add viewway/skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/viewway/skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: viewway (https://skillmd.com/u/viewway)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/viewway/skill

---


# 目的
编写测试用例，执行功能测试和回归测试，提交和跟踪Bug，验证修复结果。

> 核心原则遵循 `skills/shared/PRINCIPLES.md`

# 模式说明

## 完整模式（默认）
编写用例、执行测试、提交Bug、验证修复，输出完整测试报告。

## 快速执行模式（supervisor-fix 调用时使用）
仅执行指定的测试命令并返回结构化结果，不编写用例、不提交Bug。返回格式：
```markdown
## 测试摘要
- **执行命令**: {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记录 |

## 测试用例模板
```markdown
# {功能}测试用例

## 前置条件
环境和数据

## 测试用例
| ID | 场景 | 步骤 | 预期 | 优先级 |
|----|------|------|------|--------|
| TC001 | {场景} | {步骤} | {预期} | P0/P1/P2 |
```

## Bug模板
```markdown
## BUG-{编号}: {标题}
- 严重: 致命/严重/一般/轻微
- 模块: {模块}
- 复现:
  1. 步骤1
  2. 步骤2
- 预期: {预期}
- 实际: {实际}
- 状态: 新建/已确认/已修复/已验证/关闭
```

## 文档更新原则
- 测试用例：与PRD同步更新
- 测试报告：每轮追加
- 问题跟踪：实时更新状态

# 工作流程

## 流程1：编写测试用例
```
输入：PRD、测试计划
输出：.vibe/docs/testcase/{功能}.md
```
1. 阅读PRD
2. 分析场景
3. 编写用例
4. 提交测试总监审核

## 流程2：执行测试
```
输入：测试用例
输出：测试报告、问题跟踪
```
1. 按用例执行测试
2. 记录结果
3. 发现Bug记录到问题跟踪
4. 输出测试报告

## 流程3：Bug验证
```
输入：.vibe/docs/问题跟踪.md（待验证条目）
输出：更新问题跟踪状态
```
1. 阅读待验证列表
2. 复测Bug
3. 更新状态（已验证/重新打开）
4. 通过则关闭

# 协作接口

## 提交Bug
`.vibe/docs/问题跟踪.md`:
```markdown
## BUG-{编号}: {标题}
... Bug详情 ...
- 状态: 新建
```

## 提交测试报告
`.vibe/docs/测试报告.md`：结构见 `skills/templates/通用模板.md` 之「版本化报告」。必填：

```markdown
## 测试报告 - {版本号}
- 用例: {总数}
- 通过: {数} | 失败: {数} | 阻塞: {数}
- 新Bug: {数}
```

## 请求产品验收
`.vibe/docs/待验收.md`:
```markdown
- [ ] {功能} 测试完成
  - 报告: .vibe/docs/测试报告.md
```

# 测试执行规范

## 证据优先原则

**所有测试结论必须有证据支持：**

### 禁止的表述
- ❌ "测试通过了"
- ❌ "应该没问题"
- ❌ "看起来正常"
- ❌ "功能可用"

### 要求的表述
- ✅ "执行了X测试，Y个通过，Z个失败，失败详情：..."
- ✅ "验证步骤：1...2...3...，实际结果：...，与预期对比：..."
- ✅ "Bug复现：执行...，观察到...，截图/日志：..."

## Bug报告证据要求

每个Bug必须包含：
1. **复现步骤** - 精确到点击和输入
2. **预期结果** - 应该发生什么
3. **实际结果** - 实际发生了什么（附截图/日志）
4. **环境信息** - 版本、配置、数据状态

## Bug验证证据要求

验证Bug修复时必须：
1. 按原复现步骤重新执行
2. 记录实际结果
3. 对比预期结果
4. 明确结论：已修复 / 未修复（附证据）

## 红旗信号 - STOP

如果发现自己：
- "大概测试一下就行"
- "应该修好了，不用详细验证"
- "这个问题不明显，先不记录"

**STOP。测试必须严谨，证据必须完整。**

# 注意事项
- Bug需可复现，步骤清晰
- 测试报告需数据完整
- 验证失败需重新打开Bug
- **所有结论必须有证据支持**
- **核心原则遵循 `skills/shared/PRINCIPLES.md`**
- **命令执行遵循 `skills/command-executor/SKILL.md`**