---

name: team-agent description: "Claude CodeのTeam Agent機能で複数の専門エージェントによる並行処理を実行。「Team Agent」「並行処理」などの作業に使う。"

team-agent - Claude CodeのTeam Agent機能活用スキル

説明: Claude CodeのTeam Agent機能で複数の専門エージェントによる並行処理を実行する。記事分析、プロダクト開発、リサーチ等で複数視点の同時処理を実現。

🎯 使用場面

• 記事・コンテンツの多角的分析・改善
• プロダクト設計での専門分野並行検討
• リサーチ・企画の複数視点同時処理
• 品質保証での多段階チェック

✅ 確立されたワークフロー

1. 起動準備

# 権限問題を回避（必須）
claude --dangerously-skip-permissions

2. Team Agent実行

プロンプト内で以下を実行：

/team @agent1 @agent2 @agent3

# 例：記事分析の場合
/team @analyst @writer @editor

# タスク説明も追加
記事分析タスク：https://example.com/article

この記事を読んで以下を分析・改善してください：
1. 記事構成の問題点と改善案
2. より魅力的な見出し案  
3. 読みやすさの向上策
4. アクションアブルな改善提案

3. 監視実行（別ターミナル推奨）

# 継続監視ループ
while true; do
  sleep 30
  process action=log sessionId=<session_id>
  process action=poll sessionId=<session_id>
done

# または手動で定期実行
sleep 30 && process action=log sessionId=<session_id>

🎭 推奨エージェント組み合わせ

📝 コンテンツ制作

• 記事分析: @analyst + @writer + @editor
• SEO最適化: @seo-expert + @content-optimizer + @keyword-researcher
• 多角的レビュー: @technical-reviewer + @ux-reviewer + @business-reviewer

🛠️ プロダクト開発

• アーキテクチャ設計: @architect + @security-expert + @performance-specialist
• コードレビュー: @code-reviewer + @security-scanner + @performance-tester
• 品質保証: @qa-engineer + @accessibility-checker + @user-experience-tester

🔍 リサーチ・分析

• 市場調査: @market-researcher + @competitor-analyst + @trend-analyzer
• 技術調査: @tech-researcher + @feasibility-analyst + @risk-assessor
• 企画立案: @strategist + @marketer + @financial-analyst

⚠️ よくある落とし穴

• --dangerously-skip-permissions なしで起動: 権限エラーで停止する。Team Agent実行時は必ずこのフラグ付きで起動する
• バックグラウンドプロセスの放置: 「もう少し待って」は責任回避。30秒間隔で process action=log / process action=poll を実行して継続監視すること。完了まで追跡を怠ると、エラーで止まったまま気づけない
• エージェント役割が曖昧: 各エージェントの担当範囲が重なると、重複作業や矛盾した出力が発生する。役割と指示を具体的に分けて記述する
• 処理時間の過小見積もり: 実績では44.3kトークン・2分10秒以上かかる。数分〜十数分を想定し、大量トークン消費を前提とした計画を立てる
• プロセスが応答しない時の焦り: 長時間実行は正常動作の可能性が高い。process action=poll で状態を確認し、実際にエラーが出ていない限り待つ

💡 成功のコツ

• エージェント役割を明確に分ける
• 各エージェントへの指示を具体的に記述
• 処理時間は数分〜十数分を想定
• 大量トークン消費を前提とした計画

📊 実績データ（2026-02-08成功例）

• 実行時間: 2分10秒以上
• 処理トークン数: 44.3k tokens
• エージェント数: 3体（@analyst + @writer + @editor）
• タスク: AI Solo Craft記事の分析・改善提案
• 成果: 記事構成、見出し、読みやすさの総合的改善案

🔧 トラブルシューティング

よくある問題と解決方法

問題: 権限エラーで停止 解決: claude --dangerously-skip-permissions で起動し直し

問題: プロセスが応答しない 解決: process action=poll sessionId=<id> で状態確認、必要に応じて再起動

問題: エージェントが期待通りに動作しない 解決: エージェント役割と指示を明確化、一つずつテスト実行

問題: 処理が長時間続く 解決: 正常動作の可能性高 - 継続監視で進捗確認

📈 活用効果

• 品質向上: 複数視点による見落とし削減
• 効率化: 並行処理による時間短縮
• 専門性: 各分野エキスパートの同時活用
• 革新性: 従来不可能だった多角的同時分析

🔗 関連ドキュメント

• AGENTS.md: バックグラウンドタスク監視ルール
• TOOLS.md: Team Agent使用方法
• MEMORY.md: Team Agent成功実績と教訓