SuperAPI AI 工具集

bdd-assistant

测试与质量

查看项目

更新于 10-16 09:16

技能介绍

用途

BDD Assistant 是一个指导开发者完成行为驱动开发(BDD)工作流的技能,主要帮助开发者完成以下事项:

  • 通过 Discovery 会话探索需求
  • 以 Given-When-Then 格式编写有效的 Gherkin 场景
  • 创建可复用的步骤定义
  • 将 BDD 与 TDD 集成以实现功能
  • 维护活文档

该技能以英文与繁体中文提供,版本 1.0.0,最后更新于 2026-01-19,适用于 Claude Code Skills,采用 CC BY 4.0 许可。

主要能力

技能围绕 BDD 工作流的三个阶段提供引导:

Discovery 阶段:识别干系人(业务、开发、测试),讨论并理解用户故事,通过 Example Mapping 收集具体示例,识别边界情况,记录待跟进问题。

Formulation 阶段:确保场景使用正确的 Gherkin 语法,保持声明式风格(描述 WHAT 而非 HOW),使用业务语言而非技术术语,每个场景独立自包含,步骤数控制在 5-10 个以内,并由干系人评审。

Automation 阶段:为所有步骤创建步骤定义,保持可复用,先让场景失败(RED),在单元级实现中使用 TDD,再让所有场景通过(GREEN),最后重构代码。

技能还内置以下参考材料:

  • BDD 工作流检查清单(三个阶段逐项检查)
  • Gherkin 快速参考:Feature、Scenario、Given、When、Then、And/But、Background、Scenario Outline 等关键字的用途与示例
  • 声明式与命令式场景的对比示例
  • Three Amigos 快速参考:业务、开发、测试三种角色各自的关注点与建议提问
  • 功能文件结构、场景风格指南、步骤定义最佳实践、BDD 与 TDD 的集成示意
  • BDD 与 SDD、TDD、ATDD 的集成方式示例(含 @spec、@AC 等标签标注方式)
  • 反模式快速检测表(症状、可能问题、快速修复)

使用方式

该技能在 Claude Code Skills 环境中使用。技能支持项目级配置检测,检测顺序为:

  1. 检查 CONTRIBUTING.md 中的 "Disabled Skills" 部分,若列出此技能则在本项目中禁用
  2. 检查 CONTRIBUTING.md 中的 "BDD Standards" 部分
  3. 检查代码库中已有的 .feature 文件
  4. 若均未找到,默认采用标准 BDD 实践

首次设置时,若未找到配置且上下文不明确,技能会询问项目使用的 BDD 工具:Cucumber(JavaScript/TypeScript)、Behave(Python)、SpecFlow(C#)或其他,并在选择后建议在 CONTRIBUTING.md 中记录相关标准。

技能的配置与标准参考来源为 universal-dev-standards,详细指南引用 BDD Core Standard、BDD Workflow Guide、Gherkin Quick Reference 以及与 TDD、ATDD、Testing、SDD 相关的标准文档。

适用场景

适用于需要以行为驱动方式推进需求探索、场景编写与自动化测试的开发项目,尤其适合团队协作中需要业务、开发、测试三方对齐验收标准的场景,以及希望将 BDD 与 TDD、ATDD、SDD 结合的工程实践。

限制

资料中未提供该技能的收费、价格、具体平台兼容范围与运行效果数据。技能的检测行为依赖项目中是否存在 CONTRIBUTING.md 与 .feature 文件,未提供配置时的默认实践为标准 BDD 实践。