davidyichengwei/agentic-engineering-framework/workflow-test-generation

测试生成

Step 0: 意图识别与路径路由

根据调用上下文判断走哪条路径：

如果无法判断，默认走完整流程。

Step 1: 收集测试上下文

完整流程和测试策略设计执行本步骤。快速补测试跳过（用户已指定了被测代码）。

尝试读取 docs/design-docs/<module>/<feature>/spec.md：

有 spec.md：

1. 读取 "7. 测试计划"
2. 测试计划明确 → 进入 Step 2
3. 测试计划不完整 → 补充读取 "2. 目标"、"3. 需求"、"4. 设计方案"，自行判断

无 spec.md（为已有代码补测试）：

• 询问用户要测哪些函数/类，基于代码生成

Step 2: 确定测试类型

根据代码特征自动判断需要哪些测试类型（可组合，非互斥），无法判断时才询问：

一个 feature 通常需要多种测试类型组合，例如：核心逻辑用单元测试 + 端到端用集成测试。

Step 3: 制定测试计划

分析被测代码，制定测试计划（不生成代码）：

1. 读取被测代码，识别公共接口、输入/输出、副作用、需要 mock 的依赖
2. 读取 reference/boundary-checklist.md，选择适用的边界条件
3. 根据项目需要，读取对应模块的测试参考文档（如有）
4. 为每个测试目标列出：正常路径、边界条件、异常场景的具体测试点

创建测试任务清单，与用户确认后再继续：

示例：
1. [pending] UnitTest - FooClass::Bar() 正常路径 + 边界条件
2. [pending] UnitTest - FooClass::Bar() 异常处理
3. [pending] IntegrationTest - 端到端流程

测试策略设计路径到此结束。将测试计划输出为 spec.md 测试计划章节的内容，不进入 Step 4。

Step 4: 逐个生成测试

仅完整流程和快速补测试执行本步骤。

4.1 加载编码规范（🚨 强制前置）

根据项目需要，额外加载其他编码规范 skill。

4.2 逐个生成

对每个测试任务生成测试代码。每个测试必须覆盖三类场景：

1. 正常路径 — happy path
2. 边界条件 — 基于 Step 3 选出的 boundary-checklist 条目
3. 异常场景 — 错误输入、异常处理

生成后更新构建配置，复用项目现有的测试基类和断言工具（不要自己造）。

每完成一个任务，标记 [completed]，继续下一个。

Step 5: 收尾流程

仅完整流程执行本步骤。

前置条件：所有测试用例已通过。

提示用户进入 workflow-code-review 进行 AI 代码评审（同时评审功能代码和测试代码）：

自测已全部通过。
 
推荐下一步：
- 说"CR"或"代码评审"进入 AI 代码评审阶段

强制规则

1. 测试计划必须经用户确认后才能生成代码
2. 必须覆盖三类场景：正常路径 + 边界条件 + 异常场景
3. 必须应用 boundary-checklist：Step 3 中读取并选择适用条目
4. 必须可编译运行：包含所有必要头文件/导入，更新构建配置
5. 复用现有基础设施：使用项目的测试基类和断言工具，不要自己造
6. 测试全部通过才能推进：编译失败或用例未通过时，先修复，确认全部 PASS 后才可进入 CR