| name | dev:story |
| description | ストーリーからTDD/E2E/TASK分岐付きタスクリスト（task-list.json）を生成。
ストーリー駆動開発の起点となるスキル。
「タスクを作成」「/dev:story」で起動。
Trigger:
タスクを作成, ストーリーからタスク, /dev:story, story to tasks
|
| context | fork |
| allowed-tools | ["Read","Write","Edit","Bash","Glob","Grep","Task","AskUserQuestion"] |
ストーリー → タスク生成（dev:story）
出力先
docs/FEATURES/{feature-slug}/{YYMMDD}_{story-slug}/ に2ファイルを順次保存する。
★ 実行手順（必ずこの順序で実行）
Step 1: ストーリー分析 → story-analysis.json
- plan.json チェック（dev:epic 連携）:
- ユーザーが feature-slug を指定 or 引数で渡している場合 →
docs/FEATURES/{feature-slug}/plan.json を Read
- plan.json が存在する場合:
a. feature-slug は確定済み → 手順3の resolve-slug の feature 部分をスキップ
b. plan.json の stories 配列から
executionType: "developing" かつ未完了のストーリーを phase 順で AskUserQuestion に選択肢提示
c. 選択された story のフィールド（description, acceptanceCriteria, affectedFiles, testImpact, technicalNotes, referenceImplementation）を $STORY_PLAN として保持し、手順2の分析のコンテキストとして使う
d. story-slug は plan.json の slug を使用 → 手順3の resolve-slug の story 部分もスキップ可
- plan.json が存在しない場合 → 従来通り手順1から実行
- ユーザーからストーリーを聞き取る
- references/analyze-story.md を参照し、ストーリーを分析して story-analysis.json の内容を構成する
- → Task（haiku） に委譲（agents/resolve-slug.md）— 既存slugとの類似判定・候補整理
- AskUserQuestion で feature-slug / story-slug を確定（resolve-slugの推奨順で選択肢提示）
- ワークスペース初期化スクリプトを実行（
YYMMDD 日付付きディレクトリが作成される）:
bash .claude/skills/dev/story/scripts/init-story-workspace.sh {feature-slug} {story-slug}
出力の docs/FEATURES/{feature-slug}/{YYMMDD}_{story-slug} を以降のパスとして使用する。
- Write で
story-analysis.json を保存
ゲート: story-analysis.json が存在しなければ次に進まない。
Step 2a: タスク分解（decomposition プロセス）
.claude/commands/dev/decomposition.md を Read し、以下のプロセスに従ってタスク分解する:
- ステップ1（コードベース探索）: story-analysis.json のスコープ、
$STORY_PLAN の affectedFiles を起点に探索
- ステップ3（不明点インタビュー）: AskUserQuestion で技術選定・方針を確認
- ステップ4-5（詳細Todo作成）: 各タスクが単独で実行可能な情報量を持つことを保証
Step 2b: task-list.json 変換 + ワークフロー分類
references/decompose-tasks.md を参照し、Step 2a の分解結果を task-list.json に変換する:
- 各タスクに
workflow（tdd/e2e/task）を付与
context セクションにコード探索結果を記録- planPath 設定: plan.json が存在する場合（dev:epic 連携時）、
context.planPath に docs/FEATURES/{feature-slug}/PLAN.md のパスを設定する
- Write で
task-list.json を保存
ゲート: task-list.json が存在しなければ次に進まない。
Step 3: 計画レビュー（OpenCode）
- → Task（sonnet） に委譲（agents/plan-review.md）
- OpenCode CLIを使用してtask-list.jsonのタスク分解をレビュー
- タスク粒度、依存関係、ワークフロー分類、漏れ、リスクを検証
$STORY_PLAN が存在する場合、plan-review のプロンプトに追加コンテキストとして渡す（acceptanceCriteria との整合性チェックに使用）
- レビュー結果をユーザーに提示
- 修正が必要なら Step 2 に戻る
ゲート: OpenCodeレビューが完了しなければ次に進まない。
Step 4: ユーザー確認
- 実装開始 → dev:developing を呼び出し
- 修正が必要 → ユーザー指示に従いtask-list.jsonを修正 → Step 3から再実行
完了条件
以下2ファイルがすべて保存されていること:
| ファイル | Phase |
|---|
story-analysis.json | Step 1 |
task-list.json | Step 2 |
- 各タスクに
workflow フィールド（tdd/e2e/task）が付与されている
- ユーザーが承認済み
参照
- agents/: resolve-slug.md, plan-review.md
- references/: analyze-story.md, decompose-tasks.md, tdd-criteria.md, e2e-criteria.md, task-criteria.md
- ルール:
.claude/rules/workflow/workflow-branching.md（自動適用）
