codex-multi-agent
A framework for decomposing tasks, delegating to specialized agents, and integrating results.
Install
mkdir -p .claude/skills/codex-multi-agent && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/18903" && unzip -o skill.zip -d .claude/skills/codex-multi-agent && rm skill.zipInstalls to .claude/skills/codex-multi-agent
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
マルチエージェントでタスク分解・委譲・並列実行・結果統合を行うための共通運用スキル。Use when: 「マルチエージェントで進めたい」「並列で進めたい」「サブエージェントに任せたい」「複数 agent で調査/実装/レビューしたい」。Claude Code / Codex のどちらでも使える共通原則を定義し、末尾にツール別の読み替えを置く。Key capabilities
- →Delegate specific tasks to sub-agents
- →Decompose large tasks into smaller, independent units
- →Parallelize research and implementation efforts
- →Integrate results from multiple agents
- →Assign roles like planner, researcher, or developer
- →Determine team size based on task complexity
How it works
The skill defines common operating rules for multi-agent systems, focusing on criteria for task delegation, decomposition, parallelization, and result integration. It guides the primary agent in structuring work for sub-agents.
Inputs & outputs
When to use codex-multi-agent
- →Parallelizing research and implementation
- →Managing multi-agent projects
- →Delegating testing or documentation tasks
About this skill
Multi-Agent Operating Guide
複数 agent を使って作業するときの共通運用ルール。
このスキルの中心はツール依存の操作手順ではなく、次の判断基準にある。
- いつ委譲するか
- どう分割するか
- 何を並列化してよいか
- 主担当がどう統合するか
Iron Law
今すぐ主担当が自分でやるべき作業は委譲しない
- 直後の意思決定に必要な調査や編集は主担当が自分で行う
- サブエージェントには、独立して進められる具体的なタスクだけを渡す
- 委譲は目的ではなく手段である。分割すると遅くなるなら分割しない
使う場面
- 実装と調査を並列で進めたい
- フロントエンド / バックエンド / テストを役割分担したい
- 読み取り専用の影響調査を別 agent に切り出したい
- レビューや検証を独立した agent に任せたい
- 大きなタスクを分割して、最後に主担当が統合したい
使わない場面
- 単純な 1 ファイル修正
- すぐに主担当が判断すべき設計変更
- 強く結合した変更で、分割すると手戻りが増える場合
- 「とりあえず並列化したい」だけで、独立タスクがない場合
Step 1: 主担当が先に決める
委譲前に、主担当が以下を自分で確定する。
- ユーザー要求の要約
- クリティカルパスの特定
- 並列化できる独立タスクの抽出
- 自分が今すぐ着手する作業の決定
ここが曖昧なまま委譲しない。
Step 2: タスクを分解する
サブエージェントに渡すタスクは、次の条件を満たすものだけにする。
- 入力が明確
- 完了条件が明確
- 変更範囲または責務が明確
- 主担当の直後の作業をブロックしない
良い例:
- 「
app/admin配下でこの UI に関係する既存パターンを 3 点探して報告する」 - 「Laravel 側の既存 API とテスト配置を調査し、変更候補ファイルを列挙する」
- 「この 2 ファイルだけを担当して型エラーを直す」
悪い例:
- 「いい感じに全部進めて」
- 「必要そうなものを全部見て実装して」
- 「まず調べて、必要なら設計して、実装して、レビューして」
Step 3: 役割を選ぶ
まず役割で考え、ツールごとの agent 名は後で割り当てる。
| 役割 | 使いどころ |
|---|---|
| planner | 要件整理、タスク分解、依存関係整理 |
| researcher | 既存コード調査、影響範囲調査、読み取り専用分析 |
| frontend-dev | UI / コンポーネント実装 |
| backend-dev | API / ドメイン / リポジトリ実装 |
| database | DB スキーマ、マイグレーション設計 |
| tester | テスト設計、テスト追加、検証観点整理 |
| debugger | 不具合原因調査、再現条件の切り分け |
| reviewer | セキュリティ、性能、品質レビュー |
| docs | ドキュメント整備 |
| ops | Docker / CI / インフラ運用作業 |
迷ったら:
- 調査は
researcher - 実装は該当ドメインの
*-dev - テストは
tester - 計画は
planner
Step 4: チーム規模を決める
必要最小人数で始める。人数を増やす基準は「仕事量」ではなく、独立した責務があるかどうか。
ここでの人数は、主担当 を含む総人数の目安を指す。
reviewer は抽象ロールであり、必要に応じて 1 agent でも複数 agent でもよい。ツール別の実体への割り当ては末尾の Tool Mapping を使う。
- 小規模（2-3 agent）: 調査 + 実装、単機能修正、局所的なレビュー
- 中規模（3-4 agent）:
frontend-dev/backend-dev/testerの並列、または調査 + 実装 + レビュー - 大規模（4-5 agent）:
plannerを含めた設計整理、複数レイヤーの実装、独立レビューの同時進行
増やしすぎの兆候:
- 各 agent の担当範囲を 1 行で説明できない
- 同じファイルや同じ意思決定を複数 agent が共有している
- 主担当が統合よりも調整に時間を取られている
迷ったら、1 段階小さい規模から始める。
Step 5: 並列化の判断
並列化してよいのは、互いに独立していて、成果物の衝突が小さいタスクだけ。
並列化しやすい組み合わせ
researcherに調査を任せつつ、主担当が別の読み取りや軽い実装を進めるbackend-devとfrontend-devが API 契約済みの範囲で並列実装する- 実装と
testerのテスト観点整理を並列で進める - 実装後に
reviewerへ独立レビューを出す
並列化しにくい組み合わせ
- 同じファイルを複数 agent が触る
- API 仕様未確定のまま frontend / backend を同時着手する
- 設計未確定のまま複数 worker に実装させる
Step 6: 委譲プロンプトの作り方
各 agent には、最低限以下を渡す。
目的:
- 何のための作業か
担当範囲:
- 読み取りだけか、編集ありか
- 対象ファイル/モジュール
完了条件:
- 何を返したら完了か
制約:
- 既存パターン準拠
- 触ってよい範囲
- 他 agent の変更を巻き戻さない
コード変更を任せる場合は、担当ファイルを明示する。
あなたの担当:
- `app/admin/src/...`
- `packages/shared-components/...`
注意:
- あなたは単独作業ではない
- 他者の変更を revert しない
- 変更したファイルパスを最後に列挙する
Step 7: 運用ルール
- 具体的で自己完結した依頼だけを渡す
- 書き込み担当のスコープを明示する
- 同じ未解決タスクを重複委譲しない
- 既存 agent を再利用するのは、その文脈が活きるときだけ
- 待機を増やさず、待ち時間は主担当が別作業を進める
- 結果統合後、不要になった agent は閉じるか運用上の完了状態にする
推奨パターン
1. 調査 + 実装
主担当:
- クリティカルパスの実装を開始
researcher:
- 既存パターン、影響範囲、変更候補を調査
2. フルスタック並列
planner:
- 変更単位と依存関係を整理
backend-dev:
- API / UseCase / Repository を担当
frontend-dev:
- API 契約に基づく UI 実装を担当
tester:
- 受け入れ条件に沿ったテスト観点を整理
3. 実装 + 並列レビュー
主担当または implementation owner:
- 実装を完了
reviewer:
- セキュリティ / パフォーマンス / テスト不足を確認
出力フォーマット
必要に応じて、委譲前に次を短く整理してから実行する。
チーム構成
| 役割 | 担当 | スコープ |
|---|---|---|
| planner | 依存整理 | 計画のみ |
| backend-dev | API 実装 | バックエンド |
| frontend-dev | UI 実装 | フロントエンド |
| tester | テスト観点整理 | テストのみ |
依存関係
Task A: API 契約確定
Task B: バックエンド実装
Task C: フロントエンド実装
Task D: テスト確認
A → B
A → C
B, C → D
統合時のルール
- サブエージェントの結果を鵜呑みにせず、主担当が最終判断する
- 競合や設計不整合は主担当が解消する
- 最終報告は、誰が何を担当したかではなく、ユーザー成果を中心にまとめる
アンチパターン
- 主担当が空になり、待機ばかりする
- 曖昧な依頼を複数 agent に投げる
- 直列で十分な作業まで無理に並列化する
- 同一ファイルを複数 worker に触らせる
- レビュー結果を統合せず、そのまま羅列する
Tool Mapping: Codex
Codex では、役割を次のように割り当てる。
| 役割 | Codex の agent |
|---|---|
| planner | project_planner |
| researcher | explorer_agent |
| docs | documentation_writer |
| skill-design | skill_designer |
| conductor | workflow_conductor |
| orchestrator | orchestrator |
上記は PlanGate フレームワークの標準構成。 プロジェクト固有の specialist agent（frontend, backend, tester 等）は導入先リポジトリで追加する。
Codex での代表的な操作:
- 新規委譲:
spawn_agent - 継続指示:
send_input - 必要時のみ待機:
wait_agent - 不要になったら終了:
close_agent
Tool Mapping: Codex (Team/Task)
Codex では、役割を既存の Team / Task 運用へ読み替える。
- チーム設計・メンバー構成は
subagent-team-design（旧 setup-team）の手順に読み替える - 役割名は
researcher,backend-dev,frontend-dev,testerなどのまま使ってよい - Team / Task ツール上の member 種別や owner 設定は、上の役割表を基準に割り当てる
Codex 側では、ツール固有のチーム操作は subagent-team-design を参照する。
関連スキル
subagent-team-design: Codex の Team / Task ベース運用（旧 setup-team）subagent-driven-development: 実装タスクを委譲して二段階レビューを回すときに併用
When not to use it
- →When a task involves simple, single-file modifications
- →When changes are tightly coupled and splitting them increases rework
- →When the primary agent needs to make immediate design decisions
Limitations
- →The skill does not provide tool-dependent operational procedures.
- →It does not support parallelization of tasks that involve the same files.
- →It does not support parallelization of frontend/backend development if API specifications are not yet finalized.
How it compares
This skill provides a structured framework for multi-agent collaboration, unlike a manual approach that might lack clear delegation rules or integration strategies.
Compared to similar skills
codex-multi-agent side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| codex-multi-agent (this skill) | 0 | 17d | No flags | Intermediate |
| autonomous-agents | 10 | 6mo | No flags | Advanced |
| agent-goal-planner | 2 | 5mo | No flags | Advanced |
| planner | 1 | 5mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by s977043
View all by s977043 →You might also like
autonomous-agents
davila7
Autonomous agents are AI systems that can independently decompose goals, plan actions, execute tools, and self-correct without constant human guidance. The challenge isn't making them capable - it's making them reliable. Every extra decision multiplies failure probability. This skill covers agent loops (ReAct, Plan-Execute), goal decomposition, reflection patterns, and production reliability. Key insight: compounding error rates kill autonomous agents. A 95% success rate per step drops to 60% b
agent-goal-planner
ruvnet
Agent skill for goal-planner - invoke with $agent-goal-planner
planner
solatis
Interactive planning and execution for complex tasks. Use when user asks to use or invoke planner skill.
hierarchical-coordinator
MadAppGang
Prevent goal drift in long-running multi-agent workflows using a coordinator agent that validates outputs against original objectives at checkpoints. Use when orchestrating 3+ agents, multi-phase features, complex implementations, or any workflow where agents may lose sight of original requirements. Trigger keywords - "hierarchical", "coordinator", "anti-drift", "checkpoint", "validation", "goal-alignment", "decomposition", "phase-gate", "shared-state", "drift detection".
workflow-router
parcadei
Goal-based workflow orchestration - routes tasks to specialist agents based on user goals
loki-mode
davila7
Multi-agent autonomous startup system for Claude Code. Triggers on "Loki Mode". Orchestrates 100+ specialized agents across engineering, QA, DevOps, security, data/ML, business operations, marketing, HR, and customer success. Takes PRD to fully deployed, revenue-generating product with zero human intervention. Features Task tool for subagent dispatch, parallel code review with 3 specialized reviewers, severity-based issue triage, distributed task queue with dead letter handling, automatic deployment to cloud providers, A/B testing, customer feedback loops, incident response, circuit breakers, and self-healing. Handles rate limits via distributed state checkpoints and auto-resume with exponential backoff. Requires --dangerously-skip-permissions flag.