原创问题页

Sub-agent 看起来没起作用时怎么办

子代理没效果,很多时候不是“AI 不行”,而是角色没分清、任务没切开、给它的工具也不够。

你可以把它想成临时叫来的帮手。帮手不是越多越灵,分工不清、工具不齐、活派得太糊,它自然就像没帮上忙。

页面信息

作者

通俗版 Claude Code 文档维护者

最后更新

2026-03-21

所属系列

问题排查 / Sub-agent 与分工

第一步:先查角色说明

如果你连它是来干嘛的都没说死,它当然容易和主代理抢活,或者回成一锅粥。

角色写得越虚,它越容易变成“又来一个什么都想掺一脚的人”。

第二步:再查任务是不是切得太碎或太大

太碎它没事干,太大它接不住。最稳的是切成能独立交付的一块。

真正顺手的 sub-agent,通常都有一块明确地盘,而不是让它去“帮忙看一眼整个项目”。

第三步:最后查工具和权限

你让它查代码,却不给读工具;让它改东西,却不给写权限,那它怎么干都像没起作用。

帮手不是光靠嘴干活。你派它下地干农活,结果连锄头都不给,它当然只能站着看。

最常见的误判

最常见的误判,是把“分工没写清”误以为“sub-agent 没能力”。第二种误判,是让它背一整头牛的活,结果又嫌它走不动。

先定角色,再切任务,最后看工具和权限,这个顺序最不容易翻车。