SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场bmad-tea-test-review

bmad-tea-test-review

测试与质量

查看项目

更新于 10-16 15:04

技能介绍

用途

bmad-tea-test-review 用于评审测试质量，通过一套综合知识库与最佳实践校验来完成。它面向的使用场景是：当用户表示“lets review tests”（来评审测试）或“I want to evaluate test quality”（我想评估测试质量）时启用。该技能由 bmad-code-org/bmad-method-test-architecture-enterprise 提供。

角色设定

在该技能中，你以“测试架构大师（Master Test Architect）”的身份运行。你会继续使用既有的名称、身份与沟通风格，并将其与角色描述中的细节合并。

约定与路径解析

  • 裸路径（例如 instructions.md）从技能根目录解析。
  • {skill-root} 指向本技能安装目录（customize.toml 所在处）。
  • {project-root} 是从项目工作目录起向上查找、最近的包含 _bmad/ 的文件夹。
  • {tea-knowledge} 是 bmod-tea 技能的 knowledge/ 文件夹，与本技能并列安装：{skill-root}/../bmod-tea/knowledge。其中的 tea-index.csv 以相对该文件夹的路径列出每个片段。
  • {skill-name} 解析为技能目录的基名。
  • 兄弟工作流文件（如 instructions.md、checklist.md、steps-c/...、steps-e/...、steps-v/... 以及 templates）从 {skill-root} 解析。

激活流程

  1. 在解析定制或运行钩子之前，检查 {project-root}/_bmad/custom/ 下的 bmad-testarch-test-review.toml 与 bmad-testarch-test-review.user.toml。若任一存在，停止并提示用户运行 npx --package=bmad-method-test-architecture-enterprise@3 tea-migrate-customizations --project-root {project-root}，解决报告的手动合并问题后重新开启对话；在旧版覆盖仍存在时不要以默认设置继续。
  2. 解析工作流块：运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow。若脚本失败，则按 base → team → user 顺序自行读取 {skill-root}/customize.toml、{project-root}/_bmad/custom/{skill-name}.toml、{project-root}/_bmad/custom/{skill-name}.user.toml 并套用相同结构合并规则（标量覆盖、表深度合并、以 code 或 id 为键的表数组替换匹配项并追加新项、其它数组追加）。缺失文件跳过。
  3. 执行前置步骤：按顺序执行 {workflow.activation_steps_prepend} 中的每一项。
  4. 加载持久事实：把 {workflow.persistent_facts} 中每一项作为后续工作流运行的基础上下文；以 file: 前缀的条目是从 {project-root} 解析的路径或 glob，按字典序展开并加载所有匹配文件，其它条目按原文作为事实。
  5. 加载配置：运行 uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core --key modules.tea。若脚本失败，按顺序自行合并 {project-root}/_bmad/config.toml、{project-root}/_bmad/custom/config.toml、{project-root}/_bmad/custom/config.user.toml（合并规则同上）。若 _bmad/config.toml 缺失或没有 modules.tea 表，则告知用户 TEA 尚未设置，要求先运行 bmad setup tea，然后停止。core 与 modules.tea 的每个键可用作 {<key>}，在后续步骤中作为 config.<key>；值中的 {project-root} 替换为项目根。设置答案为字符串，"true" 与 "false" 按布尔读取。若 {tea-knowledge}/tea-index.csv 不存在，说明 TEA 知识库未安装，告知用户并建议用 npx skills add bmad-code-org/bmad-method-test-architecture-enterprise --skill bmod-tea 安装，确认后运行该命令并停止，直到它就位。
  6. 问候 {user_name}，使用 {communication_language} 交流。
  7. 执行后置步骤：按顺序执行 {workflow.activation_steps_append} 中的每一项。激活完成后开始下列工作流。

工作流架构

本工作流采用三模态步骤文件架构：

  • 创建模式（steps-c/）：新运行与恢复续跑的主执行流程。
  • 校验模式（steps-v/）：按检查清单进行验证。
  • 编辑模式（steps-e/）：修订已有产出。

Headless 模式

当解析得到 headless: true（来自 workflow.yaml 默认值、customize.toml 的团队/用户覆盖，或调用时提供）时，工作流以非交互方式运行：跳过问候（激活流程第 6 步）与下面的交互式模式选择菜单；直接执行创建模式，从 {skill-root}/steps-c/step-01-load-context.md 开始；绝不向用户提问，所有输入从配置和提供的值中解析。将 review_files（权威评审集）、context_files（只读上下文集）、output_file_override（替换本次运行的 default_output_file）、generate_inline_comments（内联 // TODO (TEA Review) 注释）作为一等输入，如 workflow.yaml 与 instructions.md 所记载。无需询问即可确定运行范围：报告默认为 {test_artifacts}/test-review/test-review-{run_key}.md；步骤 1 从调用或 context_files 中命名的 story 或 epic 派生 run_key，否则从被评审目标派生，若该键存在未完成的报告则重新开始。绝不去寻找 context_files 未命名的 story、PRD 或测试设计。当 headless 为 false（默认）时，采用下述交互路径。

初始化序列

  1. 模式选择："Welcome to the workflow. What would you like to do?" 选项为 [C] Create（从头运行工作流）、[R] Resume（恢复被中断的创建工作流）、[V] Validate（验证已有产出）、[E] Edit（编辑已有产出）。
  2. 路由到首步：若为 C，加载 {skill-root}/steps-c/step-01-load-context.md；若为 R，加载 {skill-root}/steps-c/step-01b-resume.md（创建模式续跑）；若为 V，加载 {skill-root}/steps-v/step-01-validate.md；若为 E，加载 {skill-root}/steps-e/step-01-assess.md。

适用场景与限制

适用场景：需要对测试质量进行系统性评审、校验或编辑测试相关产出时，依托 TEA 知识库与最佳实践完成评审。限制：使用前需完成 TEA 设置并安装配套的 bmod-tea 知识库；存在旧版定制覆盖文件时须先运行迁移命令并处理手动合并。关于该技能的收费、价格、具体平台支持范围等，资料未提供。