agent-capability-matrix

提供任务类型与最佳 Agent、技能、模型层级及回退策略的全面映射。帮助你在为特定任务选择 Agent 时不再凭猜测。

<quick_start> 找到合适的 Agent：

1. 确定任务类型（调试、审查、构建、探索等）
2. 在下方矩阵中查找首选 Agent
3. 如果首选方案失败，则使用回退方案
4. 根据任务复杂度匹配模型层级 </quick_start>

<success_criteria>

• 首次尝试就将任务分配给正确的首选 Agent
• 如果首选 Agent 不可用或能力不足，能够确定回退 Agent
• 模型层级与任务复杂度匹配（搜索用 Haiku，代码用 Sonnet，架构设计用 Opus）
• 使用零成本工具（TaskCreate、TeamCreate）跟踪进度，而不是调用 API
• 根据矩阵选择 Agent，而非临时猜测 </success_criteria>

- “哪个 Agent”“分配任务”“这个任务用哪个 Agent”“最佳 Agent” - “能力矩阵”“Agent 选择”“我应该使用什么工具” - “任务分配”“Agent 分配”

---

核心能力矩阵

开发任务

任务类型	首选 Agent	回退方案	模型	备注
调试复杂问题	debug-like-expert skill	general-purpose	sonnet	基于假设
快速修复错误	general-purpose	—	sonnet	简单修复
代码审查	code-reviewer	feature-dev:code-reviewer	haiku	模式匹配
架构设计	Plan agent	code-architect	opus	复杂推理
功能实现	general-purpose	feature-dev agents	sonnet	代码生成
重构	code-simplifier	general-purpose	sonnet	保留行为
安全审计	security skill	general-purpose	sonnet	OWASP 模式
编写测试	testing skill	general-purpose	sonnet	TDD 工作流
API 设计	api-design skill	general-purpose	sonnet	REST/GraphQL
API 测试	api-testing skill	general-purpose	haiku	Postman/Bruno

探索与研究

任务类型	首选 Agent	回退方案	模型	备注
按模式查找文件	Glob tool (direct)	Explore agent	—	速度最快
搜索代码内容	Grep tool (direct)	Explore agent	—	速度最快
了解代码库某个部分	Explore agent	general-purpose	haiku	全面搜索
深度代码分析	code-explorer	Explore agent	sonnet	跟踪执行过程
研究框架或工具	research skill	WebSearch	sonnet	结构化评估
市场研究	research skill	WebSearch	sonnet	公司概况

基础设施与部署

任务类型	首选 Agent	回退方案	模型	备注
Docker 设置	docker-compose skill	general-purpose	sonnet	本地开发
GPU 部署	runpod-deployment skill	general-purpose	sonnet	RunPod
数据库迁移	supabase-sql skill	general-purpose	sonnet	Supabase
Stripe 集成	stripe-stack skill	general-purpose	sonnet	支付
语音 AI 流水线	voice-ai skill	general-purpose	sonnet	Deepgram+Cartesia
LangGraph Agent	langgraph-agents skill	general-purpose	sonnet	多 Agent
快速推理	groq-inference skill	general-purpose	sonnet	GROQ API
中文大模型	openrouter skill	general-purpose	sonnet	DeepSeek/Qwen
大模型微调	unsloth-training skill	general-purpose	sonnet	GRPO/SFT

商业与 GTM

任务类型	主要 Agent	备用方案	模型	备注
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 框架

工作流与协调

任务类型	主要 Agent	备用方案	模型	备注
会话开始/结束	workflow-orchestrator skill	—	sonnet	每日生命周期
并行 worktree 开发	agent-teams skill	worktree-manager skill	sonnet	完全隔离
会话内并行	subagent-teams skill	顺序执行	haiku-sonnet	Task 工具
进度跟踪	TaskCreate/TaskUpdate	TodoWrite	—	原生 UI 加载动画
团队协调	TeamCreate + SendMessage	subagent-teams skill	haiku-sonnet	共享任务列表
Git 工作流	git-workflow skill	general-purpose	haiku	提交、PR
Skill 编写	extension-authoring skill	general-purpose	sonnet	Skills、hooks
项目规划	planning-prompts skill	Plan agent	sonnet	元提示词
成本跟踪	cost-metering skill	手动跟踪	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

---

模型等级指南

等级	模型	每 100 万输入的成本	最适用于
快速	Haiku 4.5	$1.00	搜索、分类、审查、简单任务
标准	Sonnet 4.6	$3.00	代码生成、推理、大多数任务
高级	Opus 4.6	$5.00	架构、复杂决策、规划
免费	TaskCreate	$0	进度跟踪（本地 UI，不是 API 调用）

默认使用 Sonnet，除非：

• 任务是搜索/分类 → 使用 Haiku（便宜 5 倍）
• 任务需要深度推理 → 使用 Opus（能力强 5 倍）
• 任务是进度跟踪 → 使用带有 activeForm 的 TaskCreate，显示实时加载动画（零成本）

交叉引用： 会话内并行 Agent 参见 subagent-teams，worktree 隔离的并行 Agent 参见 agent-teams。

深入了解： 参见 reference/matrix-table.md、reference/selection-flowchart.md

写入结果 Sidecar 文件

最后一步，将内容写入 ~/.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"。