本文へ移動
cccskills
無料GitHub で公開

dev:story

ストーリーからTDD/E2E/TASK分岐付きタスクリスト(task-list.json)を生成。 ストーリー駆動開発の起点となるスキル。 「タスクを作成」「/dev:story」で起動。 Trigger: タスクを作成, ストーリーからタスク, /dev:story, story to tasks

インストール方法を見る

含まれるファイル(11)

  • SKILL.md4.9 KB
  • agents/plan-review.md4.9 KB
  • agents/resolve-slug.md1.8 KB
  • references/analyze-story.md2.8 KB
  • references/decompose-tasks.md3.6 KB
  • references/e2e-criteria.md2.3 KB
  • references/task-criteria.md2.7 KB
  • references/tdd-criteria.md2.0 KB
  • references/templates/story-analysis.template.json227 B
  • references/templates/task-list.template.json302 B
  • scripts/init-story-workspace.sh895 B

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

ストーリー → タスク生成(dev:story)

出力先

docs/FEATURES/{feature-slug}/{YYMMDD}_{story-slug}/ に2ファイルを順次保存する。


★ 実行手順(必ずこの順序で実行)

Step 1: ストーリー分析 → story-analysis.json

  1. 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から実行
  2. ユーザーからストーリーを聞き取る
  3. references/analyze-story.md を参照し、ストーリーを分析して story-analysis.json の内容を構成する
  4. → Task(haiku) に委譲(agents/resolve-slug.md)— 既存slugとの類似判定・候補整理
  5. AskUserQuestion で feature-slug / story-slug を確定(resolve-slugの推奨順で選択肢提示)
  6. ワークスペース初期化スクリプトを実行(YYMMDD 日付付きディレクトリが作成される):
    bash .claude/skills/dev/story/scripts/init-story-workspace.sh {feature-slug} {story-slug}
    
    出力の docs/FEATURES/{feature-slug}/{YYMMDD}_{story-slug} を以降のパスとして使用する。
  7. 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 に変換する:

  1. 各タスクに workflow(tdd/e2e/task)を付与
  2. context セクションにコード探索結果を記録
  3. planPath 設定: plan.json が存在する場合(dev:epic 連携時)、context.planPath に docs/FEATURES/{feature-slug}/PLAN.md のパスを設定する
  4. Write で task-list.json を保存

ゲート: task-list.json が存在しなければ次に進まない。

Step 3: 計画レビュー(OpenCode)

  1. → Task(sonnet) に委譲(agents/plan-review.md)
    • OpenCode CLIを使用してtask-list.jsonのタスク分解をレビュー
    • タスク粒度、依存関係、ワークフロー分類、漏れ、リスクを検証
    • $STORY_PLAN が存在する場合、plan-review のプロンプトに追加コンテキストとして渡す(acceptanceCriteria との整合性チェックに使用)
  2. レビュー結果をユーザーに提示
  3. 修正が必要なら Step 2 に戻る

ゲート: OpenCodeレビューが完了しなければ次に進まない。

Step 4: ユーザー確認

  • 実装開始 → dev:developing を呼び出し
  • 修正が必要 → ユーザー指示に従いtask-list.jsonを修正 → Step 3から再実行

完了条件

以下2ファイルがすべて保存されていること:

ファイルPhase
story-analysis.jsonStep 1
task-list.jsonStep 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(自動適用)

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Rebuild a degraded AI image to remove crunchy textures and repeated-edit artifacts while preserving identity, style, and composition. Use for clean remakes, not ordinary retouching or upscaling.

日本語の概要は準備中です。原文の説明を表示しています。

ryryo/dot-claude-dev32026年10月10日 更新

analyze-seminar-video

無料日本語概要

セミナー・講義・ウェビナー・研修・実演動画をローカルで文字起こしし、内容を分析して、必要なスライド画像や動画クリップ付きのHTML/Markdown資料を作る。動画から学習資料・実践ガイドを作りたい場合に使う。映像作品の再現設計やCanvas生成は対象外。

ryryo/dot-claude-dev32026年10月10日 更新

architecture-refactor-loop

無料日本語概要

責務・依存方向・状態や副作用の境界を監査し、既存挙動を保って段階的にリファクタリングする。read-only監査にも対応する。

ryryo/dot-claude-dev32026年10月10日 更新

astra-rules-refactor

無料日本語概要

AGENTS.mdや既存スキルをGPT-6 Astra向けに監査・整理するときに使う。契約と意図的な他モデル委譲を保ち、重複、過剰な手順、曖昧な停止条件を修正する。

ryryo/dot-claude-dev32026年10月10日 更新

character-sheet-imagegen

無料日本語概要

人物の参照写真から、同一性を保った複数アングルのキャラクターシートを生成・修正する。指定された身だしなみや撮影表現も整える。

ryryo/dot-claude-dev32026年10月10日 更新

character-to-codex-pet

無料日本語概要

既存キャラクター画像を、承認制でピクセルアートの正準画像へ変換し、3状態パイロット、クロマ前処理、状態間ジオメトリ検証、9状態生成、遷移QA、仮配置、アプリ内確認、ロールバック可能な正式配置まで行う。キャラクターからCodexペットを作る依頼に加え、ジャンプで小さくなる、状態ごとに身長が変わる、足元が跳ねる、クロマ縁が出る、アニメーションを修復したい依頼で使用する。

ryryo/dot-claude-dev32026年10月10日 更新

ryryo のスキルをすべて見る

このスキルの問題を報告する