AI编程新纪元：Subagent打造全能协作团队

上回咱们聊了Hook，那是给AI操作装上自动安检。

这回重点说说Subagent，这是AI协作里最具想象力的部分。

几个月前有个活儿，得给某个平台前后端搞一套全量的权限体系。

前端要搞路由守卫、动态菜单、按钮级权限；后端得设计RBAC模型、写中间件、给接口补鉴权。

活儿不小，当时不懂Subagent，但觉着Claude Code能行，就硬着头皮上了。

起初挺顺利，AI一路改，我一路看。

但到了后半程，上下文一长，AI就开始翻车。它忘了前面的数据结构，前后端字段对不上。同一个接口，前后逻辑打架。改前端组件时还顺手改了路由配置。

最后看diff，前后端混在一起，逻辑纠缠，根本没法审。

后来才明白：不是AI不行，而是一个AI扛不动这么大的活儿。上下文满了，前面的决定被忘，后面的操作跟前面冲突。活儿越大，越容易崩。

Subagent就是为了解决这个问题设计的。

说白了，Subagent就是从主AI里拆出来的“专属助手”。

它们有独立的上下文、系统提示、工具权限，甚至能用不同的模型。

主AI遇到合适的任务就委派，Subagent独立干完回传，不污染主会话。

这一系列一直用“新员工”比喻AI：

Rule是规矩，Command是操作手册，Skill是技能，Hook是安检。

Subagent，就是你的团队成员。

你是项目负责人，前端任务给前端Subagent，安全给安全Subagent，搜代码给探索Subagent。

每个Subagent各司其职。

很多人第一反应：这不就是多开几个Claude Code窗口？

表面像，但本质不同。

协调成本

新窗口：你得当中间人，复制粘贴，来回倒腾。

Subagent：主Agent自动委派、传参、收结果，不用你动手。

并行能力

新窗口：管几个窗口容易乱，你得记着它们在干嘛。

Subagent：主Agent可同时派多个，结果汇总，你只看结果。

上下文控制

新窗口：新会话空白，你得手动交代背景。

Subagent：主Agent打包传必要上下文，不带全部历史。

比喻：新窗口是你自己接电话传话；Subagent是团队，任务下去，结果汇报。

不用自己配，Claude Code内置了几个，会自动调：

Explore — 代码探索员

你让AI理模块结构或搜函数调用，它交给Explore去干。

结果回主AI，但搜索过程产生的中间上下文留在Explore那，不撑满主会话。

Plan — 规划师

你用/plan先规划再动手，背后是Plan在帮你读代码、理依赖。

General-purpose — 全能手

需要探索+修改的组合，比如“读懂模块并重构”，交给General-purpose。

不是所有活都适合拆Subagent。看这四个维度：

重复频繁：每天每个项目都遇到？比如代码审、文档、安全检。

上下文重：读大量文件，快速消耗主会话？

流程固定：步骤明确，每次做法差不多？

可并行：不依赖其他输出，能同时开工？

满足两个以上，就值得做成Subagent。

最直观的并行场景。

一个功能同时改后端API和前端组件，以前得串行等，现在两个Subagent并行跑。

前提：无依赖，不互改文件。

接手新项目，想先理结构。主会话翻文件会撑爆上下文，用Explore在它自己的上下文里梳理，主会话不动。

代码写完，让安全Subagent跑一遍。它不需要懂项目背景，只专注“找问题”。系统提示写好OWASP清单、JWT要点、敏感日志，它就是个比你更懂安全的专家。

这个和前面Skill类似，但Subagent独立上下文，审查过程不影响后续开发。

代码改完，让验证Subagent检查。主Agent改完自动触发，发现问题反馈修复。验证流程不消耗主会话。

这种“改完就验”的闭环，是Subagent价值所在。

遇到Bug，不确定根因。开多个Subagent，一个查网络，一个看认证，一个查库，一个看缓存。并行跑，比一个AI试错快。

有些活不急但不想停。文档、测试、分析丢给后台Subagent，Ctrl+B推后台，继续干你的事。

知道了能干嘛，先讲怎么用，再讲怎么造。

最省心：正常对话，Claude自己判断。比如“梳理函数调用”，Claude自动调Explore。

触发不触发，看Subagent的description。Claude匹配请求和description，觉得合适就委派。

想用特定Subagent，直接点名：

或者更自然的表达：

关键操作建议手动指定，别全靠Claude。

不想等，加句“在后台跑”：

Claude会启动后台Subagent，你继续干你的事。

用/tasks查后台任务，有结果再看。或Ctrl+B推后台。

想同时干，一次性交代清楚：

Claude会同时派两个Subagent，各自独立，你等最终汇报。

在Claude Code输/agents，打开交互界面。

选“创建新 Agent”，写提示或让Claude生成，定工具和模型，保存。

不用重启，立即可用。

Subagent是Markdown文件，放目录里：

文件格式：

两个字段必填：name（Subagent名称）、description（判断触发条件），以及正文里的系统提示。

Description写好是关键。

这段描述决定Claude何时调用。写清楚触发条件——“当用户说XX”“当遇到XX”——比只写功能有用。

自动还是手动？

Claude会自动判断，但关键流程手动，非关键自动，比较稳。

让Subagent用便宜模型

简单搜索、探索不用最强模型：

用Haiku跑探索，更快更省。

限制Subagent权限

只读审查不该有写权限：

写清楚“别做什么”

系统提示不光写该做什么，也要说边界。否则AI容易“好心办坏事”——功能跑起来，顺手改一堆不该改的。

比如这个代码简化助手，专门在功能完成后做清理：

有写权限，但提示约束只做简化、不改功能、不改风格。能力和约束配合——能力靠tools控制，行为靠提示约束。

让Subagent记跨会话知识

加memory字段，Subagent能在会话间积累知识：

Subagent不能派Subagent。

套娃不支持。主Agent能调Subagent，Subagent不能调另一个。任务只能拆一层。

并行前提：不依赖，不互改文件。

两个Subagent改同一文件，结果会覆盖。并行前想清边界——文件、模块边界。有依赖就得顺序执行。

Description别写太宽泛，会乱触发。

Claude靠description判断。写“帮我做任何代码任务”会导致全被委派，适得其反。写具体触发条件。

个人Subagent和团队Subagent分开放。

个人习惯放~/.claude/agents/，团队共用放.claude/agents/并提交git。

Subagent和Skill可配合。

创建Subagent时，用skills字段预加载Skill，Subagent启动就具备Skill能力。两者可叠加。

Claude Code官方文档

https://docs.anthropic.com/en/docs/claude-code/subagents

官方示例有模板（安全审查、API开发、代码审查），直接拿改。

GitHub

社区贡献，有Subagent分类，持续更新，量大质优。

你自己的Skill

如果你有不错的Skill，加上YAML的name、description、tools，它就能升级Subagent——独立上下文、可分配模型、可限制工具。

Rule让AI知规矩，Command封装流程，Skill装专业能力，Hook做自动检查。

Subagent让AI学会分工：复杂任务，不再一个AI死扛。

探索有探索员，安全有专家，前后端能同步——每个Subagent专注，主Agent汇总。

一个人扛，上限一个人。拆给团队，上限整个团队。

下一篇讲MCP：AI世界的USB接口，连上后AI能访问的东西会多一个量级。