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

bmad-testarch-test-review

测试与质量

查看项目

更新于 10-15 14:48

技能介绍

用途

bmad-testarch-test-review 是一个测试质量评审技能，属于 BMAD 测试架构企业版（bmad-method-test-architecture-enterprise）。其目标是通过一套综合知识库与最佳实践验证，对测试质量进行评审。该技能以“主测试架构师（Master Test Architect）”的角色运行，并沿用既有的名称、身份与沟通风格。

主要能力

  • 基于知识库与最佳实践对测试质量进行验证与评审。
  • 采用三模态步骤文件架构：
    • 创建模式（steps-c/）：新运行的主要执行流程，也用于断点续跑。
    • 验证模式（steps-v/）：依据清单（checklist）进行校验。
    • 编辑模式（steps-e/）：修订已有产出。
  • 支持无头（headless）非交互运行：跳过问候与交互式模式选择菜单，直接执行创建模式，从 {skill-root}/steps-c/step-01-load-context.md 开始，全程不提示用户，所有输入从配置与传入值解析。
  • 无头模式下可接收以下一等输入：review_files（权威评审集合）、context_files（只读上下文集合）、output_file_override（替换本次运行的默认输出文件）、generate_inline_comments（生成内联 // TODO (TEA Review) 注释）。
  • 评审报告默认输出到 {test_artifacts}/test-review/test-review-{run_key}.md；run_key 由调用中或 context_files 中指定的 story 或 epic 推导，否则由被评审目标推导；若该 key 已存在未完成的报告则重新开始。

使用方式

激活流程包含以下步骤：

  1. 解析工作流块：运行 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 并应用相同的结构合并规则自行解析。
  2. 执行前置步骤：按顺序执行 {workflow.activation_steps_prepend} 中的每一项。
  3. 加载持久事实：将 {workflow.persistent_facts} 中每一项作为后续运行的基础上下文；以 file: 为前缀的条目是从 {project-root} 解析的路径或 glob，按字典序加载所有匹配文件。
  4. 加载配置：运行 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，然后停止。
  5. 问候用户：以 {communication_language} 向 {user_name} 问候。
  6. 执行追加步骤：按顺序执行 {workflow.activation_steps_append} 中的每一项。

初始化序列（交互模式）：

  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。

约定：裸路径（如 instructions.md）从技能根解析；{skill-root} 为本技能安装目录（customize.toml 所在处）；{project-root} 为从项目工作目录向上查找最近的包含 _bmad/ 的文件夹；{tea-knowledge} 为 bmod-tea 技能的 knowledge/ 文件夹（安装在本技能旁边：{skill-root}/../bmod-tea/knowledge），其中的 tea-index.csv 按相对路径列出每个片段；{skill-name} 为技能目录的 basename；instructions.md、checklist.md、steps-c/...、steps-e/...、steps-v/... 及模板等兄弟工作流文件从 {skill-root} 解析。

适用场景

  • 用户希望评审测试质量时（例如说“lets review tests”或“I want to evaluate test quality”）。
  • 需要依据最佳实践与清单对测试进行系统性验证。
  • 需要修订已有测试评审产出。
  • 需要在无人工交互的自动化流程中执行测试评审（无头模式）。

限制

  • 依赖 TEA 配置：若 _bmad/config.toml 缺失或没有 modules.tea 表，需先运行 bmad setup tea。
  • 依赖 TEA 知识库：若 {tea-knowledge}/tea-index.csv 不存在，则知识库未安装，需通过 npx skills add bmad-code-org/bmad-method-test-architecture-enterprise --skill bmod-tea 安装。
  • 无头模式下不会主动查找 context_files 未指定的 story、PRD 或测试设计，以避免非确定性输入。
  • 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。