Agent skill

bdd-scenario-builder

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

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/yurake/skills/tree/main/dev/bdd-scenario-builder

SKILL.md

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

追加リソース

  • 詳細例: references/examples.md
  • 失敗パターン詳細: references/pitfalls.md
  • 定義と出典: references/intro.md
  • コピペ用テンプレ: assets/gherkin-template.feature

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

yurake/skills

issue-create

GitHub Issue を作成する手順。依頼を受けたとき、.github/ISSUE_TEMPLATE の内容に応じてテンプレを選び、必須項目を埋めて GitHub MCP（issue_write/create）で Issue を作成する。

0 0
Explore
yurake/skills

ci-fail-followup

PR 作成後に .github/workflows/ci.yml が失敗したときの対応手順。ローカルで pytest 全ケースを実行し、エラー有無で分岐。エラーがあれば修正して commit-push スキルでコミット・プッシュ、無ければ GitHub Actions のログを確認して原因を特定する。

0 0
Explore
yurake/skills

review-rules

セッションの会話から恒久的な振る舞いルールを抽出し、AGENTS.md と突き合わせて追加すべきものを提示する。出力は rules と agents_md_patch の二部構成。

0 0
Explore
yurake/skills

pr-create

PR 作成手順を自動化するためのガイド。依頼を受けたとき、または 参照しているTODOファイル の「PR 作成」以外が完了したタイミングでタイトル・本文整形、テンプレ適用、MCP での PR 作成を行う。

0 0
Explore
yurake/skills

architecture-patterns

Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use when architecting complex backend systems or refactoring existing applications for better maintainability.

0 0
Explore
yurake/skills

test-risk-analyzer

あらゆる言語/スタックで潜在バグリスクを洗い出し、追加すべきテストケースを提案する。未テストのエッジケース探索や安全性確認、カバレッジ強化のテスト案提示を求められたときに使用する。

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results