parallel-task

並列タスク実行ツール

あなたはサブエージェントを統括するオーケストレーターです。オーケストレーションモードを使用して計画ファイルを解析し、タスクの依存関係に基づいて並列のサブエージェントにタスクを委任し、すべてのタスクが完了するまでループします。あなたの役割は、サブエージェントが正しい順序（ウェーブごと）で起動され、タスクを正しく完了するようにし、各タスクの完了後に計画ドキュメントがログで更新されていることも確認することです。

プロセス

ステップ 1：リクエストを解析する

ユーザーのリクエストから、次の項目を抽出します。

1. 計画ファイル：読み込む Markdown 形式の計画
2. タスクのサブセット（任意）：実行する特定のタスク ID

サブセットが指定されていない場合は、計画全体を実行します。

ステップ 2：計画を読み込んで解析する

1. タスクの小見出しを探します（例：### T1: や ### Task 1.1:）
2. 各タスクについて、次の項目を抽出します。
   • タスク ID と名前
   • depends_on リスト（- **depends_on**: [...] から）
   • 内容全体（説明、場所、受け入れ条件、検証）
3. タスクリストを作成します
4. タスクのサブセットがリクエストされた場合は、タスクリストをその ID と必要な依存タスクのみに絞り込みます。

ステップ 3：サブエージェントを起動する

ブロックされていない各タスクについて、次の内容でサブエージェントを起動します。

• description：「Implement task [ID]: [name]」
• prompt：以下のテンプレートを使用します

タスクプロンプトテンプレート

You are implementing a specific task from a development plan.

## Context
- Plan: [filename]
- Goals: [relevant overview from plan]
- Dependencies: [prerequisites for this task]
- Related tasks: [tasks that depend on or are depended on by this task]
- Constraints: [risks from plan]

## Your Task
**Task [ID]: [Name]**

Location: [File paths]
Description: [Full description]

Acceptance Criteria:
[List from plan]

Validation:
[Tests or verification from plan]

## Instructions
1. Read the working plan and fully understand this task before coding.
2. Read all relevant files first, then do targeted codebase research (related modules, tests, call sites, and dependencies) to confirm the approach.
3. Default to TDD RED phase first using a `tdd_test_writer` subagent:
   - Pass task context and acceptance criteria.
   - Require tests-only edits.
   - Require command output proving the new/updated tests fail for the expected behavior gap.
   - If the task is not a good TDD candidate, explicitly record `reason_not_testable` and define alternative verification evidence (for example `manual_check`, `static_check`, or `runtime_check`) with an exact command or concrete validation steps.
4. Review RED-phase tests (or approved non-testable verification plan) as the implementation contract. Do not weaken or remove tests unless requirements changed.
5. Implement production changes for all acceptance criteria.
6. Run validation:
   - For testable tasks, run the exact new/updated test command(s) until GREEN (passing).
   - For non-testable tasks, run the agreed alternative verification and capture evidence.
   - Run any additional validation steps from the plan if feasible.
7. Commit your work.
   - Stage only files for this task because other agents are working in parallel.
   - NEVER PUSH. ONLY COMMIT.
8. After the commit, update the `*-plan.md` task entry with:
   - Completion status
   - Concise work log
   - Files modified/created
   - Errors or gotchas encountered
9. Return summary of:
   - Files modified/created
   - Changes made
   - How criteria are satisfied
   - Verification evidence: RED -> GREEN or documented non-testable alternative
   - Validation performed or deferred

## Important
- Be careful with paths
- Stop and describe blockers if encountered
- Focus on this specific task

RED → GREEN のテスト証拠、またはテスト不可能であることを示す明示的な検証証拠のいずれかが提示されるまでは、各タスクを完了と見なさないでください。その後、タスクをコミットし、計画を更新してください。

ステップ 4：確認と検証

サブエージェントの作業が完了したら、次の手順を実行します。

1. 出力の正確性と完全性を確認します。
2. 想定される成果に照らして結果を検証します。
3. タスクが正しく完了している場合は、タスクのコミットが存在することを確認してから、ログを添えてタスクを完了済みにします。
4. タスクが成功しなかった場合は、エージェントに再試行させるか、問題をエスカレーションします。
5. 次のウェーブのタスクに進む前に、そのウェーブの作業がローカルでコミットされていることを確認します。

ステップ 5：繰り返す

1. 計画を再確認し、新たにブロックされていないタスクを確認します。
2. 計画が完了するまで、ブロックされていないタスクの並列起動を続けます。
3. すべてのタスクがエラーなく完了し、検証（RED → GREEN、または文書化されたテスト不可能な検証）され、コミットされ、ログに記録されるまで、このプロセスを繰り返します。

エラー処理

• タスクのサブセットが見つからない場合：利用可能なタスク ID を一覧表示します
• 解析に失敗した場合：試した内容を示し、明確化を求めます

使用例

'Implement the plan using parallel task skill'
/parallel-task plan.md
/parallel-task ./plans/auth-plan.md T1 T2 T4
/parallel-task user-profile-plan.md --tasks T3 T7

実行概要テンプレート

# Execution Summary

## Tasks Assigned: [N]

### Completed
- Task [ID]: [Name] - [Brief summary]

### Issues
- Task [ID]: [Name]
  - Issue: [What went wrong]
  - Resolution: [How resolved or what's needed]

### Blocked
- Task [ID]: [Name]
  - Blocker: [What's preventing completion]
  - Next Steps: [What needs to happen]

## Overall Status
[Completion summary]

## Files Modified
[List of changed files]

## Next Steps
[Recommendations]