Leçon n° 8 : Intégrer le modèle « Task/sous-agent » dans une Skill : limites du parallélisme et isolation du contexte
Objectif de cette leçon : vous saurez Task / 子代理(subagent) 模式写进 Skill 约定——哪些步骤允许并行、上下文如何隔离、结果如何合并——而不是在聊天里口头说「开几个子任务」。上一课你已经做过多 Skill 拆合与冲突仲裁:https://school.myshirtai.com/?p=4191。本课在仲裁之上,处理单 Skill 内部的并行与上下文隔离,并嵌当前 Claude Code Task/subagent 编排热点。不是再写一篇「要注意并发」的感想,而是今晚能提交的边界表、隔离清单与失败样例。
Introduction
请先完成第 7 课《多 Skill 编排:拆合边界与触发冲突仲裁》:https://school.myshirtai.com/?p=4191。你手头至少要有:可加载的目标 Skill、第 6–7 课评测钩子、仲裁表。若还缺更早基础,请回补:第 1 课 https://school.myshirtai.com/archives/3378; Leçon n° 2 https://school.myshirtai.com/archives/3462; Leçon n° 3 https://school.myshirtai.com/archives/3521; Leçon n° 4 https://school.myshirtai.com/archives/3661; Leçon n° 5 https://school.myshirtai.com/?p=3948; Leçon n° 6 https://school.myshirtai.com/?p=4048.
Liste des prérequis : disposer de droits d'écriture ou pouvoir soumettre des PR ; être capable d'utiliser Skill référence/ 或 README 增加「并行边界」节;评测可追加「子任务串扰」样例。没有真实并行失败日志,就用「两个子任务写同一文件」合成样例,不要空造和谐故事。

La boîte à temps : ce soir, vous n'avez que 90 minutesUn Skill 加 Task/子代理约定,不要一夜并行化全仓库。
概念:Task/子代理写进 Skill 前,先钉并行边界

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

- 声明并行边界表:existent
reference/parallel.md(文件名可自定)列出步骤、可否并行、最大并发、共享资源。PR 必审此表。 - 上下文隔离清单:每个子任务允许的输入字段(目标路径、只读摘要、禁止字段)。禁止把密钥、整份聊天记录塞进子任务。
- 合并协议:规定汇总者是父任务;冲突字段以谁为准;失败是否 fail-fast。
- Points forts et avis :干跑时打印「将启动的子任务数」;评测断言不超过上限,且写盘步骤未并行。
| 步骤类型 | 默认 | Attentes concernant l'évaluation |
|---|---|---|
| 只读检索 / 汇总 | 允许并行,上限 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"]}

Activités possibles ce soir :为 S-02 类样例跑出至少 1 次红灯,再靠边界表修到绿——确认门禁吃得到并行约定。
Erreurs et ratés (au moins trois)

- Skill 只写「可以开子代理」不写上限:额度与锁被打爆。处理:强制 max_workers 与评测。
- 子任务复制全量上下文:串扰与泄密。处理:隔离清单 + forbidden_keys 样例。
- 写盘步骤并行:文件损坏或隐性竞态。处理:副作用默认串行;钩子硬拦。
- 与第 7 课仲裁表脱节:父 Skill 点名后内部又触发另一 Skill。处理:子任务不得绕过仲裁;冲突样例交叉引用。
- 合并时静默丢失败:一只子任务红了仍报成功。处理:fail-fast 或显式 partial 状态。
Activités possibles ce soir :故意提一条「同时改同一配置文件」的句子,看干跑是否会并行写;若会,先加硬拦。
Exercices
- Choisissez une compétence, puis validez
reference/parallel.md边界表。 - 加至少 3 条 subagent 隔离/并行样例并跑绿。
- 在 SKILL.md description 增加 1 句:何时使用 Task/子代理、何时禁止。
- 与第 7 课仲裁表交叉链接一处(同一失败 id 或文档锚点)。
完成标准:同事只看 parallel.md 与评测,能说出最大并发与写盘是否可并行,无需私聊你。
Aperçu de la prochaine leçon
下一课预告:把 Task/子代理的并行边界与生产 trace 打通——如何从「子任务串扰」日志一键生成隔离样例、如何给高并发 Skill 加观察期与额度预算。本课先把离线边界表与评测跑稳;没有并行红灯,线上只会静默互踩。
Sommaire de cette série
- Leçon n° 1 : Créer en 30 minutes votre première compétence Claude Agent à déclenchement automatique — https://school.myshirtai.com/archives/3378
- Leçon n° 2 : Ajouter une référence à Skill / Boucle de vérification « rédiger le document de planification avant l'exécution » — https://school.myshirtai.com/archives/3462
- Leçon n° 3 : Skills avec script et audit de sécurité — https://school.myshirtai.com/archives/3521
- Leçon n° 4 : itération à partir de cas réels d'échec description — https://school.myshirtai.com/archives/3661
- Leçon n° 5 : Intégrer Skill au dépôt CI réel / au répertoire partagé de l'équipe — https://school.myshirtai.com/?p=3948
- Leçon n° 6 : Réalisation d'une régression pour une compétence à l'aide d'un ensemble d'évaluation — https://school.myshirtai.com/?p=4048
- Leçon n° 7 : Programmation multi-Skill : décomposition et fusion des limites, et arbitrage des conflits de déclenchement — https://school.myshirtai.com/?p=4191
- 第 8 课:把 Task/子代理模式写进 Skill:并行边界与上下文隔离(本文)


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