gherkin-expert

Gherkin エキスパートスキル

目的

受け入れ基準を明確にし、後続のコード生成の品質を高めるために、振る舞いシナリオの作成をエキスパートレベルで支援します。

このスキルが有効になる状況

• Gherkin のフィーチャーファイルやシナリオの作成またはレビューを依頼された場合
• 複雑な受け入れ基準の構成についてサポートが必要な場合
• ビジネス要件を Given／When／Then 形式に変換したい場合
• BDD の手法やシナリオ設計について質問された場合
• 複数のアクターが関与するワークフローや複数ステップのワークフローについて、振る舞い仕様を求められた場合
• Cucumber、SpecFlow、または BDD フレームワークに言及された場合
• 構造化されたシナリオが役立つ、複雑な受け入れ基準を伴う機能に取り組んでいる場合

仕組み

このスキルは、次の知識を持つ gherkin-expert エージェントに処理を委任します。

1. Gherkin の構文と慣用表現 — Feature／Scenario／Given／When／Then、Background、シナリオアウトライン、データテーブル、タグ
2. BDD の手法 — ディスカバリーワークショップ、生きたドキュメント、例による仕様化
3. シナリオ設計 — 単一の振る舞いに焦点を当てること、宣言型のスタイル、実装の詳細を避けること
4. ドメインモデリング — シナリオを通じて表現するユビキタス言語と境界づけられたコンテキスト
5. AI プロンプトの改善 — Gherkin 仕様をプロンプトのコンテキストとして使用し、コード生成の品質を高めること（実証的に検証済み：英語のみの場合より +26%）

Gherkin が効果を発揮する場面（判断が必要です）

Gherkin はツールであり、規則ではありません。状況に応じて判断してください。

適している場合：

• 多数のエッジケースを含む、複雑で複数ステップの振る舞い要件
• 複数のアクターが関与するシナリオ（ユーザーが X を行い、システムが Y を返し、管理者が Z を確認する）
• 組み合わせ条件を含むビジネスルール（シナリオアウトライン）
• ステークホルダーによる検証が必要な受け入れ基準
• 「完了状態」が英語では曖昧な機能

英語で問題ない場合：

• 振る舞いが明白な単純な CRUD 操作
• 利用者が開発者 1 人だけの内部ツール
• 設定の変更、スタイル設定、ドキュメント
• 難しいのが振る舞いの仕様化ではなくアルゴリズムの設計である要件

使用例

# 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/