e2e-specify

用户输入

$ARGUMENTS

在继续之前, 你必须考虑用户输入(如果不为空).

概述

执行测试分析与设计工作流，使用 MFQ&PPDCS 方法论进行测试分析，然后使用 TCON 方法设计黑盒测试用例。

调用场景：

1. 初步设计（在 /specify 之后）：基于初始规范生成初步测试分析和设计
2. 更新设计（在 /clarify 之后）：基于澄清后的规范更新测试分析和设计

执行流程

1. [ ] 设置环境

1. 判断操作系统：Windows 或 Linux
2. 运行前置检查脚本：
   • Windows: scripts/powershell/check-prerequisites.ps1 --json
   • Linux: scripts/bash/check-prerequisites.sh --json
3. 解析输出：
   • 提取 FEATURE_DIR（特性目录绝对路径）
   • 提取 SPEC_FILE（规范文件路径）
   • 提取 AVAILABLE_DOCS（可用文档列表）

重要：所有路径必须是绝对路径。

2. [ ] 确定调用场景

根据调用上下文确定场景类型：

• 初步设计：如果在 /specify 之后调用，场景为"初步设计"
• 更新设计：如果在 /clarify 之后调用，场景为"更新设计"

3. [ ] 启动测试分析设计 Agent

使用 Agent 工具启动 @"test-analysis-design (agent)"，传递以下参数：

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 完成后，验证生成的文档：

1. 检查文档存在性：

   • 检查 {FEATURE_DIR}/test-analysis.md 是否存在
   • 检查 {FEATURE_DIR}/e2e-test.md 是否存在

2. 验证文档内容：

   • test-analysis.md 应包含：
     • KYM 分析
     • TCO 分析
     • MFQ 建模结果
     • 测试点清单
     • Issues 列表（状态应为 Open 或 Resolved）
   • e2e-test.md 应包含：
     • 用例清单
     • 用例详情（Given-When-Then 格式）
     • 测试数据设计
     • 追溯性矩阵

3. 处理验证结果：

   • [成功] 验证成功：输出完成报告，继续下一步
   • [失败] 验证失败：
     • 记录错误信息
     • 如果是关键错误（文档未生成、内容为空），报告失败
     • 如果是非关键错误（部分内容缺失），记录警告但继续

5. [ ] 报告完成情况

输出完成报告，包括：

• 生成文档：

  • test-analysis.md 路径
  • e2e-test.md 路径

• 验证结果：

  • 文档存在性检查：[成功]/[失败]
  • 内容完整性检查：[成功]/[失败]
  • 问题列表（如有）