代码改变世界

关于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 的几个工程决定

做这三个工具时,有几条决定是共用的,也是踩过坑才定的:

  1. 以人工为主框架,AI 内容往上挂——人工的判断永远不被 AI 覆盖(merger 和 iterator 都守这条)。
  2. 阶段之间靠文件 I/O 传数据,不靠 prompt 堆内容——上一阶段写文件,下一阶段读文件,避免把一大坨内容塞进对话。
  3. 分块写入,绕开输出上限——合并后的用例文档动辄三五千行,一次性生成会撞上 Claude's response exceeded the 32000 output token maximum。所以改成先 Write 创建文件 + 写头部,再逐个主节点 Edit 追加,每次控制在 8000~10000 token(细节见上面 merger 的 SKILL.md)。
  4. 模板标记机制延续下来——{模板:XXX} 继续用来按住 AI 的过度扩展。

四、诚实交代:这三个工具到哪一步了

  • 三个 skill 都已建成、文件齐全(SKILL.md + 模板就位),实践中能初步完成我的测试设计工作。
  • 但它们是自用的工具,不一定适合每个人。
  • 尤其大 PRD 的五阶段流程,拆分粒度、合并冲突这些,目前仍然强依赖人工 checklist 复核。

收尾

从 prompt,到三阶段文档,再到三个 skill,就是把脑子里那些"该怎么设计用例"的判断,一点点显式化、工具化、可复用化,这也是在AI提供测试效率的过程中持续迭代和反馈的结果。

但现在随着模型能力增强,很多问题已经被解决了,而上面设计的用例面对对象是人,是否改为AI更好,待大家实践了

-- 本篇有AI润色