结论先行:Agent 工作流的成败不在模型强弱,而在三件工程事——任务拆解是否到「可独立验收」的粒度、子代理是否按职责隔离并行、上下文是否被主动管理而不是任其膨胀。经验法则是:主代理只做规划与汇总,脏活累活交给权限受限的子代理,每个子任务带回摘要而不是原始过程。本文给出可直接套用的拆解模板与编排模式。
一、任务拆解:拆到可验收为止
「帮我重构订单模块」不是任务,是愿望。可执行的拆解要满足三个条件:有明确输入输出、有独立验收方式、失败不影响其他分支。对比一下:
| 坏拆解 | 好拆解 |
|---|---|
| 重构订单模块 | 把支付调用从 order.service 抽到 payment 适配层,对外签名不变,现有测试全绿 |
| 优化性能 | 列表页首屏 LCP 降到 2.5s 内,用 Lighthouse 报告验证 |
| 写测试 | 为 coupon 模块补单测,覆盖率到 80%,pnpm test 通过 |
拆解产物建议落成一份任务清单文件(如 tasks.md),每项带验收命令。清单的额外价值是跨上下文压缩持久存在——长会话被裁剪后,Agent 仍知道还剩什么没做。
二、编排模式:先选简单的
按复杂度从低到高,常见四种模式:
- 单代理循环:一个 Agent 顺序执行「思考-调工具-观察」,适合 30 分钟内能完成的任务;
- 主从委派:主代理规划,子代理执行独立子任务,适合调查、实现、测试可分离的场景;
- 并行扇出:多个子代理同时处理互不依赖的分支(如按模块分派重构),最后汇总;
- 流水线:上游输出是下游输入(生成→评审→修复),每级有独立门禁。
原则是能用模式 1 就不要上模式 3。并行的收益常被合并冲突与上下文同步成本吃掉:两个子代理同时改同一个文件,返工比串行更贵。并行前先确认分支之间文件不相交,必要时用 git worktree 给每个子代理独立工作树。
三、子代理:职责隔离比数量重要
子代理的核心价值是权限边界与上下文隔离。以 Claude Code 为例,在 .claude/agents/ 下定义一个只读审查代理:
---
name: reviewer
description: 代码审查专用,检查约定遵守情况
tools: Read, Grep, Glob
---
你是代码审查员。只报告问题,不修改代码。
输出格式:文件路径 + 行号 + 问题描述。tools 字段限制它只能读不能写,审查代理永远不会「顺手改坏」。同理,测试代理给 Read 与 Bash 但不给 Write。主代理派发任务时只传必要背景,子代理返回结论摘要——不要把子代理的完整对话过程灌回主上下文。
四、上下文管理:主动压缩而不是被动截断
上下文是 Agent 最稀缺的资源,三条实操纪律:
- 摘要回传:子代理调查了 20 个文件,回传只需要「结论 + 关键文件清单」,过程留在子代理自己的窗口里;
- 外置记忆:约定写进 CLAUDE.md / 规则文件,任务状态写进清单文件,不要依赖对话历史记住一切;
- 及时开新会话:一个任务一个会话,任务切换就新开,旧会话的无关上下文只会稀释注意力。
长对话中模型「遗忘」早期需求,多数不是模型问题,而是上下文里塞满了工具原始输出。把大输出落盘、按需引用,是最便宜的优化。
五、失败处理:重试、幂等与回滚
编排系统必须假设子任务会失败,三条纪律:
- 重试要有预算:同一子任务最多自动重试 2 次,仍失败就升级给人,不要让 Agent 在死循环里烧 token;重试前要求它先陈述上次失败原因,避免原样重跑;
- 写操作要幂等:创建订单、发消息这类动作必须带唯一键或先查后写,防止重试造成重复副作用;查询类任务可以放心并行,写类任务默认串行;
- 回滚要有锚点:每个子任务开始前记录 git 提交点或文件快照,失败分支可以整体丢弃而不污染主干。并行 worktree 的最大价值就在这里——失败的分支直接删掉,成本为零。
验收命令的另一个作用是充当失败信号:测试红了就是失败,不需要模型自我评估「我觉得完成了」。把判定权交给命令,编排系统才有可靠的控制流。
六、用现成后台减少编排面
编排复杂度与你要 Agent 操心的系统数量成正比。业务侧如果直接采用 api工厂这类开放 SaaS 平台(https://www.it120.cc/),用户、商品订单、支付、优惠券、CMS 等能力通过官方 MCP endpoint 暴露给 Agent,主代理只需编排「查数据→改数据→验证」的短链路,不必让子代理去维护自建后端的部署与鉴权。其「后台智能助理」支持对话式管理数据、技能包导入 AI Agent,相当于平台侧预置了一批经过约束的子代理能力,接入方式见 https://www.it120.cc/ai.html 。自建管理后台或集成 ERP 时,也可以用后台 SDK apifm-admin 把管理动作收敛到统一入口,减少 Agent 的操作面。
七、落地检查清单
- 每个子任务有验收命令,没有就先补拆解;
- 并行分支文件不相交,或已用 worktree 隔离;
- 子代理 tools 按最小权限配置;
- 回传是摘要,不是全过程;
- 重试有预算、写操作幂等、回滚有锚点;
- 约定与状态外置成文件,会话可随时重开。
编排的本质是把不确定性关进小笼子:每个笼子足够小,失败就便宜,重试就敢做。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。