关于AI生成测试用例的实践记录(三):从一段 prompt 到三个 skill
2026-11-12 17:20 第二个卿老师 阅读(29) 评论(0) 收藏 举报接上回
上一篇磨到最后,prompt 已经是一整套文档了:全局策略、三层规则、三个阶段的模板、一堆实战约束。
好用,但每次用都是体力活:
- 把
test_strategy.md、phase1、phase2、phase3一份份复制进对话,跑三遍; - 遇到一万多字的大需求,AI 读取还会出现问题,虽然AI最后自己能恢复;
- 需求改了一版,又得几乎从头再来一遍。
Claude Code支持skill后,干脆把这套流程做成 skill——设计成一句话触发、按阶段执行、把阶段产物写成文件。
而且后续发现,一个 skill 不够,真实的研发节奏需要三个,面对新建用例、迭代用例、合并用例三种场景。
一、为什么是 skill,不是继续堆 prompt
prompt 是"我每次得记得怎么用",skill 是"它自己知道怎么用"。区别在三点:
- 一句话触发:说"生成测试用例",它按设计加载策略、逐阶段执行;
- 阶段之间靠文件传递,不靠我把上一步的输出再粘回去;
- 大需求设计上支持自动拆、自动合,省去我手工搬。
另外Claude Code通过渐进式加载机制,能更好的减少token浪费。
二、三个 skill,各管研发的一段
做测试不是只有"从零写一份"这一个场景。真实节奏是:首次生成 → 需求迭代 → 人工审查后版本融合。三个 skill 正好各管一段。
1. generator:从零生成
testcase-generator,对应"全新项目、第一次写用例"。
它把(二)的三阶段固化下来,还多解决了一个大需求文档拆分问题:
- 中小 PRD(< 1.2 万字) → 直接三阶段:业务场景 → 测试点模板 → 完整用例;
- 大 PRD(≥ 1.2 万字) → 升到五阶段:先用 Phase 0 把需求智能拆成几个功能模块,每个模块各跑一遍三阶段,最后用 Phase 4 智能合并、自动去重。
这一步解决的是(二)里我"手动拆、手动合"的体力活。
它的 SKILL.md 原文如下:
点击查看代码
---
name: testcase-generator
description: Generate test cases from PRDs using modular five-phase approach (supports large PRDs with automatic splitting and merging)
---
# AI Test Case Generator v8.0
Generate high-quality test cases from Product Requirement Documents (PRDs).
✨ **v8.0 新特性**:支持大型 PRD 文档的模块化生成(10,000+ 字无压力)
---
## 使用场景
### 场景 1:中小型 PRD(< 12000 字)⚡
**使用三阶段流程**(快速、简单):
```
Generate test cases for this PRD using the three-phase approach:
[paste your PRD]
```
**流程**:Phase 1 → Phase 2 → Phase 3
---
### 场景 2:大型 PRD(≥ 12000 字)🚀
**使用五阶段流程**(完整、准确):
#### Step 1: 拆分 PRD
```
Split this large PRD into testable modules using Phase 0:
[paste your PRD]
```
**输出**:JSON 格式的模块列表 + 全局上下文
#### Step 2-4: 为每个模块生成测试用例
对每个模块执行三阶段流程:
```
Generate test cases for the following module using the three-phase approach:
Module ID: module-1
Module Name: 接收通知功能(捐赠者)
📋 Global Context:
[paste global_context from Step 1]
Module Content:
[paste module content from Step 1]
```
重复此步骤直到所有模块完成。
#### Step 5: 合并测试用例
```
Merge these test cases using Phase 4 and eliminate duplicates:
Module Metadata:
[paste modules metadata from Step 1]
Module 1 Test Cases:
[paste Phase 3 output for module-1]
Module 2 Test Cases:
[paste Phase 3 output for module-2]
...
```
**输出**:完整的、无重复的测试用例文档 + 合并报告
---
## 工作流程对比
### 三阶段流程(适合中小型 PRD)
```
PRD (< 12000字)
↓
Phase 1: 业务场景
↓
Phase 2: 测试点模板
↓
Phase 3: 完整测试用例
↓
输出: 测试用例文档
```
### 五阶段流程(适合大型 PRD)
```
PRD (≥ 12000字)
↓
Phase 0: 智能拆分
↓
┌─ Module 1 ─→ Phase 1→2→3 ─┐
├─ Module 2 ─→ Phase 1→2→3 ─┤
├─ Module 3 ─→ Phase 1→2→3 ─┤
└─ Module N ─→ Phase 1→2→3 ─┘
↓
Phase 4: 智能合并
↓
输出: 完整测试用例文档 + 合并报告
```
---
## 核心优势
| 对比项 | v7 (三阶段) | v8 (五阶段) |
|--------|------------|------------|
| **支持 PRD 大小** | < 12000 字 | 无限制 ✅ |
| **生成完整性** | 可能不完整 | 确保完整 ✅ |
| **重复用例处理** | 人工去重 | 自动去重 ✅ |
| **冲突检测** | 无 | 自动检测并标记 ✅ |
| **模块依赖管理** | 无 | 自动排序 ✅ |
| **适用场景** | 中小型功能 | 大型复杂系统 ✅ |
---
## 详细文档
### Prompt 文档
- `templates/phase0_split/prd_split_prompt.md` - Phase 0: PRD 智能拆分
- `templates/phase1_business_scenario/business_scenario_prompt.md` - Phase 1: 业务场景
- `templates/phase2_test_points/test_points_prompt.md` - Phase 2: 测试点模板
- `templates/phase3_test_cases/test_cases_prompt.md` - Phase 3: 完整测试用例
- `templates/phase4_merge/merge_testcases_prompt.md` - Phase 4: 智能合并
### 全局策略
- `templates/strategy/test_strategy.md` - 全局测试策略(三层架构、边界值处理等)
### 示例文档
- `examples/notification-center.md` - 通知中心完整示例(三阶段流程)
- `examples/large-prd-example.md` - 大型 PRD 示例(五阶段流程)
### 架构文档
- `docs/architecture.md` - v7 三阶段设计文档
- `docs/quick-start.md` - 快速开始指南
- `docs/usage-guide.md` - 详细使用指南
---
## 常见问题
### Q1: 如何判断应该用三阶段还是五阶段?
**规则**:
- PRD < 12000 字 → 三阶段(快速)
- PRD ≥ 12000 字 → 五阶段(完整)
- 不确定 → 先尝试三阶段,如果生成不完整再用五阶段
### Q2: Phase 0 拆分后的模块太多怎么办?
**处理方式**:
1. 检查拆分结果的 `split_report`
2. 如果模块 > 10 个,考虑调整拆分粒度(改为"粗粒度拆分")
3. 可以合并优先级低且相关的模块
### Q3: Phase 4 合并后发现很多冲突怎么办?
**处理方式**:
1. 查看 `merge_report` 中的冲突列表
2. 按建议优先级处理冲突
3. 如果冲突 > 10 个,可能是 Phase 0 拆分不合理,建议重新拆分
### Q4: 可以只用 Phase 0 拆分,然后手动生成吗?
**可以**。Phase 0 输出的每个模块都是独立的子 PRD,可以:
- 交给不同的测试人员
- 使用其他测试工具
- 手动编写测试用例
### Q5: 五阶段流程是否比三阶段质量更好?
**不一定**。五阶段的优势是:
- ✅ 完整性更好(大型 PRD 不会遗漏)
- ✅ 一致性更好(自动去重和冲突检测)
但对于小型 PRD,三阶段更高效。
---
## 最佳实践
### 1. Phase 0 拆分检查清单
拆分后,人工检查:
- [ ] 每个模块是否功能独立?
- [ ] 模块规模是否适中(1500-2500字)?
- [ ] 依赖关系是否准确?
- [ ] 是否有循环依赖?
### 2. Phase 1-3 执行建议
- 按依赖顺序执行(无依赖的模块先执行)
- 高优先级模块优先执行
- 每个模块执行后,检查自检报告
### 3. Phase 4 合并检查清单
合并后,人工检查:
- [ ] 是否有遗漏的模块?
- [ ] 冲突是否都已处理或标记?
- [ ] 去重是否合理(没有过度去重)?
- [ ] 排序是否符合业务逻辑?
---
## 技术架构
### 三层测试架构
1. **业务场景层**:端到端的业务流程测试
2. **页面验证层**:UI元素、字段验证、交互逻辑
3. **接口测试层**:异常场景、权限控制、并发测试
### 模板标记机制
使用 `{模板:XXX}` 控制 AI 扩展范围:
- `{模板:边界值测试}`
- `{模板:必填验证}`
- `{模板:显示隐藏逻辑}`
- 等 11 种预定义模板
### 等价类划分思想
将相似的业务场景归类到同一个抽象分类下,控制场景粒度。
---
## 版本历史
| 版本 | 日期 | 主要变更 |
|------|------|----------|
| v8.0 | 2026-02-02 | 新增 Phase 0 和 Phase 4,支持大型 PRD 模块化生成 |
| v7.0 | 2026-01-04 | 三阶段 Prompt 体系,引入模板标记机制 |
| v6.0 | 2025-12-20 | 单阶段 Prompt(已废弃) |
---
## 相关技能
- `quality-architect` - 质量工程架构设计
- `frontend-testing` - 前端测试用例生成
- `quality-gate` - 质量门禁工作流
---
**Happy Testing! 🚀**
2. iterator:需求迭代场景,用例只动变更的部分
testcase-iterator,对应"需求改了一版,已经有人工审查过的老用例"。
之前的做法是把新需求重新全量生成一遍——既费 token,又把人工审查过的成果冲掉了。iterator 走增量:
- Phase A 变更分析:拿老用例覆盖的功能,和新 PRD 的功能交叉对比,分出"新增/修改/删除/不变",只切出真正变了的那部分;
- Phase B 增量生成:只对 增量需求 跑三阶段(增量需求也大的话,照样 Phase 0 先拆);
- Phase C 合并:把新生成的增量,挂回老文档的框架里。
核心就一句:改了什么,才生成什么。
它的 SKILL.md 原文如下:
点击查看代码
---
name: testcase-iterator
description: 迭代测试用例生成工具。基于已有人工审查的测试用例文档和新版本PRD,增量生成并合并测试用例。触发词:迭代用例、更新用例、iterate testcase、update testcase
---
# 迭代测试用例生成器 v1.0
基于已有人工审查的测试用例文档(V1)和新版本 PRD,进行增量分析、生成和合并。
**核心场景**:需求迭代时,在已有用例基础上仅处理变更部分,而非从零生成。
---
## 使用场景
### 基本用法
```
迭代用例:
V1 用例文档: /path/to/existing-testcases.md
新版本 PRD: /path/to/new-prd.md
输出目录: /path/to/output/
```
### 参数说明
| 参数 | 必填 | 说明 |
|------|------|------|
| V1 用例文档 | 是 | 已有人工审查的测试用例文档路径 |
| 新版本 PRD | 是 | 新版本需求文档路径 |
| 输出目录 | 是 | 结果输出目录 |
---
## 三阶段工作流
```
输入:V1用例文档 + 新版本PRD
│
▼
┌─────────────────────────────────────────────┐
│ Phase A: PRD 变更分析 │
│ - 对比 V1 用例覆盖功能 vs 新 PRD 功能 │
│ - 输出:变更清单 + PRD Delta │
└─────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────┐
│ Phase B: 增量三阶段生成(仅对 Delta 部分) │
│ - Delta < 12000字 → 直接三阶段 │
│ - Delta ≥ 12000字 → Phase 0 拆分 + 三阶段 │
│ - 输出:V2 增量用例文档 │
└─────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────┐
│ Phase C: 合并到现有文档 │
│ - V1 = 现有人工审查文档(主框架) │
│ - V2 = Phase B 生成的增量用例 │
│ - 页面匹配 → 语义去重 → 标记 │
│ - 输出:更新后的用例文档 + 合并报告 │
└─────────────────────────────────────────────┘
```
---
## Phase A: PRD 变更分析
**模板**: `templates/change_analysis/change_analysis_prompt.md`
### 执行步骤
1. 读取 V1 用例文档,提取所有功能覆盖点(按页面/模块分类)
2. 读取新版本 PRD,提取所有功能点
3. 交叉对比,识别差异,分类为:新增/修改/删除/不变
4. 生成 PRD Delta(仅包含新增和修改功能的 PRD 内容)
5. 将变更分析报告写入 `{output_dir}/change-analysis.md`
### 输出
- `{output_dir}/change-analysis.md` — 变更分析报告 + PRD Delta
---
## Phase B: 增量三阶段生成
**复用 `testcase-generator` 的模板**:
- `phase1_business_scenario/business_scenario_prompt.md`
- `phase2_test_points/test_points_prompt.md`
- `phase3_test_cases/test_cases_prompt.md`
- `strategy/test_strategy.md`
### 执行步骤
#### 小型 Delta(< 12000字)
直接对 PRD Delta 执行三阶段流程:
1. **Phase 1**: 读取 PRD Delta + test_strategy.md → 生成业务场景 → 写入 `{output_dir}/delta/phase1-scenarios.md`
2. **Phase 2**: 读取 Phase 1 输出 + test_strategy.md → 生成测试点模板 → 写入 `{output_dir}/delta/phase2-test-points.md`
- **必须包含 `{模板:XXX}` 标记**
3. **Phase 3**: 读取 Phase 2 输出 + test_strategy.md → 生成完整测试用例 → 写入 `{output_dir}/delta/phase3-test-cases.md`
#### 大型 Delta(≥ 12000字)
先拆分,再对每个模块执行三阶段:
1. **Phase 0**: 使用 `phase0_split/prd_split_prompt.md` 拆分 PRD Delta → 写入 `{output_dir}/delta/phase0-split-result.json`
2. **Phase 1→2→3**: 对每个模块依次执行三阶段
- 输出到 `{output_dir}/delta/modules/module-{N}/phase{1,2,3}-*.md`
3. **Phase 4**: 使用 `phase4_merge/merge_testcases_prompt.md` 合并所有模块 → 写入 `{output_dir}/delta/merged-delta.md`
### 输出
- 小型 Delta: `{output_dir}/delta/phase3-test-cases.md`(V2 增量用例)
- 大型 Delta: `{output_dir}/delta/merged-delta.md`(V2 增量用例)
---
## Phase C: 增量合并
**模板**: `templates/merge_integration/merge_integration_prompt.md`
### 执行步骤
1. 读取 V1 用例文档(主框架)
2. 读取 Phase B 输出的 V2 增量用例
3. 读取 Phase A 的变更分析报告(指导合并策略)
4. 按 V1 主节点逐一处理,分块写入
5. 生成合并报告
### 输出
- `{output_dir}/merged-testcases.md` — 合并后的完整用例文档
- `{output_dir}/merge-report.md` — 合并报告
---
## 执行协议
### 1. 严格三阶段分离
Phase B 内的 Phase 1→2→3 必须严格分离,每步写入独立文件:
- Phase 1 只生成业务场景,不涉及测试点
- Phase 2 只生成测试点模板,**必须包含 `{模板:XXX}` 标记**
- Phase 3 才展开模板为完整测试用例
### 2. 文件 I/O 传递数据
子 agent 通过文件 I/O 传递数据,不通过 prompt 传递大量内容:
- Phase A 输出写入文件 → Phase B 从文件读取 Delta
- Phase B 输出写入文件 → Phase C 从文件读取 V2 用例
### 3. V1 主框架不可变
- 现有文档的 `##` 一级页面结构不可改变
- V2 新增内容挂载到对应 V1 主节点下
- 仅当新 PRD 引入全新页面时才新增 `##` 主节点(标记 🆕)
### 4. 分块写入策略
- 复用 `testcase-merger` 的分块写入方案
- 每次写入控制在 8000-10000 tokens 以内
- 按 V1 主节点逐个处理和写入
- 每次 Edit 前先 Read 文件末尾获取定位锚点
### 5. 模板引用路径
Phase B 复用 generator 模板时,使用相对路径引用:
```
../testcase-generator/templates/phase0_split/prd_split_prompt.md
../testcase-generator/templates/phase1_business_scenario/business_scenario_prompt.md
../testcase-generator/templates/phase2_test_points/test_points_prompt.md
../testcase-generator/templates/phase3_test_cases/test_cases_prompt.md
../testcase-generator/templates/phase4_merge/merge_testcases_prompt.md
../testcase-generator/templates/strategy/test_strategy.md
```
---
## 输出目录结构
### 小型 Delta(< 12000字)
```
{output_dir}/
├── change-analysis.md # Phase A: 变更分析报告
├── delta/ # Phase B: 中间产物
│ ├── phase1-scenarios.md
│ ├── phase2-test-points.md # 含 {模板:XXX} 标记
│ └── phase3-test-cases.md # V2 增量用例
├── merged-testcases.md # Phase C: 合并后的完整文档
└── merge-report.md # 合并报告
```
### 大型 Delta(≥ 12000字)
```
{output_dir}/
├── change-analysis.md
├── delta/
│ ├── phase0-split-result.json
│ ├── modules/
│ │ ├── module-1/
│ │ │ ├── phase1-scenarios.md
│ │ │ ├── phase2-test-points.md
│ │ │ └── phase3-test-cases.md
│ │ └── module-N/
│ │ ├── phase1-scenarios.md
│ │ ├── phase2-test-points.md
│ │ └── phase3-test-cases.md
│ └── merged-delta.md # Phase 4 合并后的 V2 用例
├── merged-testcases.md
└── merge-report.md
```
---
## 与其他技能的关系
| 技能 | 关系 | 说明 |
|------|------|------|
| `testcase-generator` | Phase B 模板复用 | 三阶段/五阶段生成流程的模板 |
| `testcase-merger` | Phase C 逻辑复用 | 合并策略、分块写入方案 |
### 区别
| 对比项 | `testcase-generator` | `testcase-iterator` |
|--------|--------------------------|------------------------|
| 场景 | 从零生成全新用例 | 在已有用例基础上迭代更新 |
| 输入 | PRD | V1 用例文档 + 新 PRD |
| 生成范围 | 全量 | 仅变更部分(Delta) |
| 合并 | 无(直接输出) | 自动合并到 V1 框架 |
| 标记 | 无 | 🆕/❌ 变更标识 |
---
## 常见问题
### Q1: 如何判断用 generator 还是 iterator?
- **全新项目**或**首次生成用例** → 用 `testcase-generator`
- **需求迭代**,已有人工审查的用例 → 用 `testcase-iterator`
### Q2: Phase A 分析出没有变更怎么办?
如果 PRD Delta 为空(无新增/无修改),跳过 Phase B 和 Phase C,直接输出报告说明无变更。
### Q3: V1 文档格式不是标准 XMind 格式怎么办?
Phase A 会尽量适配 V1 的实际格式。只要 V1 有清晰的 `##` 一级结构,就能正常工作。
### Q4: 修改功能如何处理?
修改功能会同时出现在 Phase B(生成新版本用例)和 Phase C(合并时与 V1 对应用例对比)。Phase C 会保留 V1 原有用例,并将 V2 新增的差异点标记 🆕 追加。
---
## 版本历史
| 版本 | 日期 | 主要变更 |
|------|------|----------|
| v1.0 | 2026-02-06 | 初始版本,三阶段迭代工作流(变更分析 + 增量生成 + 合并) |
---
## 相关技能
- `testcase-generator` — 全新用例生成(三阶段/五阶段)
- `testcase-merger` — 用例版本合并工具
- `quality-architect` — 质量工程架构设计
---
**Happy Iterating!**
3. merger:人工审查过的,不能被 AI 覆盖
testcase-merger,对应"手里有两份——一份人工审查过的 V1,一份 AI 新生成的 V2,要合成一份"。
这里有个自己的原则:以 V1(人工)为主框架,AI 不能把人审过的判断冲掉。所以合并规则是:
- V1 的一级页面结构当主框架,不可随意改;
- V2 的新页面、新弹窗,按"触发入口"挂到 V1 对应的主节点下;
- 语义匹配识别重复用例 → 保留 V1 版本;
- V2 独有的标 🆕,V1 有但 V2 没有的标 ❌,方便人工一眼看出差异。
说人话:AI 负责补充和提醒,但最终框架是人定的。
它的 SKILL.md 原文如下(这份最长,语义去重的正反例子、按触发入口归属的规则表、以及"合并大文档避免 token 超限"的分块写入方案,都在里面):
点击查看代码
---
name: testcase-merger
description: 测试用例新老版本合并工具。当用户需要合并两个版本的测试用例文档时使用,支持:(1) 指定 V1(人工审查后的老版本)和 V2(AI生成的新版本)进行合并,(2) 按页面匹配合并用例,(3) 智能语义匹配去重,(4) 新增/删除用例标识。触发词:合并测试用例、merge testcase、用例版本合并、testcase merger
---
# 测试用例版本合并
将 V1(人工审查版本)与 V2(AI生成版本)的测试用例文档进行智能合并,生成统一的测试用例文档。
## 核心原则
### 1. 以 V1 为主框架(最重要)
**V1 的一级页面结构作为文档主框架,所有内容必须挂载到 V1 的主节点下。**
V1 结构示例:
```markdown
# 主标题
## 一级页面A(主节点)
### 业务场景
### 页面验证
### 二级页面/弹窗(挂载在一级页面下)
## 一级页面B(主节点)
### 业务场景
### 接口测试
```
- `##` 为一级页面(主节点)- 不可随意新增
- `###` 为测试层级或二级页面/弹窗
- V2 的新增内容必须合并到 V1 对应的主节点下
### 2. 新增页面/弹窗的归属规则
当 V2 包含 V1 不存在的新页面、弹窗、组件时:
1. **优先按 V1 已有归属** - 如果类似功能在 V1 中有归属关系,参照归属
2. **按触发入口归属** - 查看 V2 文档中的"触发入口"或"页面路径",归属到对应的 V1 主页面下
归属规则示例:
| V2 新增页面 | 触发入口 | 归属到 V1 主节点 |
|------------|---------|-----------------|
| Funding Modal | `/project/:id` [Back this Project] 按钮 | IDA 详情页 |
| Legal System(签署)| `/my-ida/:id` [Sign GRSA] 按钮 | IDA管理详情页 |
| Legal System(查看)| `/project/:id` [Legal Doc] 按钮 | IDA 详情页 |
| My Credentials | `/my-donations` | 新增为独立主节点(V1 无对应)|
| Task Center | `/admin/tasks` | 新增为独立主节点(V1 无对应)|
**注意**:只有当 V2 页面完全没有对应的 V1 主节点时,才作为新的独立主节点并标记 🆕
## 工作流程
```
┌─────────────────────────────────────────────────────────────────┐
│ 输入:V1 文件/目录 + V2 文件/目录 │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Step 1: 解析 V1 主框架 │
│ - 识别所有一级页面(## 节点)作为主框架 │
│ - 识别各主节点下的二级页面/弹窗归属关系 │
│ - 提取用例层级结构 │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Step 2: 分析 V2 并匹配归属 │
│ - 将 V2 页面匹配到 V1 主节点 │
│ - V2 独立组件/弹窗按触发入口归属到 V1 主节点 │
│ - 识别完全无法归属的新页面(标记为新主节点 🆕) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Step 3: 用例合并(按 V1 主节点逐一处理) │
│ - 语义匹配识别重复用例 → 保留 V1 版本 │
│ - V2 新增用例挂载到对应主节点下 → 标记 🆕 │
│ - V1 独有用例保留 → 标记 ❌(V2 中不存在) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Step 4: 输出合并结果 │
│ - 保持 V1 主框架结构 │
│ - V2 新增内容挂载到对应主节点下 │
│ - 生成合并报告摘要 │
└─────────────────────────────────────────────────────────────────┘
```
## 输入格式
### V1 格式(XMind 导出的树状结构)
```markdown
# 主标题
## 页面名称
### 业务场景
- 通过性场景
- 场景描述
- 操作步骤
- 预期结果
### 页面验证
- UI样式验证
- 验证点
- 预期结果
### 二级页面/弹窗名称
- UI样式验证
- 验证点
```
### V2 格式(AI 生成的结构化 Markdown)
```markdown
# 页面名称测试用例
**页面路径**: `/path`
**触发入口**: 父页面路径或按钮名称
**角色**: 用户角色
**功能概述**: 功能描述
---
## 业务场景
### 通过性场景
#### 1. 场景名称
- 操作步骤
- 前置条件或操作
- 预期结果
```
## 合并规则
### 1. 重复用例判定(语义匹配)
两个用例被视为重复,当满足以下条件之一:
- 测试相同的功能点(即使表述不同)
- 操作步骤和预期结果语义相同
- 验证同一 UI 元素的同一状态
**示例 - 被判定为重复:**
V1:
```
- 冻结
- IDA 状态变更为FROZEN,除解冻外,无任何操作
```
V2:
```
- 冻结项目
- 点击弹出确认冻结弹窗
- 确认
- IDA冻结成功,项目Progress动态更新成功
```
这两个都测试冻结功能的基本流程,**是重复**,保留 V1。
**示例 - 不是重复:**
V1:
```
- PRE状态
- 显示Draft
```
V2:
```
- Phase: READY 状态(正常)
- 页面头部显示琥珀色 "Active: Ready" 标签
```
这两个测试不同状态下的显示,**不是重复**,都保留。
### 2. 新增用例标识 🆕
V2 中存在但 V1 中不存在的用例,在用例标题末尾添加标识:
```markdown
### 新功能场景 🆕
- 操作步骤
- 预期结果
```
### 3. 删除用例标识 ❌
V1 中存在但 V2 中不存在的用例,保留并添加标识:
```markdown
### 已移除的功能场景 ❌
- 操作步骤
- 预期结果
```
### 4. 新主节点处理
只有当 V2 页面完全没有对应的 V1 主节点时,才新增为独立主节点并标记:
```markdown
## 新页面名称 🆕
### 业务场景
(V2 内容保留)
```
## 输出格式
**必须保持 V1 的主框架结构**:
```markdown
# 主标题(合并版)
**合并说明**:
- 无标记:V1 保留用例
- 🆕:V2 新增用例
- ❌:V1 删除用例(V2 中不存在)
---
## 合并报告
### 页面匹配情况
| V1 页面 | V2 页面 | 状态 |
|---------|---------|------|
| My IDA 页 | 01-MyIDA-List-Page | 已匹配 |
| IDA管理详情页 | 02-IDA-Manager-Detail-Page | 已匹配 |
| - | 04-My-Credentials-Asset-Page | 新增主节点 🆕 |
### 归属关系
| V2 组件/弹窗 | 触发入口 | 归属主节点 |
|-------------|---------|-----------|
| Funding Modal | /project/:id | IDA 详情页 |
| Legal System | /my-ida/:id | IDA管理详情页 |
### 统计摘要
| 类别 | 数量 |
|------|------|
| V1 保留用例 | X |
| V2 新增用例 🆕 | X |
| V1 删除用例 ❌ | X |
| 重复用例(已去重)| X |
---
## V1 主节点 A(保持原名)
### 业务场景
(V1 原有 + V2 新增合并后的内容)
### 页面验证
(V1 原有 + V2 新增合并后的内容)
### 二级页面/弹窗名称
(V1 原有内容)
### V2 新增弹窗名称 🆕
(V2 新增,按触发入口归属到此主节点)
---
## V1 主节点 B(保持原名)
...
---
## V2 新增主节点 🆕
(完全无法归属到 V1 的新页面)
```
## 使用示例
### 示例 1:单文件合并
```
用户:合并测试用例
V1: /path/to/v1.md
V2: /path/to/v2.md
```
### 示例 2:目录批量合并
```
用户:合并测试用例
V1: /path/to/v1-cases/ (包含多个页面的用例文件)
V2: /path/to/v2-cases/ (包含多个页面的用例文件)
```
## 重要约束
1. **V1 主框架不可改变** - 必须保持 V1 的一级页面(## 节点)结构
2. **V2 内容按归属挂载** - V2 新增的页面/弹窗/组件必须归属到 V1 主节点下
3. **禁止捏造用例** - 所有输出用例必须来自 V1 或 V2 原文档
4. **保持原文表述** - 保留用例时尽量保持原文表述,仅做必要的格式转换
5. **标识清晰** - 确保 🆕 和 ❌ 标识位置一致,便于人工审查
6. **分块写入** - 大型文档必须分块写入,避免输出 token 超限(见下文)
## 大型文档处理(避免 Output Token 超限)
### 问题背景
合并后的测试用例文档通常超过 3000 行,直接生成完整内容会触发 API 的 output token 限制错误:
```
API Error: Claude's response exceeded the 32000 output token maximum
```
### 解决方案:分块写入
**核心策略**:不要一次性生成完整文档,而是使用 Write/Edit 工具分块写入文件。
### 实施步骤
```
┌─────────────────────────────────────────────────────────────────┐
│ 1. 首次写入:创建文件并写入文档头部和合并报告 │
│ - 使用 Write 工具创建新文件 │
│ - 写入:标题、合并说明、合并报告摘要 │
│ - 写入前 1-2 个主节点的内容 │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 2. 追加写入:逐个主节点追加内容 │
│ - 使用 Edit 工具,定位到文件末尾 │
│ - 每次追加 1-2 个主节点的内容 │
│ - 控制每次追加的内容在 8000-10000 tokens 以内 │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 3. 最终写入:添加文档尾注 │
│ - 添加合并说明 │
│ - 添加版本信息和生成时间 │
└─────────────────────────────────────────────────────────────────┘
```
### 每次写入的内容量控制
| 内容类型 | 建议 Token 量 | 说明 |
|---------|-------------|------|
| 文档头部+合并报告 | 2000-3000 | 首次写入 |
| 单个主节点(小型)| 3000-5000 | 用例数 < 50 |
| 单个主节点(中型)| 5000-8000 | 用例数 50-100 |
| 单个主节点(大型)| 8000-10000 | 用例数 > 100,可能需要分两次 |
| 文档尾注 | 500-1000 | 最后写入 |
### 分块写入示例
```
# 第 1 次:创建文件,写入头部和前 2 个主节点
Write /path/to/output.md
├── # 标题
├── ## 合并报告
├── ## IDA 合约重设计(V1 主节点 1)
└── ## IDAS首页(V1 主节点 2)
# 第 2 次:追加内容
Edit /path/to/output.md (定位到末尾)
├── ## Header 导航栏(V1 主节点 3)
└── ## My IDA 页(V1 主节点 4)
# 第 3 次:追加内容
Edit /path/to/output.md (定位到末尾)
├── ## IDA管理详情页(V1 主节点 5)
│ └── ### GRSA 协议签署弹窗 🆕
└── ## IDA 详情页(V1 主节点 6)
├── ### Funding Modal 🆕
└── ### 法律文件档案列表弹窗 🆕
# 第 4 次:追加新主节点
Edit /path/to/output.md (定位到末尾)
├── ## My Credentials 资产页 🆕
├── ## Task Center 任务中心 🆕
└── ## Audit Workbench 审核详情工作台 🆕
# 第 5 次:添加尾注
Edit /path/to/output.md (定位到末尾)
├── ## 合并说明
└── **文档版本**: v1.2.0(合并版)
```
### 关键技巧
1. **读取后再编辑**:每次使用 Edit 前,先用 Read 工具读取文件末尾位置,获取定位锚点
2. **使用唯一锚点**:选择文件末尾的唯一内容作为 `old_string`,避免匹配歧义
3. **逐步验证**:每次追加后可用 Read 验证内容是否正确写入
4. **失败重试**:如果 Edit 失败(如锚点不唯一),重新读取文件,选择更精确的锚点
## 层级映射参考
| V1 层级 | V2 层级 | 合并后层级 |
|---------|---------|-----------|
| `# 主标题` | - | `# 主标题(合并版)` |
| `## 页面名称` | `# 页面名称测试用例` | `## 页面名称`(保持 V1)|
| `### 业务场景` | `## 业务场景` | `### 业务场景` |
| `### 二级页面` | (按触发入口归属)| `### 二级页面` |
| `- 场景` | `### 场景名称` | `- 场景` 或 `#### 场景名称`|
## 归属判断示例
当遇到 V2 新增的 "Funding Modal 资助支付弹窗" 时:
1. 查看 V2 文档头部的 **触发入口**: `/project/:id` 公共详情页的 [Back this Project] 按钮
2. 在 V1 中找到 `/project/:id` 对应的主节点 → "IDA 详情页"
3. 将 Funding Modal 作为 `### Funding Modal 资助支付弹窗 🆕` 挂载到 "IDA 详情页" 下
三、贯穿三个 skill 的几个工程决定
做这三个工具时,有几条决定是共用的,也是踩过坑才定的:
- 以人工为主框架,AI 内容往上挂——人工的判断永远不被 AI 覆盖(merger 和 iterator 都守这条)。
- 阶段之间靠文件 I/O 传数据,不靠 prompt 堆内容——上一阶段写文件,下一阶段读文件,避免把一大坨内容塞进对话。
- 分块写入,绕开输出上限——合并后的用例文档动辄三五千行,一次性生成会撞上
Claude's response exceeded the 32000 output token maximum。所以改成先 Write 创建文件 + 写头部,再逐个主节点 Edit 追加,每次控制在 8000~10000 token(细节见上面 merger 的 SKILL.md)。 - 模板标记机制延续下来——
{模板:XXX}继续用来按住 AI 的过度扩展。
四、诚实交代:这三个工具到哪一步了
- 三个 skill 都已建成、文件齐全(SKILL.md + 模板就位),实践中能初步完成我的测试设计工作。
- 但它们是自用的工具,不一定适合每个人。
- 尤其大 PRD 的五阶段流程,拆分粒度、合并冲突这些,目前仍然强依赖人工 checklist 复核。
收尾
从 prompt,到三阶段文档,再到三个 skill,就是把脑子里那些"该怎么设计用例"的判断,一点点显式化、工具化、可复用化,这也是在AI提供测试效率的过程中持续迭代和反馈的结果。
但现在随着模型能力增强,很多问题已经被解决了,而上面设计的用例面对对象是人,是否改为AI更好,待大家实践了
-- 本篇有AI润色
浙公网安备 33010602011771号