第 8 课:把 Task/子代理模式写进 Skill:并行边界与上下文隔离
本课目标:你会把 Task / 子代理(subagent) 模式写进 Skill 约定——哪些步骤允许并行、上下文如何隔离、结果如何合并——而不是在聊天里口头说「开几个子任务」。上一课你已经做过多 Skill 拆合与冲突仲裁:https://school.myshirtai.com/?p=4191。本课在仲裁之上,处理单 Skill 内部的并行与上下文隔离,并嵌当前 Claude Code Task/subagent 编排热点。不是再写一篇「要注意并发」的感想,而是今晚能提交的边界表、隔离清单与失败样例。
前置
请先完成第 7 课《多 Skill 编排:拆合边界与触发冲突仲裁》:https://school.myshirtai.com/?p=4191。你手头至少要有:可加载的目标 Skill、第 6–7 课评测钩子、仲裁表。若还缺更早基础,请回补:第 1 课 https://school.myshirtai.com/archives/3378;第 2 课 https://school.myshirtai.com/archives/3462;第 3 课 https://school.myshirtai.com/archives/3521;第 4 课 https://school.myshirtai.com/archives/3661;第 5 课 https://school.myshirtai.com/?p=3948;第 6 课 https://school.myshirtai.com/?p=4048。
材料清单:写权限或能提 PR;能在 Skill 的 reference/ 或 README 增加「并行边界」节;评测可追加「子任务串扰」样例。没有真实并行失败日志,就用「两个子任务写同一文件」合成样例,不要空造和谐故事。

时间盒:今晚九十分钟只给一个 Skill 加 Task/子代理约定,不要一夜并行化全仓库。
概念:Task/子代理写进 Skill 前,先钉并行边界

第 7 课保证多 Skill 抢触发时可仲裁。第 8 课补的是:同一个 Skill 被点名后,内部仍可能盲目开一堆子代理抢上下文、抢文件、抢工具额度。先回答四个问题:哪些步骤可并行?子代理默认只读哪些路径?结果谁合并?失败是否取消兄弟任务?
- 并行是成本决策:省墙钟时间 vs 烧额度/抢锁;默认从小并行度开始。
- 上下文隔离写进 Skill:每个 Task 只带必要摘要,禁止把整段会话原样复制 N 份。
- 副作用串行:写盘、发网、改共享状态默认串行或加锁;只读检索才并行。
- 验收进评测:至少 3 条「并行后结果应一致/应隔离」样例。
Claude Code 一类产品把 Task/subagent 当作编排原语;Skill 则负责把「何时用、如何限」写成可触发、可回归的约定。概念到此为止,下面直接做。
今晚可做的动作:打开目标 Skill 的 SKILL.md,标出你想并行的步骤与必须串行的副作用步骤,写成两列草稿。
分步实操:声明、隔离上下文、并行上限、验收钩子

- 声明并行边界表:在
reference/parallel.md(文件名可自定)列出步骤、可否并行、最大并发、共享资源。PR 必审此表。 - 上下文隔离清单:每个子任务允许的输入字段(目标路径、只读摘要、禁止字段)。禁止把密钥、整份聊天记录塞进子任务。
- 合并协议:规定汇总者是父任务;冲突字段以谁为准;失败是否 fail-fast。
- 钩子与评测:干跑时打印「将启动的子任务数」;评测断言不超过上限,且写盘步骤未并行。
| 步骤类型 | 默认 | 评测期望 |
|---|---|---|
| 只读检索 / 汇总 | 允许并行,上限 3 | 子任务数 ≤ 上限 |
| 写同一文件 / 改配置 | 串行 | 不得并发写同路径 |
| 网络副作用 | 串行或显式队列 | 无点名不得并行发送 |
| 上下文携带 | 最小摘要 | 子任务输入不含密钥字段 |
# evals/subagent_isolation.jsonl 示意
{"id":"S-01","utterance":"并行总结 src/ 下三个模块的 README","expect_parallel":true,"max_workers":3,"expect_write":false}
{"id":"S-02","utterance":"同时修改同一个 config.yaml 的两个键","expect_parallel":false,"notes":"写冲突应串行或拒绝"}
{"id":"S-03","utterance":"开子任务但不要带上 .env","expect_leak":false,"forbidden_keys":["API_KEY","TOKEN"]}

今晚可做的动作:为 S-02 类样例跑出至少 1 次红灯,再靠边界表修到绿——确认门禁吃得到并行约定。
报错与翻车(至少三条)

- Skill 只写「可以开子代理」不写上限:额度与锁被打爆。处理:强制 max_workers 与评测。
- 子任务复制全量上下文:串扰与泄密。处理:隔离清单 + forbidden_keys 样例。
- 写盘步骤并行:文件损坏或隐性竞态。处理:副作用默认串行;钩子硬拦。
- 与第 7 课仲裁表脱节:父 Skill 点名后内部又触发另一 Skill。处理:子任务不得绕过仲裁;冲突样例交叉引用。
- 合并时静默丢失败:一只子任务红了仍报成功。处理:fail-fast 或显式 partial 状态。
今晚可做的动作:故意提一条「同时改同一配置文件」的句子,看干跑是否会并行写;若会,先加硬拦。
练习
- 选一个 Skill,提交
reference/parallel.md边界表。 - 加至少 3 条 subagent 隔离/并行样例并跑绿。
- 在 SKILL.md description 增加 1 句:何时使用 Task/子代理、何时禁止。
- 与第 7 课仲裁表交叉链接一处(同一失败 id 或文档锚点)。
完成标准:同事只看 parallel.md 与评测,能说出最大并发与写盘是否可并行,无需私聊你。
下一课预告
下一课预告:把 Task/子代理的并行边界与生产 trace 打通——如何从「子任务串扰」日志一键生成隔离样例、如何给高并发 Skill 加观察期与额度预算。本课先把离线边界表与评测跑稳;没有并行红灯,线上只会静默互踩。
本系列目录
- 第 1 课:30 分钟写出第一个会自动触发的 Claude Agent Skill — https://school.myshirtai.com/archives/3378
- 第 2 课:给 Skill 加 reference/ 与「先写计划文件再执行」校验环 — https://school.myshirtai.com/archives/3462
- 第 3 课:带脚本的 Skill 与安全审计 — https://school.myshirtai.com/archives/3521
- 第 4 课:用真实失败用例迭代 description — https://school.myshirtai.com/archives/3661
- 第 5 课:把 Skill 接到真实仓库 CI / 团队共享目录 — https://school.myshirtai.com/?p=3948
- 第 6 课:用评测集给 Skill 做回归 — https://school.myshirtai.com/?p=4048
- 第 7 课:多 Skill 编排:拆合边界与触发冲突仲裁 — https://school.myshirtai.com/?p=4191
- 第 8 课:把 Task/子代理模式写进 Skill:并行边界与上下文隔离(本文)


评论列表 (0条):
加载更多评论 Loading...