用途
bmad-tea-test-design 是 BMAD 测试架构体系中的测试设计技能，用于创建系统级或史诗（epic）级测试计划。当用户表达“lets design test plan”（设计测试计划）或“I want to create test strategy”（创建测试策略）时使用。其目标是以风险与可测试性评估为基础，产出史诗级的测试计划。
角色定位
该技能以“主测试架构师（Master Test Architect）”的角色运作，并会与既有的名称、身份与沟通风格合并。
主要能力
- 创建系统级或史诗级测试计划。
- 采用三模式步骤文件架构：
- 创建模式（steps-c/）：新运行与恢复续跑的主执行流程。
- 验证模式（steps-v/）：依据检查清单进行验证。
- 编辑模式（steps-e/）：修订已有产出。
- 产出文件包括：系统级 test-design-architecture.md 与 test-design-qa.md、史诗计划 test-design-epic-{epic_num}.md、{project_name}-handoff.md 交接文档，以及 exploration/ 下的探索截图。
- 每次运行写入独立的进度检查点 test-design-progress-{run_key}.md，run_key 在系统级运行为 system，史诗级运行为 epic-{epic_num}。
- 支持恢复（Resume）模式：匹配对应运行的检查点，当存在多个且未指定范围时会询问，并拒绝继续 runKey 属于其他运行的检查点。读取 workflowStatus、nextStep、totalSteps 等进度元数据，必要时回退到旧版 lastStep 数据。
使用方式
激活时会执行以下步骤：
- 解析工作流块（workflow block）：运行
uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow；若脚本失败，则按 base → team → user 顺序合并 customize.toml、{project-root}/_bmad/custom/{skill-name}.toml 与 .user.toml。 - 执行前置步骤（activation_steps_prepend）。
- 加载持久事实（persistent_facts），file: 前缀条目按词法路径顺序展开加载。
- 加载配置：运行
uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core --key modules.tea；若失败则手动合并 config.toml、custom/config.toml 与 custom/config.user.toml。若缺少 _bmad/config.toml 或无 modules.tea 表，会提示 TEA 尚未设置，需先运行 bmad setup tea。 - 问候用户。
- 执行后置步骤（activation_steps_append）。
激活前还会检查 {project-root}/_bmad/custom/ 下的 bmad-testarch-test-design.toml 与 bmad-testarch-test-design.user.toml；若存在则停止，提示运行 npx --package=bmad-method-test-architecture-enterprise@3 tea-migrate-customizations --project-root {project-root} 进行迁移。
若 {tea-knowledge}/tea-index.csv 不存在，则知识库未安装，会提示可用 npx skills add bmad-code-org/bmad-method-test-architecture-enterprise --skill bmod-tea 安装。
初始化后用户可选择：
- [C] Create：从头运行工作流，加载 steps-c/step-01-detect-mode.md。
- [R] Resume：恢复中断的 Create 工作流，加载 steps-c/step-01b-resume.md。
- [V] Validate：验证已有产出，加载 steps-v/step-01-validate.md。
- [E] Edit：编辑已有产出，加载 steps-e/step-01-assess.md。
约定
- 裸路径（如 instructions.md）从技能根目录解析。
- {skill-root} 为该技能安装目录（customize.toml 所在处）。
- {project-root} 为从项目工作目录向上查找、最近包含 _bmad/ 的文件夹。
- {tea-knowledge} 为 bmod-tea 技能的 knowledge/ 文件夹，位于 {skill-root}/../bmod-tea/knowledge。
- {skill-name} 为技能目录的 basename。
适用场景
适用于需要创建系统级或史诗级测试计划、设计测试策略的软件项目，尤其适合采用 BMAD 方法体系并已配置 TEA 模块的团队。
限制
- 需要预先配置 TEA 模块（_bmad/config.toml 中需有 modules.tea 表），否则会提示先运行 bmad setup tea。
- 需要安装 TEA 知识库（tea-index.csv），否则无法继续。
- 存在旧版自定义覆盖文件时需先迁移，否则无法继续。
- 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。