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

---

利用可能なエージェント

エージェント	専門分野	トリガーフレーズ
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. 利用可能なエージェント - 17 種類の専門エージェントをオーケストレーションできます
2. 論理的な順序 - 探索 → 分析 → 実装 → テスト
3. コンテキストを共有 - 関連する調査結果を後続のエージェントに渡します
4. 単一の統合結果 - 個別の出力ではなく、1 つにまとめた統一レポートにします
5. 変更の検証 - コードを変更する場合は必ず test-engineer を含めてください

---

主なメリット

• ✅ 単一セッション - すべてのエージェントがコンテキストを共有します
• ✅ AI による制御 - Claude が自律的にオーケストレーションします
• ✅ ネイティブ統合 - 組み込みの Explore、Plan エージェントと連携します
• ✅ 再開のサポート - 以前のエージェントの作業を続行できます
• ✅ コンテキストの受け渡し - エージェント間で調査結果が引き継がれます