From agent-team
Execute tasks using a coordinated agent team with role-based assignments, devil's advocate review, and persistent team knowledge
How this skill is triggered — by the user, by Claude, or both
Slash command
/agent-team:agent-teamThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
このスキルは、品質保証と継続的な学習を組み込んだ専門エージェントの協調チームを作成・管理し、複雑なタスクを実行します。
このスキルは、品質保証と継続的な学習を組み込んだ専門エージェントの協調チームを作成・管理し、複雑なタスクを実行します。
次の場合にこのスキルを有効にしてください:
このスキルは Claude Code のカスタムサブエージェント機能を使用します。エージェントロールは .claude/agents/ に Markdown ファイルとして定義されています。
各ロール定義には以下が含まれます:
利用可能な全ロールを確認するには、.claude/agents/ 内のファイルを参照してください。
devils-advocate(デビルズ・アドボケート)- 常に必須
.claude/agents/devils-advocate.md で定義まず、過去の実行から既存のチームナレッジがあるか確認します:
KNOWLEDGE_DIR="skills/agent-team/team-knowledge"
KNOWLEDGE_FILE="${KNOWLEDGE_DIR}/accumulated-knowledge.md"
if [ -f "$KNOWLEDGE_FILE" ]; then
echo "📚 Loading team knowledge from previous sessions..."
cat "$KNOWLEDGE_FILE"
else
echo "📝 No previous team knowledge found. Starting fresh."
fi
知識ファイルが存在する場合は Read ツールで読み込んでください。このナレッジが現在の実行に反映されます。
ユーザーのタスクに基づき、必要なロールを決めます。利用可能なロールは .claude/agents/ で定義されています。
必ず devils-advocate を含めてください — このロールは定義で "required": true です。
上記「利用可能なロール」のよく使う組み合わせを参考にするか、タスク要件に応じてカスタムの組み合わせを選んでください。
利用可能なカスタムエージェントは次のコマンドで一覧できます:
ls .claude/agents/*.md | xargs -n1 basename -s .md
タスクが曖昧な場合は AskUserQuestion でユーザーに選択したロールの確認を求めてください。
TeamCreate でチームを立ち上げます:
{
"team_name": "task-[brief-description]",
"description": "[Brief description of the task and objectives]",
"agent_type": "team-lead"
}
主要な作業項目ごとに TaskCreate でタスクを作成します:
{
"subject": "[Imperative description]",
"description": "[Detailed requirements and acceptance criteria]",
"activeForm": "[Present continuous form for spinner]"
}
選択したロールごとに、Task ツールでカスタムサブエージェントタイプのエージェントを起動します。
.claude/agents/ のロール定義は Claude Code により自動読み込みされます。ロール ID をそのまま subagent_type に指定できます。
例: architect エージェントの起動
{
"subagent_type": "architect",
"description": "Architect for [task-name]",
"prompt": "Current task context:
[Task details and requirements]
Team information:
- Team name: task-[brief-description]
- Your role: architect
- Team config: ~/.claude/teams/task-[name]/config.json
Team knowledge from previous sessions:
[Include relevant knowledge if loaded]
Team coordination instructions:
1. Read the team config to see other team members
2. Check TaskList to see available tasks
3. Claim tasks relevant to your role using TaskUpdate
4. Work on your assigned tasks
5. Coordinate with other team members using SendMessage when needed
6. Mark tasks as completed when done
7. Share insights and learnings with team lead",
"team_name": "task-[brief-description]",
"name": "architect"
}
注意事項:
.claude/agents/[role-id].md のロール定義がベースのプロンプトと指示を提供しますprompt パラメータでタスク固有の文脈とチーム連携の指示を追加しますsubagent_type と name の両方に使いますチームリードとして:
タスク完了後、チームをシャットダウンする前に、チームナレッジを作成または更新します:
KNOWLEDGE_DIR="skills/agent-team/team-knowledge"
KNOWLEDGE_FILE="${KNOWLEDGE_DIR}/accumulated-knowledge.md"
# Ensure directory exists
mkdir -p "$KNOWLEDGE_DIR"
# Append new learnings
cat >> "$KNOWLEDGE_FILE" << 'EOF'
## Session: [Date/Time] - [Task Description]
### What Worked Well
- [Key success factors]
- [Effective approaches]
- [Good decisions]
### What Could Be Improved
- [Issues encountered]
- [Better alternatives identified]
- [Lessons learned]
### Key Insights
- [Technical insights]
- [Process improvements]
- [Architectural learnings]
### Devil's Advocate Highlights
- [Critical questions that improved outcomes]
- [Problems identified and addressed]
- [Alternative approaches considered]
---
EOF
重要: ナレッジファイルへの追記は、bash のリダイレクトではなく Write または Edit ツールを使ってください。
全タスクが完了し学習が記録されたら:
{
"type": "shutdown_request",
"recipient": "[agent-name]",
"content": "Task complete. Thank you for your contributions."
}
シャットダウン確認を待つ
TeamDelete でチームリソースをクリーンアップする
ユーザーに以下を伝えます:
skills/agent-team/team-knowledge/accumulated-knowledge.md は、セッションをまたいだ学習を次の形式で蓄積します:
# Team Knowledge Repository
This file contains accumulated learnings from agent team executions.
## Session: [Date] - [Task]
[Learnings from that session]
## Session: [Date] - [Task]
[Learnings from next session]
team-knowledge ディレクトリは git から自動的に除外されます(下記 .gitignore を参照)。
User: "Implement user authentication with JWT"
1. チームナレッジの読み込み → 過去の認証関連の学習を読む
2. ロール選択 → architect, backend, security, tester, devils-advocate
3. チーム作成 → "task-auth-jwt"
4. タスク作成:
- 認証アーキテクチャの設計
- JWT 生成と検証の実装
- セキュリティミドルウェアの追加
- 認証テストの作成
- セキュリティ脆弱性のレビュー
5. チームメイト起動(各ロールで 5 エージェント)
6. 実行の調整:
- アーキテクトがアプローチを設計
- 実装者がコードを記述
- セキュリティが脆弱性をレビュー
- テスターがテストカバレッジを追加
- Devils-advocate が決定に異議を唱え問題を特定
7. 学習の記録:
- 発見した JWT ベストプラクティス
- 有効だったセキュリティパターン
- devils-advocate が特定したエッジケース
8. チームのシャットダウン
9. ユーザーにサマリーを提示
npx claudepluginhub dskst/agent-teamGuides composing agent teams for complex tasks with predefined roles: Orchestrator, Explorer, Frontend (React), Backend (Rails), iOS/Swift, Android/Kotlin, Database.
Sets up multi-agent teams for complex projects with file-based planning, per-agent directories, and teammate spawning. Triggers on team/swarm/start-project requests.
Guides coordination of parallel agent teams (Implementer, Reviewer, Architect) for complex plans, cross-cutting concerns, and communicating work streams.