AgentSkillsCN

bdd-scenario-builder

行为驱动开发 (BDD) 中定义和情景化行为的指南。使用 Given-When-Then 和 Gherkin 整理验收条件和边缘案例，包括失败模式和从小处着手的引入步骤，在用业务语言编写清晰情景时使用。

SKILL.md
--- frontmatter
name: bdd-scenario-builder
description: Behavior-Driven Development (BDD) で振る舞いを定義・シナリオ化するためのガイド。Given-When-Then と Gherkin で受け入れ条件やエッジケースを整理し、失敗パターンや小さく始める導入ステップを含めて、業務言語で明確なシナリオを書くときに使う。

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: 認識合わせを例と会話で前進させる（両立可）

追加リソース