agent-team について
agent-teamは、タスクやワーカーの調整、プロジェクト設定、ロール管理、開発ワークフローに関する依頼を専門スキルへ振り分けるナビゲーションスキルです。シェル自体に機能を追加せず、専用の入口へ案内します。
主な機能
- 01タスクのライフサイクル依頼を振り分け
- 02タスクとワーカーの状態を確認
- 03ワーカーの派遣と返信を調整
- 04ロールとロールカタログを管理
- 05プロジェクト初期化とルール保守
- 06設計、テスト、デバッグの手順を案内
活用シーン
- 01タスク作成や割り当ての依頼を振り分け
- 02タスクやワーカーの状態を読み取り専用で確認
- 03ロールパッケージの作成やカタログ閲覧
- 04設計、TDD、デバッグの手順を選択
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jsonlee12138/ agent-team --skill agent-teamインストール後、Claude Code で/agent-teamを入力して読み込まれたか確認します。
詳細
agent-team
このスキルはナビゲーションシェルになりました。すべてのリクエストを、以下の専用の第1階層スキルに振り分けてください。
ここに新しい動作を追加し続けないでください。
スキルリファレンス
コントローラー/人間によるオーケストレーション
task-orchestrator
書き込み可能なタスクライフサイクルのエントリーポイントです。
- 対象:コントローラー、人間
- トリガー:タスクの作成、タスクの割り当て、タスクの完了、タスクのアーカイブ、タスクフロー
- CLI:
agent-team task create·task list·task show·task assign·task done·task archive - 注記:変更を伴わない読み取り専用の問い合わせには、
task-inspectorを優先してください。
task-inspector
読み取り専用のタスク状況確認と検索です。
- 対象:コントローラー、ワーカー、人間
- トリガー:タスクの確認、タスクの状況、タスクの一覧表示、タスクの表示
- CLI:
agent-team task list·task show - 注記:リクエストに作成、割り当て、完了、またはアーカイブの意図が含まれる場合は、
task-orchestratorに振り分けてください。
task-splitting
要件ドキュメントまたは設計ドキュメントをタスクの草案に分解し、明示的な承認後に agent-team のタスクパッケージを作成します。
- 対象:コントローラー、人間
- トリガー:ドキュメントをタスクに変換、タスクを分割、タスクの境界を検証、
agent-team task create用のタスクファイルを準備 - ワークフロー:ソースを受け取る → 目標を抽出する → 機能の境界ごとに草案を作成する → 検証する → タスクごとに1つのファイルを書き込む → 確認する → 作成する
- 注記:ドキュメントの目標が曖昧な場合や、スコープの競合がある場合は、
brainstormingを自動的に呼び出します。
workflow-orchestrator
ガバナンス専用のワークフロー計画エントリーポイントです。
- 対象:コントローラー、人間
- トリガー:ワークフロー計画、計画の承認、計画の有効化、計画の終了
- CLI:
agent-team workflow plan generate·approve·activate·close - 注記:ワーカーの割り当て、ワーカーの復旧、ワーカー状況の確認には使用しないでください。
worker-dispatch
ワーカーの起動、ワーカーへの返信、対象のワーカー状況の確認を行うコントローラー側のインターフェースです。
- 対象:コントローラー、人間
- トリガー:ワーカーの起動、ワーカーのディスパッチ、ワーカーへの返信、返信前に現在のワーカーを確認
- CLI:
agent-team worker open·worker status·agent-team reply - 注記:ディスパッチや返信の意図を伴わない、読み取り専用のワーカー群の確認には
worker-inspectorを使用してください。
worker-inspector
読み取り専用のワーカー状況確認です。
- 対象:コントローラー、人間
- トリガー:ワーカーの状況、ワーカーの確認、ワーカーの一覧表示
- CLI:
agent-team worker status - 注記:プロンプトが起動、ディスパッチ、または返信の動作を示唆する場合は、
worker-dispatchに振り分けてください。
project-bootstrap
プロジェクトの初期化と移行のエントリーポイントです。
- 対象:人間、コントローラー
- トリガー:プロジェクトの初期化、プロジェクトの移行、新しいリポジトリでの agent-team のセットアップ
- CLI:
agent-team init·agent-team migrate
rules-maintenance
組み込みのルールテンプレートと生成されたルール成果物を同期し、更新します。
- 対象:人間、コントローラー
- トリガー:ルールの同期、ルールの差異の修正、ルールの更新
- CLI:
agent-team rules sync
skill-maintenance
スキルキャッシュの保守:インストール済みのスキル成果物を確認、更新、クリーンアップします。
- 対象:人間、コントローラー
- トリガー:スキルの確認、スキルの更新、スキルのクリーンアップ、スキルキャッシュの更新
- CLI:
agent-team skill check·skill update·skill clean
role-browser
読み取り専用のローカルロール一覧表示です。
- 対象:コントローラー、ワーカー、人間
- トリガー:ロールの一覧表示、ロールの参照、ローカルロールの表示
- CLI:
agent-team role list - 注記:
role createや role-repo の管理には対応していません。
role-creator
決定論的な出力ファイルを使用して、ロールのスキルパッケージを作成または更新します。
- 対象ユーザー:人間、コントローラー
- トリガー:ロールを作成、新しいロール、ロールを編集、ロールを更新、ロールスキルを追加、ロール設定を変更
- 出力:
skills/<role>/または.agent-team/teams/<role>/のSKILL.md+references/role.yaml+system.md - CLI:
agent-team role create - ワークフロー:名前を正規化 → ロールのフィールドを自動生成 → スキルを選択 → CLI を実行 → 出力を検証
role-repo-manager
ロールの取得元を管理します(ロールリポジトリの追加、一覧表示、確認、更新、削除)。
- 対象ユーザー:人間、コントローラー
- トリガー:ロールリポジトリを検索、ロールリポジトリを追加、ロールリポジトリを更新、ロールリポジトリを削除
- CLI:
agent-team role-repo find·add·list·check·update·remove - 注記:ローカルのロールを閲覧するためのものではありません。その場合は
role-browserまたはcatalog-browserを使用してください。
catalog-browser
読み取り専用のカタログ閲覧:設定済みのリモートカタログからロールを検索します。
- 対象ユーザー:人間、コントローラー
- トリガー:カタログを検索、ロールを閲覧、カタログのロールを表示、カタログの統計情報
- CLI:
agent-team catalog search·show·list·repo·stats - 注記:
normalize、discover、serveコマンドは公開しません。
ワーカー優先のスキル
worker-recovery
ファイルの成果物からワーカーの現在の割り当てを再開します。
- 対象ユーザー:ワーカー
- トリガー:作業を再開、タスクを復旧、現在の割り当てを続行
- 必須の最初の手順:最初に必ず
worker.yamlを読み取ります - 復旧順序:
worker.yaml→task.yaml→context.md→ 必要な場合に限り参照資料 - 注記:ワーカーからメインへの報告には使用しません。その場合は
worker-reply-mainを使用してください。
worker-reply-main
完了、ブロッカー、または判断が必要な事項について、コントローラーにメッセージを送信します。
- 対象ユーザー:ワーカー
- トリガー:メインに返信、完了を報告、ブロックされた、判断を依頼
- CLI:
agent-team reply-main - 必須の最初の手順:最初に必ず
worker.yamlを読み取ります - 注記:コントローラーからワーカーへの返信には使用しません。その場合は
worker-dispatchを使用してください。
共有/戦略スキル
context-cleanup
セッションのコンテキストを整理し、セッションの進行が逸れている場合はファイルの成果物を基に再調整します。
- 対象ユーザー:コントローラー、ワーカー
- トリガー:コンテキストを整理、セッションの逸脱、コンテキストを再調整、中断後に再開、フェーズの移行
- 必須の最初の手順:コントローラー →
.agent-team/rules/index.md、ワーカー →worker.yaml - 注記:現在の割り当てを復旧するだけで済む通常のワーカータスクの再開には、
worker-recoveryを使用してください。
brainstorming
実装に着手する前に、対話を通じてアイデアを検証済みの設計ドキュメントにまとめます。
- 対象ユーザー:すべて
- トリガー:ブレインストーミングを明示的に依頼、要件を具体化、アプローチを比較、計画/設計ドキュメントを作成
- 厳守事項:設計を提示して承認を得るまで、コードを書いたり実装スキルを呼び出したりしてはいけません
- 注記:変更内容が明確に指定された単純な実装依頼には使用しません。
tdd
個人での実装作業向けの、受け入れ基準を優先する TDD ワークフローです。
- 対象ユーザー:ワーカー、コントローラー
- トリガー:TDD で実装、受け入れ基準を定義、先に失敗するテストを書く、結論を出す前に修正を検証
- 手順:コンテキストを読む → 受け入れ基準を定義 → 失敗するテストを書く(可能な場合) → 実装 → 検証 →
passed/failed/skippedで結論を出す - 注記:専用のテストケース設計や回帰テストの実行が必要な場合は、
qa-expertを呼び出してください。
systematic-debugging
あらゆるバグ、テスト失敗、予期しない動作に対して、まず根本原因を特定してデバッグします。
- 対象:すべて
- トリガー:あらゆるバグ、テスト失敗、予期しない動作、パフォーマンスの問題、ビルド失敗、統合の問題
- 鉄則:根本原因の調査を先に行わずに修正してはなりません
- 4 つのフェーズ:根本原因の調査 → 修正の設計 → 実装 → 検証
- 注記:時間に追われている場合や、以前の修正がうまくいかなかった場合は、特に使用してください。
find-skills
オープンなエージェントスキルエコシステムから、エージェントスキルを見つけてインストールします。
- 対象:すべて
- トリガー:「X の方法を知りたい」、「X に使えるスキルを探して」、「〜できるスキルはありますか」、エージェントの機能拡張
- CLI:
agent-team skill install - 注記:ユーザーがインストール可能なスキルとして存在する可能性のある機能を探している場合に使用してください。
qa-expert
Google Testing Standards と OWASP のベストプラクティスに基づいて、包括的な QA テストプロセスを確立します。
- 対象:すべて
- トリガー:QA のセットアップ、テストケースの作成、テスト計画の実行、バグの追跡、QA レポートの作成、OWASP セキュリティテスト、サードパーティへの QA 引き継ぎ
- 機能:テストケースの作成(AAA パターン)、バグの追跡(P0–P4)、品質指標、自律的な LLM 主導の実行、90% のカバレッジ目標
- 注記:単体検証を超える専用のテストケース設計や回帰テストの実行が必要な場合は、
tddから呼び出してください。
prompt-engineering-patterns
本番環境の LLM アプリケーション向けに、高度なプロンプトエンジニアリング手法を習得します。
- 対象:すべて
- トリガー:プロンプトの最適化、LLM 出力の改善、本番環境向けプロンプトテンプレートの設計、chain-of-thought、few-shot learning、構造化出力
- 機能:chain-of-thought / tree-of-thought パターン、動的な few-shot 選択、変数補間テンプレート、JSON 構造化出力、システムプロンプトの設計
ルーティングルール
- リクエストが特定のライフサイクルアクションを示唆している場合は、ただちに専用のスキルにルーティングしてください。
- コンテキストの安定化や作業の再開に関するリクエストは、
context-cleanupまたはworker-recoveryにルーティングしてください。 - このファイルは、過去のプロンプトとの互換性を保つためだけに維持してください。