news 2026/10/23 6:28:45

如何写 Skill 第7课,子 agent 派工:买的是干净,不是人手

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
如何写 Skill 第7课,子 agent 派工:买的是干净,不是人手

摘要:skill 里的活不必都由主对话自己干:产出大或脏、能自足收工的活可以派给子代理,它带着全新上下文干活,主对话只收结论。派工不是雇人手,是买干净,付 token,买隔离。本文用四问把这笔交易算清:何时值得派、派给谁、纸条怎么写、给多大权限,每问配判据、反例和你装机里查得到的实名标本,收在一张能照着填的工单上。

1、开场:两个人吵起来了

先接一句原话当靶子。2025 年 6 月 12 日,Cognition 的 Walden Yan 发了篇《Don’t Build Multi-Agents》,这句我 2025 年里到处撞见:

running multiple agents in collaboration only results in fragile systems

(Cognition《Don’t Build Multi-Agents》,2025-06-12,反方原话)

第二天,Anthropic 工程博客甩出正方答卷,晒的是自家研究系统的评测:

a multi-agent system with Claude Opus 4 as the lead agent and Claude Sonnet 4 subagents outperformed single-agent Claude Opus 4 by 90.2% on our internal research eval.

(Anthropic《How we built our multi-agent research system》,2025-06-13,正方原话)

三天后,LangChain 的 Harrison Chase 出来劝架,留下那句我时间线上最常见的调停,“read actions are inherently more parallelizable than write actions”,读活天然比写活好并行(LangChain 博客,2025-06-16)。更早的祖训立在 2024 年 12 月:Anthropic 在《Building effective agents》里劝人 “finding the simplest solution possible”,复杂度要证明划算才加(官方工程博客,2024-12)。

我本以为这一架总得有个胜者。2026 年 4 月去翻,反方自己先动了:还是 Cognition,还是 Walden Yan,续篇承认当今世界上跑着的多 agent,大多数就是只读子代理:

most multi-agent setups in the world are limited to ‘readonly’ subagents, like web search subagents and code search subagents.

(Cognition《Multi-Agents: What’s Actually Working》,2026-04-22,反方反转)

先自限:这场博客骂战,样本是人家内部的 eval,一场骂战代表不了你手头的活,两边原话都不能直接外推到你的工位。但两边也都不全面:反方开火时没分读活写活,转发正方的人只晒 90.2% 的标题,不提同一篇文章里的 15 倍 token。到 2026 年,两边实际站到了同一处:读活派出去,写活单线程,判断留在主对话。我备这一课时翻到的二手文章,大多还停在 2025 年互撕,这篇从合流点讲起,不站队。

合流处正好是本文的东西。子代理是一个上下文分身:全新上下文,token 从零计,主对话一个字不沾,干完只往回交一份结果。派工不是雇人手,是买干净:买的是干净,不是人手。买卖就有条款,一共四条:什么时候值得买,买谁的脑子,纸条怎么写,给多少钥匙。纸条,指派工时随单递给子代理的任务指令。下面四问,一问一个条款。

2、第一问:什么时候值得派(条款一)

派工是拿 token 买隔离,隔离换来的价值大于 token 成本,这一单才值得签。总纲之下四个判据:隔离、并行、工种、后台。官方文档给的判据和我记账记出来的,几乎同一张清单。

2.1 官方和我的判据对上了

官方的场景描述是这句(官方文档 Create custom subagents,2026-10-16 现查):

Use one when a side task would flood your main conversation with search results, logs, or file contents you won’t reference again.

产出大或脏、主对话只要结论的活,派。四判据展开:隔离,产出大或脏,主对话只要结论;并行,多路独立互不依赖;工种,只读探查派只读工种,启动上下文小;后台,长任务扔后台不等它。我课程的教学装置就是这么搭的:5 个子代理各跑各的查询,主对话只收 5 份判决,隔离和并行同题同验(本机实验)。官方连口令都给了:研究就说 “use subagents to investigate X”,验收就说 “use a subagent to review this code for security issues”(官方 best-practices 文档,2026-10-16 现查)。

四判据里最值钱的是并行,最容易滥用的也是并行。官方上限是这么写的:默认 20 个子代理同时在跑,再 spawn 直接报Concurrent subagent limit reached(官方文档,2026-10-16 现查)。写 Java 的都熟,这就是线程池打满走拒绝策略,maxPoolSize 从来不是让你顶格用的。Anthropic 给过更实用的 effort 量尺:简单事实核查 1 个子代理、3 到 10 次工具调用;对比类 2 到 4 个子代理;10 个以上留给复杂研究(Anthropic 工程博客,2025-06-13)。读活优先的逻辑,就是开场那句调停:读活天然比写活好并行。

2.2 反判据要精确到“判断”两个字

什么时候别派,比什么时候派更值钱。官方列了三条:需要频繁来回迭代的、快速小改动、延迟敏感(官方文档,2026-10-16 现查)。agent teams 文档再补三条:顺序任务、同文件修改、强依赖多的活。原文是:

For sequential tasks, same-file edits, or work with many dependencies, a single session or subagents are more effective.

(官方文档 Orchestrate teams of Claude Code sessions,2026-10-16 现查)

我自己添的一条最容易被读歪:判断型 skill 不派。检查单、路由表、质量红线是注意力活,唯一看过全局的是主对话这个脑子,派出去等于把它换成只拿纸条的陌生人。装机盘点为证:tdd 38 行、pr 163 行,两个判断型技能零脚本零派工,判断全在主对话做(本机盘点,2026-10-16)。名单里没有 code-review:它同样 87 行判断型,却是第 4 问要讲的派工范本,反判据按活判,不按家族判。

但这句话必须精确到“判断”两个字,别泛化成“带判断的活都不能派”。matt pocock 的 grilling 是现成反例,里面写着:需要查环境的事,派子代理;能自己查的别问用户;别阻塞(grilling/SKILL.md,本机在装)。判断不外派,事实检索照样该派,两件事别捆着。

2.3 三笔真实账单

隔离值多少钱,得看账单。我实测三笔(本机记录,n=1):5 跑并行的触发批测约 87 万 token,4 跑全文审计约 66 万,4 跑技能体检盲测约 153 万。三个数各回答一个问题:批测买的是触发层的证据,审计买的是不被摘录骗到的结论,盲测买的是没有先入为主的体检结论。钱是真的,换回的干净也要是真的,对不上就别派。账本后来又添了一小笔:23 万,花在验证一件具体的事上,第 6 节再报。

Anthropic 把成本讲得很冷峻:

Multi-agent systems work mainly because they help spend enough tokens to solve the problem.

(Anthropic 工程博客,2025-06-13)

同一篇给了倍数:多 agent 系统的 token 用量大约是普通对话的 15 倍。Willison 路转粉时点破的收益也在这:并行买的主要不是速度,是容量,原话 “The key benefit is all about managing that 200,000 token context limit”(simonwillison.net,2025-06-14)。所以判据收成一句:隔离价值大于 token 成本才派。倒过来读就是劝退清单:换不来干净、付不起 token、等不起延迟,都别派,主对话直读或顺序委派更便宜。IT杨秀才在知乎专栏里把这条说得更狠:能用主代理直接完成或靠顺序委派解决的任务,就优先不要并行(《Claude Code Vibe Coding 实战手册(四)》,2026-06-30)。

3、第二问:派给谁(条款二)

九成的活,内置三工种就够。自定义 agent 留给每周都派的同一种活,那是开固定岗,不是买人手。

3.1 内置三工种

官方内置三个工种(官方文档,2026-10-16 现查)。Explore 只读,Write 和 Edit 直接拒,还刻意不加载 CLAUDE.md 和 git status,检索力度分 quick、medium、very thorough 三档;Plan 只读调研;general-purpose 全工具。工种决定权限面,权限面决定它闯得了什么祸。

模型选择还有一条解析序:调用参数优先,其次定义文件,再环境变量,最后跟主对话一致(官方文档,2026-10-16 现查)。工种可以在下单那一刻换,不用为每个模型档位单开一个岗。

3.2 自定义 agent 是开固定岗

自定义 agent 是.claude/agents/下的一个 md 文件:项目级盖过用户级,name 和 description 必填,正文就是它的 system prompt,字段约 24 个(官方文档,2026-10-16 现查)。劝退清单放在前面:

  • 一次性活别建,纸条点名内置工种更便宜;
  • 低频活别建,每月一次养不起一个岗;
  • 探索期别建,需求还在漂,固定岗是负资产。

本机我的用户级和项目级 agents 目录双双为空(我实测,2026-10-16),前面六课的实验零自定义 agent,照样走完。值得开岗的活长一个样:每周都来,每次同一工种,每次同一套权限。这时就把纸条写成定义文件,预载和权限一次配好,比每次手写省。决策句:别为派工先造 agent,内置三工种覆盖九成。

3.3 生态里的真实工种表

真岗长什么样,官方仓库有现成的(以下均为一手仓库,2026-10-16 核对):

  1. anthropics/claude-code-action 的.claude/agents/下 5 个审查 agent 按工种分文件,security-code-reviewer 的 tools 里没有 Write 和 Edit,model 写 inherit。
  2. anthropics/claude-cookbooks 的 code-reviewer 把权限给到命令粒度:tools 里出现Bash(git status:*)这样的条目。
  3. VoltAgent/awesome-claude-code-subagents 自述 161 个 agent,三档模型路由:架构规划配 opus,开发配 sonnet,文档配 haiku(README 自述,未逐个核文件)。
  4. wshobson/agents 自述 192 个 agent 打包成插件市场,跨多家 CLI 复用,是把岗位当商品卖的形态。

社区起名还有一个默认词表:reviewer、verifier、debugger、planner。中文圈的 hepingfly 给过最朴素的口令样本:“请用 senior-code-reviewer 帮我检查刚提交的代码”(掘金,2025-08-07)。官方文档另有一句给招聘启事加流量的诀窍:description 里写 “use proactively” 这类话术,能鼓励模型主动派(官方文档,2026-10-16 现查)。学归学,别照单全收:VoltAgent 和 wshobson 那两家是市场形态,你的项目不是市场。先数自己每周真派的活,数不出三个,别逛超市。

4、第三问:递什么纸条(条款三)

纸条是微型 description 写作:第 1 课你给菜单写过几行描述,这一问把同一门手艺用在派工单上。先交代为什么重锤这问:备这一课时,学员自发复述了四问,前两问答得顺,纸条和权限两问集体失忆(会话记录,2026-10-16)。MindStudio 拆 split-and-merge 模式那篇给过一句狠话:

Underspecified sub-agent instructions: The most frequent failure mode.

(MindStudio 博客,二手,已核对原文)

纸条含糊是多 agent 文献里的最高频失败模式,这一论断没人争。

4.1 四件套,和官方撞车了

我的四件套:目标、边界、返回格式、留痕。

  • 目标要可判定:"统计 X 目录下 md 文件数量"算,"看看有什么"不算;
  • 边界写明只读还是可写、不许碰什么;
  • 返回格式压成结构化两三行,散文等于隔离白买;
  • 留痕要求报告工具调用路径,否则整单不可观测。

四件套不是标准答案,是防坑下限:小事一张两行纸条够用,别一上来写成需求文档。

写完四件套去翻 Anthropic 的博客,撞车了:

Each subagent needs an objective, an output format, guidance on the tools and sources to use, and clear task boundaries.

(Anthropic 工程博客,2025-06-13)

目标、输出格式、工具指引、任务边界,两边独立收敛到同一张清单。不是巧合,是同一个教训的两种记法。反面案例正方自己给过:一个子代理在研究 2021 年的汽车芯片危机,另外两个在重复调查 2025 年的当下供应链(同上,2025-06-13)。中文圈也独立收敛过:杨林伟在 CSDN 的指南里要求"每个 Agent 定一个’硬输出格式’,否则主对话难以汇总结果"(2026-01-13)。

description 长短那桩公案顺带摆在这。先说清:这里说的是触发路由用的那个 description 字段,不是纸条。官方文档说 “Those descriptions take up context, so keep them short.”(2026-10-16 现查);IT杨秀才建议写 150 到 200 词并写明何时触发(知乎,2026-06-30);Anthropic 自家仓库 security-code-reviewer 的 description 带大段触发例句,远超"短"(一手仓库,2026-10-16 核对)。文档说短,示例做长。我的读法:这层没有真理,判据是触发面准不准,路由行短,触发例句全。

4.2 全文还是指针

递料有两极。matt pocock 的 code-review 是贴全文极:

the smell baseline from step 3 pasted in full (the sub-agent has no other access to it)

(code-review/SKILL.md,matt pocock 系列,本机在装)

implement-spec 是给指针极:

Communication to and from subagents should be sparse. Communicate primarily through context pointers.

(implement-spec/SKILL.md,matt pocock 系列,本机在装)

两极不矛盾,判据一句:子代理拿得到吗。盘上有文件,给路径;东西只在主对话上下文里,比如刚吵完还没落盘的口径、没写进任何基线的结论,必须贴。MindStudio 的自包含纪律是同一件事的狠话版:假设子代理除了你告诉它的,什么都不知道。

code-review 自己就是并行范本:描述行预告双轴并行(standards 与 spec 两轴),正文直接给两份纸条模板,Spec 缺失就跳过该轴并注明,失败分支有出口。Anthropic 被电话游戏坑过,多级传递丢信息,他们的修法也是让子代理把结果写文件、只回引用(Anthropic 工程博客,2025-06-13)。给下游服务发请求,你不会指望它读你的堆内存,参数不全就是空指针,纸条同理。

4.3 一张真实纸条的解剖

盘标本的规矩先交代一句:grep 到 “subagent” 不等于真派工。我装机全量 grep 命中一批,人工剔除三连假阳性:教人 “delegate to a community” 的是委派给人类,工单路由里"不可委派"说的是流程分派,代码结构里的"委托"是设计词汇,全都不是派工;真标本剩 7 处(code-review、implement-spec、wayfinder、brainstorming、grilling、control-browser、requesting-code-review,本文逐一拆)。还有的派工指令根本不住 skill 正文,写在宿主系统提示里(本机盘点,2026-10-16)。

然后是实验。我做过一次双标本差分实验(我实测,n=1):同构任务两单。实验组纸条写全四件套,里头有一句"不许直接读目录代答",子代理到最后也没派出人,如实回报"派工=否"(为什么没派出,第 6 节见分晓),但它守住了边界,没有自己偷偷读目录代答,边界件真的拦得住。对照组明令禁止派工,它就亲自把活干完,按约定的三行格式交差,一行没多。两臂都是正结果:一张验了纸条的边界件,一张验了禁令本身管用。

生态里还有一句话给全三样的写法。superpowers 插件的 requesting-code-review 写着:

“Use Task tool withgeneral-purposetype, fill template atcode-reviewer.md”

工具、工种、纸条模板一次点名(superpowers 5.1.0,本机在装)。顺带钉版本:Task 是 Agent 工具的旧名,v2.1.63 起更名(官方文档口径,2026-10-16 现查),旧名至今仍通。

wayfinder 里有点名句式可抄:研究票 “Resolved by a subagent that calls the Skill tool with ‘research’”(wayfinder/SKILL.md,本机在装)。翻成操作就是纸条里一句"调用 Skill 工具加载 research,按它执行"。调用侧没有按次指定 skill 的参数,这就是等效姿势,下一问细说。

5、第四问:给多少钥匙(条款四)

钥匙三把:预载管看见,tools 管调用权,照做归模型。第三把看着不像钥匙,它的样子就是一张写得够好的纸条。发钥匙之前先铺路:skill 的内容进一个子代理的上下文,一共三条路。

5.1 三条路与三把钥匙

三条路是三种进法。预载,出生第 0 轮正文全文进上下文,每次出生必付;触发调用,子代理第 N 轮自主决定,平时只花一行描述的钱;纸条点名,子代理第 N 轮照你纸条里的指示执行。写 Spring 的可以这么记:预载是构造器注入,出生就带;触发调用是 getBean,要用才取;点名是调用方把实例递过来。三条路的发起人不同,混同了就会问出"配了 skill 它怎么不自动用"这种问题。

预载字段的官方原话:

Skills to preload into the subagent’s context at startup. The full skill content is injected, not only the description.

(官方文档 Create custom subagents,2026-10-16 现查)

丑话两句。第一句:skills:不是白名单,官方原话 “It only controls preloading”,清单外的 skill 子代理照样能经 Skill 工具调到,除非把 Skill 工具本身收走。第二句:注入不等于照做,预载进去的资料袋,子代理照样可能翻都不翻,第 2 课讲过的老话在子代理身上同样成立(会话答疑里复核,非实测)。

钥匙二在这问里只点名不展开:tools 与 disallowedTools 一白一黑、先黑后白,permissionMode 管批准模式,字段全表在官方文档,记住它管的是调用权就够。

默认上下文有桩公案得钉死。官方现行口径:

子代理只拿 system prompt 加工作目录这类环境信息,看不到主对话历史(官方文档,2026-10-16 现查)

knqiufan 那篇拆解则说子代理会 fork 主上下文,能看到之前聊的(博客园,约 2026 年初)。两边不可同真,机制随版本漂移过;knqiufan 说的可能就是 fork 型子代理,那类确实看得见历史。我按 2026-10-16 现查的官方口径讲。

fork 本身官方文档有,指继承全部对话的那种子代理。官方 skills 文档提醒它的正文必须自足,原话

“instructions have to stand on their own”

还注明 background 默认 true,想前台等结果要 v2.1.218+。本机 fork 零支持,第 5 课矩阵的结论到今天没变(我实测复现),手工等效姿势是对话里直接说"派一个 XX 子代理"。

5.2 32 的事:官方常数与静默截断

这问有学员追到底过,四个问号连发:“skills: 注入的是前 32 个 skill 的全文,这个是什么意思?什么时候注入?谁加载?为什么是 32 个呢?”(会话原话,2026-10-16)挨个答。字段住在 agent 定义文件里,不在 SKILL.md;注入时机是出生第 0 轮,先于任务书;加载的不是模型,是运行时装配,模型只见装配成品;32 是官方给的常数,为什么偏偏是 32,文档没说,我也没想通。

上限本身讲得通:正文全文乘每次出生,不设上限就是上下文炸弹。要命的是超出的部分:前 32 之外静默不注入,找不到或被禁的也只留 debug 级警告,第 6 课的静默家族又添一员。所以清单要排序,最重要的写前面。

常数别当学问供着。并发上限官方说 20(2026-10-16 现查),MindStudio 说 10,knqiufan 建议 10 到 15,三个数三个来源并排摆着(2026-10-16 核对)。20 是当前版本的拒绝阈值,10 和 15 是经验值,谁也回答不了"你该开几个"。你该开几个,第一问的判据说了算。

5.3 死锁与反边界

有一类活派出去就是死锁:干到一半要问人的活。子代理天生没有问询类工具,批准机制官方把话说死:

No agent message counts as user approval for permission prompts.

(官方文档 Create custom subagents,2026-10-16 现查)

机制上这是真死锁:单轮授权不随派工带进子代理,问询工具又被收走,它等一个永远不会来的批准,主对话还不知道它在等。Java 里这就是两个事务互等对方的锁,死得干干净净。药方三条:

  1. 要人拍板的判断环节,留回主对话收尾,别写进纸条。
  2. 真要固定岗干敏感活,在 agent 定义文件里配好权限,别赌单轮授权。
  3. 路径一律${CLAUDE_SKILL_DIR}绝对编址,不赌子代理的工作目录。

反边界再添一条:会话绑定的工具不能派。browser-use 插件的 control-browser 描述里写死:

Main-agent-only…must not delegate it to a subagent; subagents must not load this skill

(browser-use 0.4.2 control-browser/SKILL.md,本机在装;0.5.1 起收紧成一句 “Main agent only.”,边界没松)

浏览器会话有状态,派出去等于把已登录的会话交接给一个新工人,线当场断。这条和"判断型不派"并列记,都是花钱买不来的教训,写在别人的描述里,便宜。

6、反方与边界:派工的三道锁

前四问要成立,有一个共同前提:你的活在那条合流路线上。这一节上三道锁,锁的全是适用域。工种在这儿指活的种类:读活、写活、判断活。原则有适用域,工种决定答案。

6.1 反转之后:可行形状有了名字

反方的最新立场先摆。Cognition 2026 年 4 月给可行形态起了个名字,map-reduce-and-manage:管理节点拆活,子节点执行,管理节点综合汇报;无结构 swarm(一群 agent 互相谈判那种)被他们自己降格为干扰项。写操作至今不让并行:

multi-agent systems work best today when writes stay single-threaded and the additional agents contribute intelligence.

(Cognition《Multi-Agents: What’s Actually Working》,2026-04-22)

对并行写的警惕他们也有原话:“Parallel agents make implicit choices about style, edge cases, and code patterns”。写并行这桩悬案我自己裁:官方姿势是/batch把改动拆给 5 到 30 个子代理,各占一个 worktree(git 的多工作树,互不踩脚;官方 best-practices 文档,2026-10-16 现查);Cognition 至今不点头;LangChain 说读活天然好并行。worktree 能不能让写并行划算,两边没对过账。我的账单里没有一笔写并行,裁决是:读活先派,写并行等我真有需求再验。

审查工种两边反而会师了。官方说新鲜上下文的审查者只看 diff 和判据,原话 “A reviewer running in a fresh context sees only the diff and the criteria you give it.”,还把这事列成收工前标准动作:“have a subagent review the diff in a fresh context and report gaps”(官方 best-practices 文档,2026-10-16 现查)。Cognition 一代目说共享全部上下文,二代目自己修正:审查和编码 agent 事先不共享任何上下文,效果反而最好(2026-04-22)。当年最反对隔离的人,在最吃隔离的工种上承认了隔离的价值。matt pocock 的 brainstorming 里的 Builder check 是同款动作:派一个全新子代理当独立验收员(brainstorming/SKILL.md,本机在装)。

6.2 第二道锁:失败分类学,知道会怎么死也是锁

失败不是段子,是分类学。MAST 论文(UC Berkeley 等,arXiv:2503.13657,2025-03-17)把多 agent 失败收成三类十四种。先划来源边界:分类框架我在结构层面核对过,具体条目没有逐条验。正方也自己晒过伤疤:早期系统给简单查询派出 50 个子代理,满网找不存在的源,互相刷屏(Anthropic 工程博客,2025-06-13)。

第一问没进表,因为它兜的是底:根本别派,就没有 MAST 失败。三类对下来,四问不是四个招式,是三张网加一个验收动作。正方那批 50 子代理事故的修复补丁,正是 effort 量尺和纸条四件套;电话游戏的修法(结果落盘、只回引用)正是 4.2 的指针极。反方檄文里有个现成例子:让人派两个子代理做 Flappy Bird,一个把背景搭成了马里奥,归档进 specification 也没问题。

6.3 第三道锁:本机现实,嵌套派工不可用

第三道锁在我自己机器上。另一次双标本差分实验,嵌套差分(我实测,n=1,2026-10-16,两跑约 23 万 token;不是 4.3 那一次。测试机是 Windows 11 上的 ZCode,两份标本就是两张 SKILL.md 纸条,一份指示派、一份禁止派,留在我的项目 .zcode/skills/ 里,想复现照抄形态即可):对照组被明令禁止派工,全程亲自 Bash 加 Read 完成,按三行规范交差;实验组经 Skill 调用的 general-purpose 子代理,自报工具列表里没有 Agent 工具,TOOLS 留痕也未见二次派遣。两组证据合起来:嵌套派工本机不可用,派工只有主对话一层。官方文档写嵌套默认 3 层(2026-10-16 现查),在这台机器上不成立。官方规范是上限不是保证,这已经是 fork 零支持之后同族第二例(第 5 课)。

实验组卡住的地方,brainstorming 里有现成的降级句:“Without a subagent tool, read the document as that builder yourself”(brainstorming/SKILL.md,本机在装;builder 指那名按建造者视角读文档的自己)。写 skill 时给自己留这句退路,你的技能在没得派的机器上照样能跑。可移植写法,永远比赌运行时便宜。

7、收束:想/派分界,和一张你可以带走的工单

第 4 课讲过想/做分界,这一课补后半句:想/派分界,判断留下,执行派出。第 1 课讲信息分三层进上下文,这一课加了新维度,上下文分身:主对话保干净,脏活在分身里烧 token。四问连起来就是一张工单,抄成四行空表就能用:判据__、工种__、四件套__、钥匙__,填满再派。

开头那架吵到今天,处方其实已经合流:正方教你 1 个、2 到 4 个、10 个以上的 effort 量尺,反方承认只读子代理满世界都是。读活派,写活单线程,判断留下。当年那句"别建多 agent",今天该读成:别把判断派出去。

留个现在就能做的练习,拿你手头一个真实任务:

  1. 输入:你最近想让子代理干的那个活,写出它产出的大头和主对话真正需要的那一行。
  2. 执行:照四件套填一张纸条,目标、边界、返回格式、留痕各一句。
  3. 验收:自检三问,判定可检查吗,边界堵扩权吗,返回格式能直接消费吗,三问全过再派。

交代一句出身。这篇的盘点、检索、成稿,是我自己那条生产级写作管线派工产的:素材过 5 个文件才派盘点子代理,并发顶格 4 个,派遣按角色、任务、交付三段写,子代理装载 skill 分预载和显式调用两级。买没买到干净,你刚读完的这篇就是样本。

带走三样

  1. 派工买的是主对话的干净,不是人手。隔离价值大于 token 成本才派:判断留下,事实检索照派;顺序任务、同文件修改、要中途问人的活,别派。工种九成内置三选一,每周同一种活才值得开固定岗。
  2. 纸条四件套:目标可判定,边界堵扩权,返回格式结构化,留痕报路径。子代理拿得到盘上文件就给指针,只在主对话上下文里就必须贴全文。
  3. 三把钥匙各管一段:skills:预载只管看见,前 32 个正文全文注入,超出静默截断,清单最重要的写前面;tools 管调用权;照做归模型。

临走三问

  1. 一个 200 行的检查单技能,同事建议改成"每轮派个子代理去跑检查,显得工程化"。跑了一个月,token 翻了几倍,缺陷检出率没动。凭记忆说:这一单从哪个判据开始就不该派?
  2. 你派子代理盘点某模块的技术债,主对话里刚和同事吵出三条口径,还没落进任何文件。纸条里这三条口径该贴全文还是给路径?判据是哪一句?
  3. 你给子代理的活干到一半需要人拍板,你在等它来问,它也在等一个永远不会来的批准。凭记忆说:它天生缺哪类工具?这一单最后该谁来收尾?

三道都答对了,这一课才算真的带走。

第 1 课写下第一个能跑的技能,第 2 课修触发,第 3 课磨正文,第 4 课接脚本,第 5 课对接口矩阵,第 6 课把五问拧成一句问诊顺序;这一课把想和派分开。下一课是第 8 课·多 skill 体系治理:会写一个技能,只算占了一个岗,一摊技能怎么不打架,从那儿开始。


共约 6458 字 · 阅读约 16 分钟
如果这篇文章对你有帮助,欢迎转发给需要的同事和朋友。
版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/10/23 6:26:20

PPA1510 功率分析仪:两台一起测怎么协同

Newtons4th 的 PPA1510 是一台功率分析仪。单台测功率没什么特别,但这台设备有个不太常见的能力——它自己就知道怎么跟另一台配合。驱动里的示例把这个用法专门做成了一个例子。为什么需要两台单台功率分析仪能测的通道数是有限的。当被测对象有多个端口——比如三…

作者头像 李华
网站建设 2026/10/23 6:26:19

ADK A2A协议深度剖析:从零搭建分布式智能体

ADK A2A协议深度剖析:从零搭建分布式智能体 【免费下载链接】adk-docs An open-source, code-first toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control. 项目地址: https://gitcode.com/GitHub_Trending/ad…

作者头像 李华
网站建设 2026/10/23 6:26:05

TMS FMX UI Pack 3.7.3.0:Delphi 10.4跨平台UI开发核心基建

简介:TMS FMX UI Pack 3.7.3.0 是一套专为 Delphi 10.4 Sydney 及兼容版本(XE7 至 10.3)设计的跨平台 FireMonkey UI 组件库,面向 Delphi 桌面与移动应用开发者,解决原生 FMX 组件样式单一、交互体验不足、多语言适配困…

作者头像 李华
网站建设 2026/10/23 6:24:53

Kubernetes Pod 服务别名解析失败排查:从 no such host 到 CoreDNS 根因定位

1. 从一个诡异的通信故障说起集群里跑着一套微服务,订单服务要调库存服务,库存服务要调商品服务,彼此之间全靠 Service 别名互相访问。某天做灰度发布,新拉起来的一批 Pod 突然报错,日志里清一色是no such host或者连接…

作者头像 李华
网站建设 2026/10/23 6:21:28

agents-generator - platform

{{PLATFORM_NAME}} 规则 — 模板 仅在项目中检测到相应平台时生成。各平台的检测信号如下。 此文件被封装在受管理的块中。代理在更新时会在标记之间重新生成内容&#xff1b;标记外的人为编辑将被保留。 <!-- AGENTS-GENERATED-START --> # {{PLATFORM_RULES_HEADER}}{{…

作者头像 李华