parallel-agents

ネイティブ並列エージェント

Claude Code に組み込まれた Agent Tool によるオーケストレーション

概要

このスキルでは、Claude Code のネイティブエージェントシステムを通じて、複数の専門エージェントを連携させます。外部スクリプトとは異なり、オーケストレーションのすべてを Claude の制御下に置くことができます。

オーケストレーションを使用する場面

✅ 適しているタスク：

• 複数分野の専門知識が必要な複雑なタスク
• セキュリティ、パフォーマンス、品質の観点からのコード分析
• 包括的なレビュー（アーキテクチャ＋セキュリティ＋テスト）
• バックエンド＋フロントエンド＋データベースの作業が必要な機能実装

❌ 適していないタスク：

• 単純で、単一分野に限られるタスク
• 簡単な修正や小規模な変更
• 1つのエージェントで十分なタスク

---

ネイティブエージェントの呼び出し

単一エージェント

Use the security-auditor agent to review authentication

順次チェーン

First, use the explorer-agent to discover project structure.
Then, use the backend-specialist to review API endpoints.
Finally, use the test-engineer to identify test gaps.

コンテキストを渡す場合

Use the frontend-specialist to analyze React components.
Based on those findings, have the test-engineer generate component tests.

前回の作業を再開する

Resume agent [agentId] and continue with additional requirements.

---

オーケストレーションのパターン

パターン 1：包括的な分析

Agents: explorer-agent → [domain-agents] → synthesis

1. explorer-agent: Map codebase structure
2. security-auditor: Security posture
3. backend-specialist: API quality
4. frontend-specialist: UI/UX patterns
5. test-engineer: Test coverage
6. Synthesize all findings

パターン 2：機能レビュー

Agents: affected-domain-agents → test-engineer

1. Identify affected domains (backend? frontend? both?)
2. Invoke relevant domain agents
3. test-engineer verifies changes
4. Synthesize recommendations

パターン 3：セキュリティ監査

Agents: security-auditor → penetration-tester → synthesis

1. security-auditor: Configuration and code review
2. penetration-tester: Active vulnerability testing
3. Synthesize with prioritized remediation

---

以下のエージェント名とモデルの割り当ては、上流の役割を例示したものであり、同梱されている定義や、必ず利用できる組み込み機能を示すものではありません。実際のホストツールやインストール済みエージェントを確認し、その委任権限に従ってください。関連するコンテキストを明示的に渡し、重複しないファイルやワークツリーを割り当てて、出力の要件を明確にし、共有編集や統合は1人の担当者に任せてください。委任しただけで、実際のテストやデプロイの許可が得られるわけではありません。

利用可能なエージェント

エージェント	専門分野	起動フレーズ
orchestrator	調整	"comprehensive", "multi-perspective"
security-auditor	セキュリティ	"security", "auth", "vulnerabilities"
penetration-tester	セキュリティテスト	"pentest", "red team", "exploit"
backend-specialist	バックエンド	"API", "server", "Node.js", "Express"
frontend-specialist	フロントエンド	"React", "UI", "components", "Next.js"
test-engineer	テスト	"tests", "coverage", "TDD"
devops-engineer	DevOps	"deploy", "CI/CD", "infrastructure"
database-architect	データベース	"schema", "Prisma", "migrations"
mobile-developer	モバイル	"React Native", "Flutter", "mobile"
api-designer	API 設計	"REST", "GraphQL", "OpenAPI"
debugger	デバッグ	"bug", "error", "not working"
explorer-agent	調査	"explore", "map", "structure"
documentation-writer	ドキュメント	"write docs", "create README", "generate API docs"
performance-optimizer	パフォーマンス	"slow", "optimize", "profiling"
project-planner	計画	"plan", "roadmap", "milestones"
seo-specialist	SEO	"SEO", "meta tags", "search ranking"
game-developer	ゲーム開発	"game", "Unity", "Godot", "Phaser"

---

Claude Code の組み込みエージェント

これらはカスタムエージェントと連携して動作します。

エージェント	モデル	目的
Explore	Haiku	コードベースを素早く読み取り専用で検索
Plan	Sonnet	計画モード中の調査
General-purpose	Sonnet	複雑な複数ステップの変更

簡単な検索には Explore を、分野固有の専門知識が必要な場合は カスタムエージェント を使用してください。

---

統合プロトコル

すべてのエージェントの作業が完了したら、次のように統合します。

## Orchestration Synthesis

### Task Summary
[What was accomplished]

### Agent Contributions
| Agent | Finding |
|-------|---------|
| security-auditor | Found X |
| backend-specialist | Identified Y |

### Consolidated Recommendations
1. **Critical**: [Issue from Agent A]
2. **Important**: [Issue from Agent B]
3. **Nice-to-have**: [Enhancement from Agent C]

### Action Items
- [ ] Fix critical security issue
- [ ] Refactor API endpoint
- [ ] Add missing tests

---

ベストプラクティス

1. 利用可能なエージェント - 実際にインストールされているか、ホストがサポートしている役割のみを使用します
2. 論理的な順序 - 調査 → 分析 → 実装 → テスト
3. コンテキストの共有 - 後続のエージェントに関連する調査結果を渡します
4. 単一の統合結果 - 個別の出力ではなく、統一されたレポートを1つ作成します
5. 変更の検証 - コードを変更する場合は、必ず test-engineer を含めます

---

主なメリット

• ✅ 連携されたセッション - 関連するコンテキストのみを明示的に共有します。継承の仕組みはホストによって異なります
• ✅ AI による制御 - Claude が自律的にオーケストレーションします
• ✅ ネイティブ統合 - 組み込みの Explore、Plan エージェントと連携します
• ✅ 再開のサポート - 前回のエージェントの作業を続行できます
• ✅ コンテキストの受け渡し - 調査結果をエージェント間で引き継ぎます

制限事項

• このスキルは、タスクが上記のスコープに明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全境界、成功基準が欠けている場合は、作業を中断して確認を求めてください。