@zhouhao4221/devflow-skills 0.3.6 → 0.3.7

package/plugins/req/skills/test/SKILL.md

@@ -3,14 +3,11 @@ name: test
 description: 需求测试 - 综合测试验证（回归 + 新建 + 交互验证）
 ---
 
-> **重要**：本命令的测试文件位置、运行命令、环境启动命令均从项目 `docs/prompt/testing.md` 读取，不内置任何项目细节。文件不存在时打印创建提示（非阻塞），并回退到 `docs/prompt/architecture.md` 的「测试规范」章节。
-
 # 需求测试
 
-针对指定需求执行综合测试，包含三个层次：运行已有测试、引导创建新测试、交互验证测试要点。
+针对指定需求执行综合测试：运行已有测试 → 引导创建新测试 → 交互验证测试要点。
 
-> **Audience:** Engineer
-> 存储路径和缓存同步规则见 [_storage.md](./_storage.md)
+> 测试文件位置、运行命令、环境启动从 `docs/prompt/testing.md` 读取。文件不存在时打印创建提示，回退到 `docs/prompt/architecture.md` 测试规范章节。
 
 ## 命令格式
 
@@ -18,410 +15,99 @@ description: 需求测试 - 综合测试验证（回归 + 新建 + 交互验证
 /req:test [REQ-XXX] [选项]
 ```
 
-- 省略编号时自动选择「开发中」或「测试中」的需求
-- 多个候选时让用户选择
-
-### 选项
+省略编号时自动选择「开发中/测试中」的需求，多个候选让用户选择。
 
 | 选项 | 说明 |
 |-----|------|
 | `--failed` | 仅运行上次失败的测试 |
-| `--skip-ut` | 跳过 UT 阶段 |
-| `--skip-api` | 跳过 API 测试阶段 |
-| `--skip-e2e` | 跳过 E2E 测试阶段 |
-| `--force` | 某阶段失败时继续后续阶段 |
+| `--skip-ut` / `--skip-api` / `--skip-e2e` | 跳过对应阶段 |
+| `--force` | 某阶段失败时继续后续 |
 
 ---
 
 ## 总体流程
 
-```
 1. 选择需求 & 前置检查
 2. 提取测试要点（业务维度）
 3. 识别变更范围（代码维度）
-4. 阶段一：UT 
-   回归：运行变更相关的已有 UT
-   新建：缺失时引导创建
-5. 阶段二：API 测试 
-   回归：运行已有 API 测试
-   新建：缺失时引导创建
-6. 阶段三：E2E 测试 
-   回归：运行已有 E2E 测试
-   新建：缺失时引导创建
+4. 阶段一：UT（变更相关的已有 + 缺失引导创建）
+5. 阶段二：API 测试（已有 + 缺失引导创建）
+6. 阶段三：E2E 测试（已有 + 缺失引导创建）
 7. 交互验证：自动化未覆盖的测试要点
-8. 更新状态为「测试中」& 记录结果
+8. 更新状态、记录结果、同步缓存
 9. 汇总报告
-```
-
-每个阶段的模式都是：**先跑已有 → 发现缺失 → 引导新建**。
 
 ---
 
 ## 详细流程
 
-### 1. 选择需求
+### 1. 选择需求 & 前置检查
 
-- 指定编号 → 使用该需求
-- 未指定 → 查找可测试需求（状态为开发中/测试中）
+指定编号或自动查找。状态必须为「开发中/测试中」。功能点有未完成时警告。
 
-### 2. 前置检查
+### 2. 提取测试要点
 
-- 状态必须为「开发中」或「测试中」
-- 检查功能点完成情况，有未完成时警告
-
-### 3. 提取测试要点
-
-从需求文档提取测试要点，作为整个测试过程的验证基准：
-
-```
-需求测试：REQ-001 <需求标题>
+从需求文档提取，作为验证基准。分四类：API 测试、业务规则测试、数据权限测试、其他测试。
 
-测试要点（共 N 项）：
+### 3. 识别变更范围
 
-API 测试：
-- [ ] <API 测试点 1>
-- [ ] <API 测试点 2>
-
-业务规则测试：
-- [ ] <业务规则测试点 1>
-- [ ] <业务规则测试点 2>
-
-数据权限测试：
-- [ ] <数据权限测试点 1>
-
-其他测试：
-- [ ] <其他测试点>
-```
-
-### 4. 识别变更范围
-
-从需求文档提取「文件改动清单」，定位本次需求涉及的源文件：
-
-```
-分析变更范围...
-
-从需求文档的「文件改动清单」提取：
-<source-file-1>
-<source-file-2>
-<source-file-3>
-<source-file-N>
-
-关联的测试文件：
-<test-file-1>               ✅ 存在
-<test-file-2>               ✅ 存在
-<test-file-3>               ❌ 不存在
-<test-file-N>               ✅ 存在
-```
-
-**变更范围识别规则**：
-
-1. **优先从需求文档**获取「文件改动清单」中列出的文件
-2. 如果文档中没有明确列出，则通过 `git diff` 对比当前分支与主分支的变更文件
-3. 按 `docs/prompt/testing.md` 定位关联测试文件
+优先从需求文档「文件改动清单」提取，否则 `git diff` 对比当前分支与主分支。按 `docs/prompt/testing.md` 定位关联测试文件。
 
 ---
 
-### 5. 阶段一：UT（变更相关）
-
-**仅运行本次需求变更相关的单元测试。**
-
-#### 5.1 回归 — 运行已有 UT
-
-```
-
-阶段一：单元测试（变更相关）
-
-
-运行已有 UT...
-
-<docs/prompt/testing.md 中定义的 UT 运行命令>
-
-<test-file-1>
-<TestCase_1>            ✅ PASS
-<TestCase_2>            ✅ PASS
-<TestCase_3>            ✅ PASS
-
-<test-file-2>
-<TestCase_4>            ✅ PASS
-<TestCase_5>            ✅ PASS
-
-UT 回归结果：N/N 通过 ✅
-
-测试要点覆盖：
-- [x] <测试要点> ← <对应测试用例>
-```
+### 阶段一：UT（变更相关）
 
-自动化测试通过后，将能匹配的测试要点标记为已覆盖。
+**回归**：运行变更相关的已有 UT（命令从 testing.md 读取），将通过的用例匹配到测试要点。
 
-#### 5.2 新建 — 引导补充缺失 UT
-
-```
-⚠️ 以下变更文件缺少 UT：
-- <test-file-missing>
-
-  y → 执行 /req:test_new REQ-001 --type=ut 的流程，生成缺失的测试文件
-  n → 记录为待补充，继续后续阶段
-  skip → 跳过，不再提示
-```
+**新建**：对缺少 UT 的变更文件，引导执行 `/req:test_new --type=ut`。
 
 ---
 
-### 6. 阶段二：API 测试
-
-#### 6.0 环境检查
-
-API 测试需要 `docs/prompt/testing.md` 中定义的测试环境：
-
-```
-检查测试环境...
-<依赖服务 1>     ✅ 运行中
-<依赖服务 2>     ✅ 运行中
-<后端服务>       ✅ 运行中
-```
-
-如果未启动：
-
-```
-⚠️ 测试环境未就绪
-
-按 docs/prompt/testing.md 测试环境配置启动服务...
-<docs/prompt/testing.md 中定义的测试环境启动命令>
-
-等待服务就绪...
-<依赖服务 1>   ✅ 就绪
-<依赖服务 2>   ✅ 就绪
-<后端服务>     ✅ 就绪
-```
-
-#### 6.1 回归 — 运行已有 API 测试
+### 阶段二：API 测试
 
-```
-
-阶段二：API 测试
-
-
-运行已有 API 测试...
-
-<docs/prompt/testing.md 中定义的 API 测试运行命令>
-
-<api-test-file>
-<TestCase_API_1>           ✅ PASS
-<TestCase_API_2>           ✅ PASS
-<TestCase_API_3>           ✅ PASS
-
-API 回归结果：N/N 通过 ✅
-
-测试要点覆盖：
-- [x] <API 测试要点> ← <对应测试用例>
-```
-
-#### 6.2 新建 — 引导补充缺失 API 测试
-
-```
-⚠️ 以下测试要点尚未被 API 测试覆盖：
-- [ ] <未覆盖的 API 测试要点>
+**环境检查**：按 testing.md 检查依赖服务和后端服务，未启动时自动启动并等待就绪。
 
-  y → 执行 /req:test_new REQ-001 --type=api 的流程
-  n → 记录为待补充，继续后续阶段
-  skip → 跳过
-```
-
-如果 API 测试目录下完全没有相关测试文件：
-
-```
-⚠️ 未找到需求相关的 API 测试文件
+**回归**：运行已有 API 测试，匹配测试要点。
 
-  y → 执行 /req:test_new REQ-001 --type=api
-```
+**新建**：对未覆盖的 API 测试要点，引导执行 `/req:test_new --type=api`。
 
 ---
 
-### 7. 阶段三：E2E 测试
-
-#### 7.0 环境检查
-
-E2E 测试额外需要前端服务：
-
-```
-检查测试环境...
-<依赖服务 1>     ✅ 运行中
-<依赖服务 2>     ✅ 运行中
-<后端服务>       ✅ 运行中
-<前端服务>       ❌ 未启动
-
-启动前端服务...
-<docs/prompt/testing.md 中定义的前端启动命令>
-<前端服务>  ✅ 就绪
-```
-
-#### 7.1 回归 — 运行已有 E2E 测试
-
-```
+### 阶段三：E2E 测试
 
-阶段三：E2E 测试
+**环境检查**：额外检查前端服务。
 
+**回归**：运行已有 E2E 测试。
 
-运行已有 E2E 测试...
-
-<docs/prompt/testing.md 中定义的 E2E 运行命令>
-
-  ✅ <E2E 场景描述 1> (Xs)
-  ✅ <E2E 场景描述 2> (Xs)
-
-E2E 回归结果：N/N 通过 ✅
-
-测试要点覆盖：
-- [x] <E2E 测试要点> ← <对应场景名>
-```
-
-#### 7.2 新建 — 引导补充缺失 E2E 测试
-
-```
-⚠️ 以下用户流程尚未被 E2E 覆盖：
-- [ ] <未覆盖的用户流程>
-
-  y → 执行 /req:test_new REQ-001 --type=e2e
-```
-
-如果 E2E 测试目录下完全没有相关测试文件：
-
-```
-⚠️ 未找到需求相关的 E2E 测试文件
-
-  y → 执行 /req:test_new REQ-001 --type=e2e
-  skip → 跳过 E2E 阶段
-```
+**新建**：对未覆盖的用户流程，引导执行 `/req:test_new --type=e2e`。
 
 ---
 
-### 8. 交互验证
-
-经过 UT/API/E2E 三个阶段后，检查测试要点的覆盖情况。对于**自动化测试未覆盖到的要点**，引导用户手动验证：
+### 交互验证
 
-```
-
-交互验证：自动化未覆盖的测试要点
-
-
-已自动覆盖 M/N 项，剩余 K 项需手动验证：
-
-【测试点 X】<测试要点描述>
-
-验证步骤：
-1. <操作步骤 1>
-2. <操作步骤 2>
-3. <预期结果>
-
-验证结果：
-- [ ] 通过
-- [ ] 失败（请描述问题）
-- [ ] 跳过
-
-请输入结果：
-```
-
-逐项引导验证，直到所有未覆盖要点完成。
+对自动化未覆盖的测试要点，逐项引导用户手动验证（展示操作步骤、预期结果），记录通过/失败/跳过。
 
 ---
 
-### 9. 更新状态、记录测试结果并同步缓存
-
-测试完成后再更新状态：
-- 修改元信息状态为「测试中」
-- 勾选生命周期「测试中」
-- 更新需求文档的测试要点（勾选通过项，记录日期）
-- 记录自动化覆盖情况
-- **同步到全局缓存**
-
-### 10. 汇总报告
-
-```
-
-综合测试报告 - REQ-001 <需求标题>
-
-
-自动化测试：
-
-阶段     已有   新建   通过   失败   结果    
-
-UT       N      N      N      N      ✅ 通过  
-API      N      N      N      N      ✅ 通过  
-E2E      N      N      N      N      ✅ 通过  
-
-小计     N      N      N      N      ✅ 通过  
-
-
-测试要点覆盖：
-
-测试要点                              覆盖方式  结果    
-
-<测试要点 1>                          API 自动  ✅ 通过  
-<测试要点 2>                          UT 自动   ✅ 通过  
-<测试要点 3>                          E2E 自动  ✅ 通过  
-<测试要点 4>                          手动验证  ✅ 通过  
+### 更新状态 & 汇总报告
 
-合计 N/N                                       ✅ 全通过 
+- 状态改为「测试中」，更新生命周期
+- 勾选测试要点通过项，记录日期和覆盖情况
+- 同步全局缓存
+- 输出汇总报告（各阶段通过/失败、测试要点覆盖率）
 
-```
-
-### 11. 下一步操作
-
-#### 全部通过
-
-```
-测试全部通过！
-
-REQ-001 <需求标题>
-状态：测试中
-自动化：N/N 通过
-测试要点：N/N 覆盖
-
-下一步：
-- 完成需求：/req:done REQ-001
-- 全量回归：/req:test_regression
-- 重新测试：/req:test REQ-001
-```
-
-#### 存在失败
-
-```
-⚠️ 存在测试失败项
-
-失败阶段：<阶段名>
-失败用例：
-- ❌ <失败用例名>
-  文件：<test-file>:<line>
-  原因：<失败原因描述>
-
-未覆盖测试要点：
-- ❌ <测试要点>（手动验证失败）
-  问题：<问题描述>
-
-下一步：
-- 返回修复：/req:dev REQ-001
-- 仅重跑失败：/req:test REQ-001 --failed
-- 忽略继续：/req:test REQ-001 --force
-```
+**全部通过**：提示 `/req:done`。**存在失败**：列出失败用例和原因，提示 `/req:dev` 修复或 `--failed` 重跑。
 
 ---
 
-## 测试模式说明
-
-### 综合测试（默认）
-按顺序执行 UT → API → E2E → 交互验证，某阶段失败时停止（除非 `--force`）。
-
-### 增量测试
-仅运行上次失败的用例：`/req:test REQ-XXX --failed`
-
-### 跳过某阶段
-```bash
-/req:test REQ-001 --skip-e2e         # 跳过 E2E
-/req:test REQ-001 --skip-ut          # 跳过 UT
-/req:test REQ-001 --skip-api         # 跳过 API
-```
+## 测试模式
 
-### 强制继续
-某阶段失败时继续后续阶段：`/req:test REQ-XXX --force`（不推荐）
+| 模式 | 命令 |
+|------|------|
+| 综合测试（默认） | `/req:test REQ-XXX` |
+| 增量测试 | `/req:test REQ-XXX --failed` |
+| 跳过阶段 | `--skip-ut` / `--skip-api` / `--skip-e2e` |
+| 强制继续 | `--force` |
 
 ---