Harness Supervisor模式完整指南中央Agent如何动态分派任务【免费下载链接】harnessA meta-skill that designs domain-specific agent teams, defines specialized agents, and generates the skills they use.项目地址: https://gitcode.com/GitHub_Trending/harness/harnessHarness Supervisor模式是 Harness 项目中 6 种核心智能体团队架构模式之一由一个中央 Agent监督者维护全局状态并根据进度与优先级动态分派任务给多个工作 Agent。它特别适合计划会在执行中变化的场景——事故响应、大规模代码迁移、探索式研究。本文面向新手用最少的心智负担讲清楚它如何工作、何时选择它、以及如何快速上手。什么是Supervisor模式中央Agent 动态分派在 Harness 的 6 大团队架构模式中Supervisor监督者的定位很清晰模式一句话说明流水线 Pipeline上一步输出喂给下一步严格顺序扇出/扇入 Fan-out/Fan-in任务预先固定地并行分发最后合并专家池 Expert Pool路由器按输入类型挑选专家生成-验证 Producer-Reviewer一个生成、一个质检循环到通过监督者 Supervisor中央Agent看进度运行时动态派活⭐层级委托 Hierarchical自上而下递归拆解目标Supervisor 模式与最容易混淆的扇出模式核心差别只有一点扇出是开工前就把任务固定分给每个成员Supervisor 是执行中观察每个成员的完成情况随时把新任务分给空闲的成员、或把失败的任务重新分配。这个区别来自 agent-design-patterns.md 中的模式定义官方给出的典型示例就是大规模代码迁移——监督者分析文件列表再逐个批次派给迁移工人。动态任务分派的5个步骤Harness 为 Supervisor 模式设计了一套与共享任务列表天然匹配的分派逻辑见 team-examples.md 中的代码迁移团队示例收集任务池— 监督者先摸清全部工作量例如收集所有待迁移的文件列表估算复杂度— 按文件大小、依赖关系等给任务估个轻重注册到共享任务列表— 用TaskCreate把每个批次登记为任务含依赖关系成员自行认领— 工作 Agent 空闲时从列表中自己 claim 下一个任务回报后动态调整— 成员用TaskUpdate报完成后成功则自动进入下一批失败则监督者发消息询问原因重新分配给其他成员[supervisor/领导者] → 文件列表分析 → 批次分配 ├→ [migrator-1] (批次A) ├→ [migrator-2] (批次B) └→ [migrator-3] (批次C) ← 收到 TaskUpdate → 追加批次或重新分配 正因为团队共享一个任务列表、成员可以自行认领Supervisor 模式在 Harness 中默认使用 Agent 团队模式运行——监督者通过TeamCreate组队、TaskCreate登记任务、SendMessage处理异常而不是靠主线程逐个喊话。实战示例代码迁移团队长什么样Harness 内置的示例 5 就是一个完整的 Supervisor 团队team-examples.md成员角色migration-supervisor领导者分析文件、分配批次、跟踪进度migrator-1 ~ migrator-3领取并执行自己那份文件批次运行时的完整闭环是监督者把全部文件拆成批次 → 三个迁移工人并行认领执行 → 每当有工人报完一批监督者就检查整体进度决定是继续派活还是介入排错 → 全部完成后由监督者触发统一测试收口。这种中央收口正是 Supervisor 的价值最终质量由监督者统一把关而不是各做各的。3分钟启用Supervisor模式一键安装步骤前提Claude Code v2.x 以上版本。按 quickstart.md 的步骤操作# 1. 添加插件市场并安装 harness 插件 claude plugin marketplace add revfactory/harness claude plugin install harnessharness # 2. 开启 Agent Teams 实验特性Supervisor模式必需 export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1然后一句话生成你的监督者团队claude 为代码迁移项目构建一个 harness用监督者Agent动态分派文件批次团队包含3个迁移工人生成后项目下会出现.claude/agents/各 Agent 定义文件和.claude/skills/技能文件监督者的编排逻辑写在其技能文件里可参考 orchestrator-template.md 的模板结构。何时选Supervisor何时选别的模式用三个判断问题快速决策来自 SKILL.md 的模式选择流程任务量固定、步骤严格有序→ 用流水线任务开工前就能全部列清、彼此独立→ 用扇出/扇入更简单计划会边跑边变、需要按进度和优先级派活→ ✅ 用 Supervisor另外实际项目里复合模式也很常见比如Supervisor 专家池——监督者先给每个客户咨询分类再动态调起对应领域的专家官方在 agent-design-patterns.md 中专门列了这类组合。常见坑与最佳实践实验标志没开团队静默退化Supervisor 依赖TeamCreate/SendMessage/TaskCreate三个实验 API。如果忘了设置环境变量生成的团队会悄悄退化成单 Agent 执行多智能体编排直接失效。详见 experimental-dependency.md。监督者别变成瓶颈官方提示把委托单元设置得足够大。如果每次只派改一行代码这种细碎任务监督者会被消息淹没整个团队的效率反而下降。小团队优于大团队Harness 的组队经验5~10 个任务配 2~3 名成员即可成员越多协调开销越大——3 名专注的成员胜过 5 名走神的成员。失败要有预案监督者对失败任务的处理路径是固定的确认原因 → 重试或改派 → 若反复失败则在最终报告中注明缺失部分而不是卡死整个流程。延伸阅读相关文件清单快速上手docs/quickstart.md六大模式完整定义skills/harness/references/agent-design-patterns.md实战团队示例含 Supervisor 迁移团队skills/harness/references/team-examples.md编排器技能模板skills/harness/references/orchestrator-template.md主技能入口skills/harness/SKILL.md项目总览README.md掌握 Supervisor 模式后你就拥有了 Harness 里最适合计划会变的复杂任务的编排方式中央统筹、动态派活、失败自愈——这正是多 Agent 系统从能跑走向可靠的关键一步。【免费下载链接】harnessA meta-skill that designs domain-specific agent teams, defines specialized agents, and generates the skills they use.项目地址: https://gitcode.com/GitHub_Trending/harness/harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考