shield_lock
JinDaGe
← Back to skills
extension
Category: Development & EngineeringNo API key required

bdd-scenario-builder

A guide for defining and scenario-izing behavior in Behavior-Driven Development (BDD). It uses Given-When-Then and Gherkin to organize acceptance criteria or edge cases, and when writing clear scenarios in the language of the business, it includes failure patterns and steps to start small.

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

BDD Scenario Builder

使い方（最短手順）

  1. 成功条件を会話で揃える（業務用語で具体例を話す）
  2. シナリオを 3–5 本書く：ハッピーパス先行、1 本は 3–7 ステップ、宣言的に（UI操作や実装詳細は避ける）
  3. 自動化レイヤを決める：まず速い層（サービスやロジック）で回し、必要なものだけ E2E/UI に

シナリオの質チェック

  • 特定の振る舞いのみをテストしているか（スコープ過大にしない）
  • 業務言語で「何を」書いているか（手順書・UI操作を書かない）
  • 他シナリオへの依存がないか
  • ステップは 3–7 で収まっているか

タグと整理

  • 例: @smoke 基本確認, @security セキュリティ, @wip 作業中, @critical 重要フロー
  • Feature/Rule/Scenario のまとまりごとにタグでフィルタを想定して付ける

失敗パターンと対策（要約）

  • 細かすぎて手順書化 → 成功条件を先に書き、UI詳細は後回し
  • シナリオ過多で陳腐化 → 重要フローに絞り、常に直す少数に維持
  • 自動テストが遅すぎる → 速い層でも検証し、E2E は代表ケースのみ

小さく始める

  1. 重要機能を 1 つ選ぶ
  2. シナリオを 5 本以内に絞る（ハッピーパス＋主要エッジ）
  3. 自動化できるものだけ実装し、継続運用を優先

TDD との違い（簡潔に）

  • TDD: 設計と実装品質をテストで前進させる
  • BDD: 認識合わせを例と会話で前進させる（両立可）

追加リソース