用途
bmad-tea-trace 用于生成“需求或用户旅程到测试”的追溯矩阵，分析测试覆盖率，并据此做出质量门禁决策（PASS / CONCERNS / FAIL / WAIVED）。它面向需要评估测试覆盖与质量把关的场景，角色设定为 Master Test Architect（主测试架构师）。当用户表达类似“lets create traceability matrix”或“I want to analyze test coverage”的意图时可触发。
主要能力
- 生成从需求/旅程到测试的追溯矩阵。
- 分析覆盖率（coverage analysis）。
- 做出质量门禁决策，结果为 PASS、CONCERNS、FAIL 或 WAIVED 之一。
- 采用三模态步骤文件架构：创建模式（steps-c/）、验证模式（steps-v/）、编辑模式（steps-e/）。
- 创建模式支持恢复（Resume）中断的流程。
使用方式
激活前，技能会检查 {project-root}/_bmad/custom/ 下的 bmad-testarch-trace.toml 与 bmad-testarch-trace.user.toml；若存在，需先运行迁移命令 npx --package=bmad-method-test-architecture-enterprise@3 tea-migrate-customizations --project-root {project-root}，完成手动合并后重新开始对话。
激活流程按步骤执行：
- 解析工作流块：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、{project-root}/_bmad/custom/{skill-name}.user.toml 并手动合并。
- 执行 activation_steps_prepend 中各项。
- 加载持久事实（persistent_facts），file: 前缀条目从 {project-root} 解析并按路径字典序加载。
- 加载配置：uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core --key modules.tea；若缺少 _bmad/config.toml 或无 modules.tea 表，则提示 TEA 未设置并停止，需先运行 bmad setup tea。
- 以 {communication_language} 向 {user_name} 问候。
- 执行 activation_steps_append 中各项。
随后进入工作流初始化，用户可选择：C（创建，从开始运行）、R（恢复，继续中断的创建流程）、V（验证，校验既有输出）、E（编辑，修改既有输出）。路由分别加载 steps-c/step-01-load-context.md、steps-c/step-01b-resume.md、steps-v/step-01-validate.md、steps-e/step-01-assess.md。
创建模式按以下顺序自动解析覆盖率基准：正式需求、契约/规格制品、可解析的外部指针（当 allow_external_pointer_resolution 启用时）、以及无正式基准时从源码推断的合成旅程/需求（当 allow_synthetic_oracle 启用时）。在首次保存前解析门禁目标与 run_key（story-{story_key}、epic-{epic_num}、release-{slug}、hotfix-{slug} 或 system），所有输出写入 {test_artifacts}/trace/，文件名含 run_key：traceability-matrix-{run_key}.md、e2e-trace-summary-{run_key}.json、gate-decision-{run_key}.json。某范围的运行不会读写其他范围的输出。
适用场景
适用于需要对需求或用户旅程与测试之间建立可追溯关系、评估覆盖情况并据此判断质量门禁状态的团队与流程，尤其在使用 BMAD 方法测试架构企业版的项目中。
限制
- 依赖 TEA 配置与知识库：缺少 _bmad/config.toml 或 modules.tea 时无法继续；缺少 {tea-knowledge}/tea-index.csv 时需先安装（npx skills add bmad-code-org/bmad-method-test-architecture-enterprise --skill bmod-tea）。
- 存在遗留自定义覆盖文件时，必须完成迁移并新开对话，不能沿用默认设置继续。
- 本技能资料未提供收费、价格、平台支持等具体信息，暂未提供。