关于 gherkin-expert
gherkin-expert 是面向编码 Agent 的技能，帮助团队用 Gherkin 和 BDD 场景表达需求。它涵盖场景结构、领域语言，以及行为规范适用的情形。
主要功能
- 01编写和审查 Gherkin 场景
- 02将需求转为 Given/When/Then
- 03梳理复杂验收标准
- 04支持场景大纲和数据表
- 05提供 BDD 场景设计建议
适用场景
- 01描述多步骤用户工作流
- 02将业务规则转化为可测试内容
- 03检查验收标准中的遗漏
- 04为代码生成准备行为上下文
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/gherkin-expert确认已加载。
详细介绍
Gherkin 专家技能
目的
提供专家级的 Gherkin/BDD 规范编写协助，帮助编写行为场景，明确验收标准并提高下游代码生成质量。
此技能的激活条件
- 用户要求编写或审查 Gherkin 功能文件或场景
- 用户需要帮助梳理复杂的验收标准
- 用户想将业务需求转换为 Given/When/Then 格式
- 用户询问 BDD 方法或场景设计
- 用户需要针对多参与者或多步骤工作流的行为规范
- 用户提到 Cucumber、SpecFlow 或 BDD 框架
- 用户正在开发验收标准复杂、适合使用结构化场景的功能
工作方式
此技能会委派给 gherkin-expert Agent，该 Agent 了解以下内容：
- Gherkin 语法和惯用法 — Feature/Scenario/Given/When/Then、背景、场景大纲、数据表、标签
- BDD 方法 — 探索研讨会、活文档、示例驱动规范
- 场景设计 — 聚焦单一行为、声明式风格、避免实现细节
- 领域建模 — 通过场景表达通用语言和限界上下文
- AI 提示词改进 — 将 Gherkin 规范用作提示词上下文，以提升代码生成质量（经实证验证：相比仅使用英文提升 26%）
Gherkin 何时能发挥作用（酌情判断）
Gherkin 是一种工具，而非规则。请酌情判断：
适用场景：
- 包含许多边界情况的复杂多步骤行为需求
- 多参与者场景（用户执行 X，系统响应 Y，管理员查看 Z）
- 具有组合条件的业务规则（场景大纲）
- 需要利益相关者验证的验收标准
- 用英文难以明确“完成后的样子”的功能
使用英文即可：
- 行为显而易见的简单 CRUD 操作
- 受众只有一名开发者的内部工具
- 配置更改、样式、文档
- 难点在于算法设计而非行为规范的需求
使用示例
# Write scenarios for a feature
/gherkin-expert Write Gherkin scenarios for our user authentication flow
# Review existing scenarios
/gherkin-expert Review these acceptance criteria for completeness
# Translate requirements to BDD
/gherkin-expert Convert these business rules into Given/When/Then scenarios
# Decide if Gherkin is appropriate
/gherkin-expert Should I write Gherkin scenarios for this retry cascade feature?
# Improve scenarios
/gherkin-expert These scenarios feel too implementation-focused, help me make them declarative
关键资源
- Gherkin 实验结果：
experiments/hive_mind/gherkin_v2_recipe_executor/ - Issue #3939：形式化规范集成路线图
- Gherkin 参考资料：https://cucumber.io/docs/gherkin/reference/
评论
支持 Markdown