dev-run

Dev Run

Plan 内の指定範囲タスクに対し、impl → verify → debug のループを自動実行するオーケストレーションスキル。各タスクを Task サブエージェントに委託し、TaskCreate/TaskUpdate で依存関係付きの進捗管理を行う。

前提知識

dev-* スキルフロー内の位置

dev-context → dev-plan → [dev-run] → (完了)
                            ├─ impl サブエージェント (×タスク数)
                            ├─ debug サブエージェント (エラー時)
                            └─ verify サブエージェント (全タスク完了後)

引数フォーマット

/dev-run <plan-name> <from-task-id> <to-task-id>

• plan-name: 既存の Plan 名（docs/dev/plans/<plan-name>/ が存在すること）
• from-task-id: 開始タスク ID（例: "001"）
• to-task-id: 終了タスク ID（例: "005"）

サブエージェント制約（重要）

サブエージェントは Task ツールを使用できない（ネスト不可のアーキテクチャ制約）。そのため:

• コード探索は Glob/Grep/Read を直接使用する
• TodoWrite は使用しない（TaskCreate/TaskUpdate で進捗管理する）
• プロンプトに context.md を埋め込み、サブエージェントのファイル読み込みを最小化する

ワークフロー

Step 1: 事前検証とコンテキスト読み込み

1. docs/dev/context.md の存在を確認する。存在しない場合は /dev-context の実行を案内して終了する
2. docs/dev/plans/<plan-name>/ の存在を確認する。存在しない場合は /dev-plan の実行を案内して終了する
3. docs/dev/context.md を Read で読み込み、以下を抽出する:
   • テスト実行コマンド（Test Framework セクション）
   • ビルドコマンド（Build & Run セクション、あれば）
   • Lint コマンド（Build & Run セクション、あれば）
   • カバレッジ閾値（Test Framework セクションの Coverage Threshold）
4. docs/dev/plans/<plan-name>/plan.md を Read で読み込む
5. 指定範囲（from-task-id 〜 to-task-id）の全タスクファイルを Glob + Read で読み込む
6. 各タスクの status, dependencies, estimated_complexity を確認する

範囲外依存チェック

タスクファイルの dependencies に、指定範囲外のタスク ID が含まれる場合:

• そのタスクファイルを Read し、status を確認する
• status: done → 問題なし
• それ以外 → AskUserQuestion でユーザーに警告し、続行/中断を確認する

Step 2: TaskCreate で依存関係グラフ構築

2a. タスクの登録

指定範囲内で status が done でないタスクごとに TaskCreate を実行する:

TaskCreate:
  subject: "impl-NNN: <タスクタイトル>"
  description: "Plan <plan-name> のタスク NNN を TDD 実装する"
  activeForm: "Implementing task NNN: <タスクタイトル>"

2b. 依存関係の設定

タスクファイルの dependencies を TaskUpdate の addBlockedBy にマッピングする。

ID マッピングテーブルを構築: {"001": "<TaskCreate_ID>", "002": "<TaskCreate_ID>", ...}

• 範囲内の依存: 対応する TaskCreate ID を blockedBy に設定
• 範囲外の依存（done 済み）: blockedBy から除外
• status: done のタスク: TaskCreate しない、依存元からも除外