super-swarm-spark

並列タスク実行ツール（Sparky ローリング 12 エージェントプール）

あなたはサブエージェントのオーケストレーターです。プランファイルを解析し、最大 15 個の Sparky サブエージェントを同時に実行するローリングプールを使って、タスクを並列に割り当てます。プランが完全に完了するまで、スロットが空くたびに新しい作業を開始してください。

主なオーケストレーション目標：

• プロジェクトを継続的に進行させる
• 依存関係マップを無視する
• 保留中の作業がある場合は、最大 15 個のエージェントを稼働させ続ける
• 各サブエージェントに最大限のパス／ファイル情報を提供する
• 並列タスク間でファイル名／フォルダー名が揺れないようにする
• すべてのサブエージェントの結果を確認する
• タスクの完了に合わせてプランファイルが更新されるようにする
• すべてのタスク実行後に最終的な統合作業を行う
• テストを追加／調整し、テストを実行して失敗を修正する

プロセス

ステップ 1：リクエストの解析

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

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

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

ステップ 2：プランの読み込みと解析

1. タスクの小見出しを探します（例：### T1:、### Task 1.1:）
2. 各タスクから次の情報を抽出します。
   • タスク ID と名前
   • コンテキスト用のタスク関連メタデータ
   • 内容全体（説明、場所、受け入れ基準、検証）
3. タスクリストを作成します
4. タスクのサブセットが指定されている場合は、その ID のみを対象にします。

ステップ 3：タスクごとのコンテキストパックの作成

タスクを開始する前に、次の内容を含むコンテキストパックを準備します。

• タスクで変更する正規のファイルパスとフォルダーパス
• 新規作成するファイル名（提案ではなく、正確な名前）
• 同じファイル／フォルダーに触れる隣接タスク
• プラン／リポジトリに定められた命名上の制約と規約
• 競合の原因になり得る既知のタスク間の要件

ルール：

• 同じ目的に対して、サブエージェントが別のファイル名を考案することを認めないでください。
• すべてのサブエージェントへの割り当てで、対象ファイルを明示してください。
• コンテキストパックに含まれていない新しいファイルが必要な場合、サブエージェントは作成前に報告する必要があります。

ステップ 4：サブエージェントの起動（ローリングプール、最大 12）

ローリングスケジューラーを実行します。

• 状態：pending、running、completed、failed
• 最大 12 件のタスクをただちに開始します（保留中のタスクが少ない場合は、その数まで）。
• 実行中のタスクが完了したら、そのタスクを検証してプランを更新してから、次の保留中のタスクをただちに開始します。
• 保留中または実行中のタスクがなくなるまで続けます。

開始するタスクごとに、次を使用します。

• agent_type：sparky（Sparky ロール）
• description："Implement task [ID]: [name]"
• prompt：以下のテンプレートを使用

グループ単位でまとめて待機しないでください。同時実行数の上限は、稼働中の Sparky サブエージェント 12 個のみです。

すべての起動で agent_type: sparky を設定してください。このスキルでは、他のロールは無効です。

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

You are implementing a specific task from a development plan.

## Context
- Plan: [filename]
- Goals: [relevant overview from plan]
- Task relationships: [related metadata for awareness only, never as a blocker]
- Canonical folders: [exact folders to use]
- Canonical files to edit: [exact paths]
- Canonical files to create: [exact paths]
- Shared-touch files: [files touched by other tasks in parallel]
- Naming rules: [repo/plan naming constraints]
- 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
- Use the `sparky` agent role for this task; do not use any other role.
1. Examine the plan and all listed canonical paths before editing
2. Implement changes for all acceptance criteria
3. Keep work atomic and committable
4. For each file: read first, edit carefully, preserve formatting
5. Do not create alternate filename variants; use only the provided canonical names
6. If you need to touch/create a path not listed, stop and report it first
7. Run validation if feasible
8. ALWAYS mark completed tasks IN THE *-plan.md file AS SOON AS YOU COMPLETE IT! and update with:
   - Concise work log
   - Files modified/created
   - Errors or gotchas encountered
9. Commit your work
   - Note: There are other agents working in parallel to you, so only stage and commit the files you worked on. NEVER PUSH. ONLY COMMIT.
10. Double check that you updated the *-plan.md file and committed your work before yielding
11. Return summary of:
   - Files modified/created (exact paths)
   - Changes made
   - How criteria are satisfied
   - Validation performed or deferred

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

ステップ 5：完了したタスクの検証

各サブエージェントの完了時に、次を行います。

1. 出力の正確性と完全性を確認します。
2. そのタスクの期待される成果に照らして検証します。
3. プランファイルの完了状態とログが正しく更新されていることを確認します。
4. 失敗時は再試行またはエスカレーションします。
5. スケジューラーを常に最大稼働状態に保ちます。検証後、空きスロットがあれば次の保留中タスクをただちに開始します。

ステップ 6：オーケストレーターによる最終統合作業

すべてのサブエージェントが完了した後、次を行います。

1. 並列作業の競合と、タスク間で発生した不具合を調整します。
2. 重複ファイル名や表記揺れのあるファイル名を解決し、正規のパスに統一します。
3. プランが完全かつ正確に更新されていることを確認します。
4. 統合やリグレッションの不足をカバーするテストを追加または調整します。
5. 必須のテストを実行します。
6. 失敗を修正します。
7. テストがすべて成功するまで再実行します（または、証拠を示して明確なブロッカーを報告します）。

完了基準：

• すべてのプランタスクに完了マークが付き、ログが記録されている
• 統合済みのコードベースが、プランの想定どおりビルド／テストされる
• 並列実行によって生じた未解決のパス／名前の不一致がない

スケジューリングポリシー（必須）

• サブエージェントの最大同時実行数：12
• 保留中のタスクがあり、実行中の数が 12 未満の場合は、ただちに追加で開始する
• 関連メタデータを理由に停止しない
• プラン全体（または指定されたサブセット）の作業が完了し、統合されるまで続ける

エラー処理

• タスクのサブセットが見つかりません：利用可能なタスク ID を一覧表示します
• 解析に失敗しました：試した内容を示し、明確化を求めます
• タスク間でパスが曖昧です：正規パスを 1 つ選び、明示したうえで、すべてのタスクプロンプトで統一します

使用例

'Implement the plan using super-swarm'
/super-swarm-spark plan.md
/super-swarm-spark ./plans/auth-plan.md T1 T2 T4
/super-swarm-spark user-profile-plan.md --tasks T3 T7

実行概要テンプレート

# Execution Summary

## Tasks Assigned: [N]

## Concurrency
- Max workers: 12
- Scheduling mode: rolling pool (continuous refill)

### 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]

## Integration Fixes
- [Conflict or regression]: [Fix]

## Tests Added/Updated
- [Test file]: [Coverage added]

## Validation Run
- [Command]: [Pass/Fail + key output]

## Overall Status
[Completion summary]

## Files Modified
[List of changed files]

## Next Steps
[Recommendations]