decompose-stories

decompose-stories

要件をEpic > Story > Task（チェックリスト）の階層に分解し、Markdown構造として出力するスキル。

階層モデル

階層	役割	ポイント	ファイル
Epic	プロジェクトとしてStoryを束ねる	Story合計（上限なし）	docs/plans/<epic>.md
Story	見積もり対象。13pt以上は分割推奨	フィボナッチ	docs/plans/stories/<story>.md
Task	Story内の実装ステップ	見積もりしない	Story md内のチェックリスト

実行手順

1. 入力ソースの特定

引数または対話で以下のいずれかを取得する:

• チャットで記述された要件テキスト
• Markdownファイルパス（Read で読み込む）
• GitHub Issue URL（WebFetch、または Bash で gh issue view を実行）
• Notion ページURL（Notion MCPツールが利用可能な場合のみ動的に呼び出す。利用不可ならWebFetchで代替）
• その他URL（WebFetch）

利用可能なMCPツールは現セッションのツール一覧から判定する。 入力ソースが不明確な場合は AskUserQuestion で確認する。

2. Epicの輪郭抽出

入力から以下を抽出する:

• Epicタイトル（簡潔に1行）
• 解決する課題・ビジネス価値
• スコープ・スコープ外
• 想定アクター/ユーザー
• 主要ユースケース（最低1つ）
• インセプションデッキ項目（埋まる範囲で）

不足情報は AskUserQuestion で補う。すべてを埋める必要はなく、判明している範囲で進める。

3. Storyへの分割

Epic を Story に分解する。各Storyは以下を満たすこと:

• 単独でレビュー・リリース可能な単位
• 受け入れ基準（Acceptance Criteria）が明確
• 概ね1〜13ptに収まる規模感（13pt以上が予想されるなら分割を検討）
• 他Storyへの依存が明示できる

各Storyに対して:

• ID: S-001, S-002 形式（または kebab-case の短縮タイトル）
• タイトル
• 背景・目的
• 受け入れ基準（3-5項目）
• 仮タスク（チェックリスト形式、3-7項目）
• 想定される依存関係

4. Taskチェックリストの生成

各Story内に実装ステップをチェックリスト（- [ ]）として記載する。 Taskは見積もり対象ではないため、目的は実装の漏れ防止。

• 最低限「テスト追加」「ドキュメント更新」を含める
• 過度に細分化しない（1Storyあたり3-7項目目安）

5. ファイル出力

設定ファイル（.claude/planning-skills.local.md）の output セクションを参照して 出力先ディレクトリを決定する（デフォルト: docs/plans, docs/plans/stories）。

• Epic: docs/plans/<epic-id>.md を ${CLAUDE_PLUGIN_ROOT}/templates/epic.md から生成
• Story: docs/plans/stories/<story-id>.md を ${CLAUDE_PLUGIN_ROOT}/templates/story.md から生成

各ファイルのYAMLフロントマターを以下で初期化する:

• Epic: status=planning, total_points=0（後で estimate-points が更新）
• Story: status=planning, points=0, estimation_mode=未定

Epicの「Story一覧」セクションと「依存関係図（Mermaid）」を自動生成する。

6. 次のステップ案内

完成したファイルパス一覧と次のスキル候補を提示する:

• /planning-skills:setup-baseline（基準点未設定の場合）
• /planning-skills:estimate-points（見積もりに進む場合）
• /planning-skills:identify-risks（リスク識別を先に行う場合）

注意事項

• ユーザーストーリー形式（"〜として、〜したい、なぜなら〜"）に厳密に従う必要はない
• Epic IDは入力から自然に決められない場合は kebab-case で要約してユーザーに提案する
• 既存の同名Epic mdが存在する場合、上書きせずユーザーに確認する
• 出力ディレクトリが存在しない場合は作成する
• 入力が断片的でもStoryを生成できるが、不確実性が高い場合は明示的にユーザーに伝える