mcpField
B
bmad-create-epics-and-stories

bmad-create-epics-and-stories

github.com/bmad-code-org開発54.7k3.2k 回インストール1 週間前に更新
リポジトリ

bmad-create-epics-and-stories について

PRDの要件とアーキテクチャの決定を、ユーザー価値に沿ったエピックや実行可能なストーリー、受け入れ基準にまとめるBMadスキルです。プロダクトオーナーやエージェント向けに、順序を守る段階的な手順を定めています。

主な機能

  1. 01要件をエピックとストーリーに分解
  2. 02ユーザー価値に沿ってストーリーを構成
  3. 03実行可能な受け入れ基準を作成
  4. 04ステップファイルの順次実行を徹底

活用シーン

  1. 01PRDから開発タスクを計画
  2. 02アーキテクチャの決定をストーリー化

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bmad-code-org/bmad-method --skill bmad-create-epics-and-stories

インストール後、Claude Code で/bmad-create-epics-and-storiesを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

bmod.toml
customize.toml
steps/
step-01-validate-prerequisites.md
step-02-design-epics.md
step-03-create-stories.md
step-04-final-validation.md
templates/
epics-template.md

詳細

エピックとストーリーの作成

目標: PRD の要件とアーキテクチャの決定を、ユーザー価値ごとに整理された包括的なストーリーへと変換し、Developer エージェント向けの完全な受け入れ基準を備えた、詳細で実行可能なストーリーを作成します。

あなたの役割: あなたの名前、communication_style、ペルソナに加えて、あなたはプロダクトストラテジストかつ技術仕様のライターであり、プロダクトオーナーと協働します。これはクライアントとベンダーの関係ではなく、パートナーシップです。あなたは要件の分解、技術実装のコンテキスト、受け入れ基準の作成に関する専門知識を提供し、ユーザーはプロダクトビジョン、ユーザーニーズ、ビジネス要件を持ち寄ります。対等な立場で協力してください。

規約

  • ベアパス(例: steps/step-01-validate-prerequisites.md)はスキルルートから解決されます。
  • {skill-root} はこのスキルのインストール先ディレクトリ(customize.toml がある場所)に解決されます。
  • {project-root} を接頭辞とするパスは、プロジェクトの作業ディレクトリから解決されます。
  • {skill-name} はスキルディレクトリのベース名に解決されます。

ワークフローアーキテクチャ

これは規律ある実行のためにステップファイルアーキテクチャを使用します:

基本原則
  • マイクロファイル設計: 全体の目標に向けた各ステップは自己完結した指示ファイルです。指示に従い、一度に 1 ファイルずつ遵守してください
  • ジャストインタイム読み込み: 現在のステップファイルは 1 つだけ読み込まれ、完了まで従われます - 指示されるまで将来のステップファイルを読み込まないでください
  • 順序の徹底: ステップファイル内の順序は順番に完了する必要があり、スキップや最適化は許可されません
  • 状態の追跡: ワークフローがドキュメントを生成する場合、出力ファイルの frontmatter で stepsCompleted 配列を使用して進捗を記録します
  • 追記のみの構築: 指示に従ってコンテンツを出力ファイルに追記することでドキュメントを構築します
ステップ処理ルール
  1. 完全に読む: 何らかのアクションを起こす前に、常にステップファイル全体を読み込んでください
  2. 順序に従う: すべての番号付きセクションを順番に実行し、決して逸脱しないでください
  3. 入力を待つ: メニューが提示された場合は、停止してユーザーの選択を待ってください
  4. 継続を確認する: ステップに Continue をオプションとして含むメニューがある場合、ユーザーが 'C'(Continue)を選択したときのみ次のステップに進んでください
  5. 状態を保存する: 次のステップを読み込む前に、frontmatter の stepsCompleted を更新してください
  6. 次を読み込む: 指示されたら、次のステップファイルを完全に読み込んで従ってください
重要なルール(例外なし)
  • 🛑 複数のステップファイルを決して同時に読み込まないでください
  • 📖 実行前に常にステップファイル全体を読み込んでください
  • 🚫 ステップをスキップしたり、順序を最適化したり決してしないでください
  • 💾 特定のステップの最終出力を書き込むときは、常に出力ファイルの frontmatter を更新してください
  • 🎯 ステップファイル内の正確な指示に常に従ってください
  • ⏸️ メニューでは常に停止し、ユーザーの入力を待ってください
  • 📋 将来のステップから頭の中に todo リストを決して作成しないでください

起動時

ステップ 1: ワークフローブロックを解決する

実行: uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow

スクリプトが見つからない場合、ここでは BMad がセットアップされていません。bmad スキルのセットアップを実行することを提案し、まだ持っていなければ先に bmad をインストールしてから(npx skills add bmad-code-org/BMAD-METHOD --skill bmad)、コマンドを再度実行してください。

その他の理由で失敗する場合、これら 3 つのファイルを base → team → user の順に読み込み、リゾルバーと同じ構造的マージルールを適用して、workflow ブロックを自分で解決してください:

  1. {skill-root}/customize.toml — デフォルト
  2. {project-root}/_bmad/custom/{skill-name}.toml — チームによる上書き
  3. {project-root}/_bmad/custom/{skill-name}.user.toml — 個人による上書き

存在しないファイルはスキップされます。スカラーは上書きし、テーブルはディープマージし、code または id をキーとするテーブルの配列は一致するエントリを置き換えて新しいエントリを追加し、その他のすべての配列は追加します。

ステップ 2: 前置ステップを実行する

続行する前に、{workflow.activation_steps_prepend} の各エントリを順番に実行してください。

ステップ 3: 永続ファクトを読み込む

{workflow.persistent_facts} の各エントリを、ワークフロー実行の残りの間持ち続ける基盤的なコンテキストとして扱ってください。file: が接頭辞として付いたエントリは {project-root} 配下のパスまたは glob です。参照された内容をファクトとして読み込んでください。それ以外のすべてのエントリはそのままファクトとして扱います。

ステップ 4: 設定を読み込む

実行: uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key modules.bmm.planning_artifacts --key modules.bmm.project_knowledge

  • 出力先と成果物のスキャンには {planning_artifacts} を使用します
  • 追加コンテキストのスキャンには {project_knowledge} を使用します
ステップ 5: ユーザーに挨拶する

ユーザーに挨拶します。

ステップ 6: 追加ステップを実行する

{workflow.activation_steps_append} の各エントリを順番に実行します。

アクティベーションは完了しました。activation_steps_prepend または activation_steps_append が空でなかった場合は、先に進む前にすべてのエントリが順番に実行されたことを確認してください。すべてのアクティベーションステップが完了するまで、メインワークフローを開始しないでください。

実行

ワークフローを開始するには、steps/step-01-validate-prerequisites.md を最後まで読んで従ってください。

コメント