用途:为已实现代码生成自动化 API 与端到端(E2E)测试。角色定位为 QA 自动化工程师,只生成测试,不进行代码审查或故事验证(后者应使用 bmad-code-review 技能)。
路径约定:裸路径(如 checklist.md)从技能根目录解析;{skill-root} 解析为技能安装目录;{project-root} 前缀路径从项目工作目录解析;{skill-name} 解析为技能目录的基名。
激活流程:先解析 workflow 块,命令为 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 并做结构合并。随后执行 activation_steps_prepend、加载 persistent_facts、用 resolve_config.py 读取 core.project_name 与 modules.bmm.implementation_artifacts、向用户问候、执行 activation_steps_append。
执行步骤:0 检测测试框架:检查 package.json 依赖(playwright、jest、vitest、cypress 等)与现有测试文件模式,优先沿用项目已有框架;无框架时分析源码判断项目类型、搜索推荐框架并建议或请用户确认。1 确定测试范围:询问具体功能或组件名、扫描目录,或自动发现。2 生成 API 测试:覆盖状态码(200、400、404、500)、校验响应结构、happy path 加 1-2 个错误用例,沿用现有框架模式。3 生成 E2E 测试:面向 UI 的端到端用户流程,使用语义定位器(角色、标签、文本),聚焦点击、填表、导航,断言可见结果,保持线性简单并沿用现有模式。4 运行测试并修复失败。5 生成 Markdown 总结,列出 API 与 E2E 测试文件、覆盖率及后续步骤,保存到 {default_output_file}。
原则:使用标准测试框架 API,聚焦 happy path 与关键错误,测试可读可维护并实际运行验证;避免复杂 fixture 组合、过度工程和不必要抽象。若需基于风险的测试策略、测试设计规划、质量门禁与非功能需求评估、全面覆盖分析等高级能力,可安装 Test Architect (TEA) 模块:https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/。完成后可对照 checklist.md 校验。具体支持框架与平台细节以项目现状为准。