agent-capability-matrix について
agent-capability-matrixは、タスクの種類に応じてエージェント、スキル、モデルの段階、代替案を対応付ける選択ガイドです。エージェントに作業を振り分けるユーザー向けに、能力マトリクスと判断フローで選定を支援します。
主な機能
- 01タスク別に主要エージェントを提示
- 02代替エージェントを提示
- 03複雑さに応じたモデル段階の選択
- 04検索・コーディング向け判断フロー
- 05進捗管理ツールを案内
活用シーン
- 01デバッグやコードレビューの担当を選ぶ
- 02アーキテクチャ設計に使うモデル段階を選ぶ
- 03主要エージェントが使えない場合の代替案を探す
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ scientiacapital/ skills --skill agent-capability-matrixインストール後、Claude Code で/agent-capability-matrixを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
config.jsonreference/matrix-table.mdselection-flowchart.md詳細
タスクタイプから最適なエージェント、スキル、モデル階層、およびフォールバック戦略への包括的なマッピングを提供します。特定のタスクにどのエージェントを使うかを選ぶ際の当て推量を排除します。
<quick_start> 適切なエージェントを見つける:
- タスクタイプを特定します(デバッグ、レビュー、ビルド、探索など)
- 以下のマトリクスでプライマリエージェントを調べます
- プライマリが失敗した場合は、フォールバックを使用します
- モデル階層をタスクの複雑さに合わせます </quick_start>
<success_criteria>
- タスクが最初の試行で正しいプライマリエージェントにルーティングされる
- プライマリが利用不可または不十分な場合にフォールバックエージェントが特定される
- モデル階層がタスクの複雑さに合致している(検索には Haiku、コードには Sonnet、アーキテクチャには Opus)
- API 呼び出しの代わりに、進捗追跡にゼロコストツール(TaskCreate、TeamCreate)が使用される
- エージェントの選択が、その場の当て推量ではなくマトリクスによって正当化される </success_criteria>
コアケイパビリティマトリクス
開発タスク
| タスクタイプ | プライマリエージェント | フォールバック | モデル | 備考 |
|---|---|---|---|---|
| 複雑な問題のデバッグ | debug-like-expert スキル | general-purpose | sonnet | 仮説駆動型 |
| 簡単なバグ修正 | general-purpose | — | sonnet | 単純な修正 |
| コードレビュー | code-reviewer | feature-dev:code-reviewer | haiku | パターンマッチング |
| アーキテクチャ設計 | Plan エージェント | code-architect | opus | 複雑な推論 |
| 機能実装 | general-purpose | feature-dev エージェント | sonnet | コード生成 |
| リファクタリング | code-simplifier | general-purpose | sonnet | 挙動を維持 |
| セキュリティ監査 | security スキル | general-purpose | sonnet | OWASP パターン |
| テストの作成 | testing スキル | general-purpose | sonnet | TDD ワークフロー |
| API 設計 | api-design スキル | general-purpose | sonnet | REST/GraphQL |
| API テスト | api-testing スキル | general-purpose | haiku | Postman/Bruno |
探索とリサーチ
| タスクタイプ | プライマリエージェント | フォールバック | モデル | 備考 |
|---|---|---|---|---|
| パターンによるファイル検索 | Glob ツール(直接) | Explore エージェント | — | 最速 |
| コード内容の検索 | Grep ツール(直接) | Explore エージェント | — | 最速 |
| コードベース領域の理解 | Explore エージェント | general-purpose | haiku | 徹底的な検索 |
| 詳細なコード分析 | code-explorer | Explore エージェント | sonnet | 実行を追跡 |
| フレームワーク/ツールのリサーチ | research スキル | WebSearch | sonnet | 構造化された評価 |
| 市場リサーチ | research スキル | WebSearch | sonnet | 企業プロファイル |
インフラストラクチャとデプロイ
| タスクタイプ | プライマリエージェント | フォールバック | モデル | 備考 |
|---|---|---|---|---|
| Docker セットアップ | docker-compose スキル | general-purpose | sonnet | ローカル開発 |
| GPU デプロイ | runpod-deployment スキル | general-purpose | sonnet | RunPod |
| データベースマイグレーション | supabase-sql スキル | general-purpose | sonnet | Supabase |
| Stripe 統合 | stripe-stack スキル | general-purpose | sonnet | 決済 |
| 音声 AI パイプライン | voice-ai スキル | general-purpose | sonnet | Deepgram+Cartesia |
| LangGraph エージェント | langgraph-agents スキル | general-purpose | sonnet | マルチエージェント |
| 高速推論 | groq-inference スキル | general-purpose | sonnet | GROQ API |
| 中国語 LLM | openrouter スキル | general-purpose | sonnet | DeepSeek/Qwen |
| LLM ファインチューニング | unsloth-training スキル | general-purpose | sonnet | GRPO/SFT |
ビジネス & GTM
| タスク種別 | プライマリエージェント | フォールバック | モデル | 備考 |
|---|---|---|---|---|
| GTM 戦略 | gtm-pricing skill | general-purpose | sonnet | ICP、ポジショニング |
| 営業アウトリーチ | sales-revenue skill | general-purpose | sonnet | コールドメール |
| CRM 統合 | crm-integration skill | general-purpose | sonnet | Close/HubSpot |
| コンテンツマーケティング | content-marketing skill | general-purpose | sonnet | B2B コンテンツ |
| データ分析 | data-analysis skill | general-purpose | sonnet | ダッシュボード |
| トレーディングシグナル | trading-signals skill | general-purpose | sonnet | テクニカル分析 |
| ビジネスモデル | business-model-canvas skill | general-purpose | sonnet | 9ブロックキャンバス |
| 市場差別化 | blue-ocean-strategy skill | general-purpose | sonnet | ERRC フレームワーク |
ワークフロー & コーディネーション
| タスク種別 | プライマリエージェント | フォールバック | モデル | 備考 |
|---|---|---|---|---|
| セッション開始/終了 | workflow-orchestrator skill | — | sonnet | 日次のライフサイクル |
| 並列 worktree 開発 | agent-teams skill | worktree-manager skill | sonnet | 完全な分離 |
| セッション内並列 | subagent-teams skill | sequential execution | haiku-sonnet | Task ツール |
| 進捗トラッキング | TaskCreate/TaskUpdate | TodoWrite | — | ネイティブ UI スピナー |
| チームコーディネーション | TeamCreate + SendMessage | subagent-teams skill | haiku-sonnet | 共有タスクリスト |
| Git ワークフロー | git-workflow skill | general-purpose | haiku | コミット、PR |
| スキル作成 | extension-authoring skill | general-purpose | sonnet | スキル、フック |
| プロジェクト計画 | planning-prompts skill | Plan agent | sonnet | メタプロンプト |
| コストトラッキング | cost-metering skill | manual tracking | haiku | 予算ステータス |
意思決定フローチャート
START: What do I need to do?
│
├── Search/Find something?
│ ├── Know the file pattern? → Glob (direct)
│ ├── Know the code pattern? → Grep (direct)
│ └── Need to understand area? → Explore agent (haiku)
│
├── Write/Change code?
│ ├── Simple fix? → general-purpose (sonnet)
│ ├── New feature? → Check if a skill matches → skill or general-purpose (sonnet)
│ ├── Architecture? → Plan agent (opus)
│ └── Parallel build? → subagent-teams or agent-teams
│
├── Review/Validate?
│ ├── Code review? → code-reviewer (haiku)
│ ├── Security? → security skill (sonnet)
│ └── Tests? → testing skill (sonnet)
│
├── Research/Learn?
│ ├── Codebase? → Explore agent (haiku)
│ ├── Framework? → research skill (sonnet)
│ └── Market? → research skill (sonnet)
│
└── Business/GTM?
└── Check Business section of matrix above
モデルティアガイド
| ティア | モデル | コスト/1M 入力 | 最適な用途 |
|---|---|---|---|
| Fast | Haiku 4.5 | $1.00 | 検索、分類、レビュー、シンプルなタスク |
| Standard | Sonnet 4.6 | $3.00 | コード生成、推論、ほとんどのタスク |
| Premium | Opus 4.6 | $5.00 | アーキテクチャ、複雑な意思決定、計画 |
| Free | TaskCreate | $0 | 進捗トラッキング(ローカル UI、API 呼び出しではない) |
特別な理由がない限り Sonnet をデフォルトとします:
- タスクが検索/分類 → Haiku を使用(5倍安価)
- タスクが深い推論を必要とする → Opus を使用(5倍高性能)
- タスクが進捗トラッキング →
activeFormを指定した TaskCreate でライブスピナーを表示(コストゼロ)
相互参照: セッション内並列エージェントについては subagent-teams、worktree 分離された並列エージェントについては agent-teams を参照してください。
詳細: reference/matrix-table.md、reference/selection-flowchart.md を参照してください。
結果サイドカーの出力
最終ステップとして、~/.claude/skill-analytics/last-outcome-agent-capability-matrix.json に書き込みます:
{"ts":"[UTC ISO8601]","skill":"agent-capability-matrix","version":"1.0.0","variant":"default",
"status":"[success|partial|error]","runtime_ms":[estimated ms from start],
"metrics":{"tasks_routed":[n],"agents_matched":[n],"fallbacks_used":[n]},
"error":null,"session_id":"[YYYY-MM-DD]"}
一部のステージが失敗しても結果が生成された場合は、ステータスに "partial" を使用してください。出力がまったく生成されなかった場合にのみ "error" を使用してください。
コメント
Markdown 対応