| name | e2e-specify |
| description | 测试分析与设计(TA&TD)：使用MFQ&PPDCS方法论进行测试分析，从需求提取测试点（M单功能/F功能交互/Q质量属性），然后使用TCON方法设计黑盒测试用例。输出：测试分析报告(test-analysis.md)和黑盒测试用例(e2e-test.md)。当用户说"/e2e-specify"、"生成测试设计"、"创建测试用例"、"分析测试设计"，或在规范生成后需要生成测试设计时使用此技能。 |
用户输入
$ARGUMENTS
在继续之前, 你必须考虑用户输入(如果不为空).
概述
执行测试分析与设计工作流，使用 MFQ&PPDCS 方法论进行测试分析，然后使用 TCON 方法设计黑盒测试用例。
调用场景：
- 初步设计（在
/specify 之后）：基于初始规范生成初步测试分析和设计
- 更新设计（在
/clarify 之后）：基于澄清后的规范更新测试分析和设计
执行流程
1. [ ] 设置环境
- 判断操作系统：Windows 或 Linux
- 运行前置检查脚本：
- Windows:
scripts/powershell/check-prerequisites.ps1 --json
- Linux:
scripts/bash/check-prerequisites.sh --json
- 解析输出：
- 提取
FEATURE_DIR（特性目录绝对路径）
- 提取
SPEC_FILE（规范文件路径）
- 提取
AVAILABLE_DOCS（可用文档列表）
重要：所有路径必须是绝对路径。
2. [ ] 确定调用场景
根据调用上下文确定场景类型：
- 初步设计：如果在
/specify 之后调用，场景为"初步设计"
- 更新设计：如果在
/clarify 之后调用，场景为"更新设计"
3. [ ] 启动测试分析设计 Agent
使用 Agent 工具启动 test-analysis-design subagent，传递以下参数：
Agent 参数：
subagent_type: "general-purpose"（使用通用 agent）description: "测试分析与设计 - 生成测试分析和黑盒测试用例"prompt 包含以下内容：
# 测试分析与设计任务
## 调用场景
{场景类型}: 初步设计/更新设计
## 输入文件
- spec.md: {SPEC_FILE}
- feature_dir: {FEATURE_DIR}
## 任务要求
1. 读取 spec.md 规范文件
2. 使用 MFQ&PPDCS 方法论进行测试分析
3. 生成测试分析报告（test-analysis.md）
4. 使用 TCON 四步法设计黑盒测试用例
5. 生成黑盒测试用例文档（e2e-test.md）
## 输出位置
- test-analysis.md: {FEATURE_DIR}/test-analysis.md
- e2e-test.md: {FEATURE_DIR}/e2e-test.md
## 重要说明
- 如果是"初步设计"场景：所有 Issues 保持 Open 状态
- 如果是"更新设计"场景：根据澄清结果更新，将相关 Issues 标记为 Resolved
4. [ ] 验证生成文档
等待 agent 完成后，验证生成的文档：
-
检查文档存在性：
- 检查
{FEATURE_DIR}/test-analysis.md 是否存在
- 检查
{FEATURE_DIR}/e2e-test.md 是否存在
-
验证文档内容：
test-analysis.md 应包含：
- KYM 分析
- TCO 分析
- MFQ 建模结果
- 测试点清单
- Issues 列表（状态应为 Open 或 Resolved）
e2e-test.md 应包含：
- 用例清单
- 用例详情（Given-When-Then 格式）
- 测试数据设计
- 追溯性矩阵
-
处理验证结果：
- [成功] 验证成功：输出完成报告，继续下一步
- [失败] 验证失败：
- 记录错误信息
- 如果是关键错误（文档未生成、内容为空），报告失败
- 如果是非关键错误（部分内容缺失），记录警告但继续
5. [ ] 报告完成情况
输出完成报告，包括：
-
生成文档：
- test-analysis.md 路径
- e2e-test.md 路径
-
验证结果：
- 文档存在性检查：[成功]/[失败]
- 内容完整性检查：[成功]/[失败]
- 问题列表（如有）
-
测试统计：
- 测试点数量（来自 test-analysis.md）
- 测试用例数量（来自 e2e-test.md）
- Issues 数量及状态
-
下一步建议：
- 如果存在 Open Issues：建议执行
/clarify 澄清
- 如果测试设计完整：建议执行
/design 进行技术设计
错误处理
-
Agent 执行失败：
-
文档生成失败：
- 检查 agent 输出日志
- 验证输入文件（spec.md）是否存在且有效
- 验证输出目录（FEATURE_DIR）是否可写
-
内容验证失败：
- 如果是关键内容缺失：报告失败
- 如果是非关键内容缺失：记录警告，继续执行
通用指南
快速指南
- 专注于测试分析和设计，不涉及测试代码实现
- 使用 MFQ&PPDCS 方法论系统化分析
- 使用 TCON 方法设计黑盒测试用例
- 关注需求覆盖率和测试点完整性
- 保持黑盒测试特性，不暴露内部实现
AI 生成
- 做出有根据的猜测：使用上下文、需求描述和测试设计模式
- 限制 Issues 数量：仅记录真正需要澄清的问题
- 优先级排序：按影响范围排序 Issues（范围 > 安全 > 体验 > 细节）
建议后续步骤
测试分析与设计完成后，可继续执行：
- clarify：澄清测试相关问题（如果存在 Open Issues）
- design：进行技术设计
- e2e-varify：完善测试设计细节
