文章资料已整理完毕现在输出文章【免费下载链接】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我已通读 README.md、skills/harness/SKILL.md、orchestrator-template.md、agent-design-patterns.md、team-examples.md、docs/quickstart.md 等核心文件确认了 Harness 三种执行模式Agent 团队 / 子代理 / 混合模式的定义、决策树、数据传递协议与验证要点并选定两张横版大图harness_banner.png、harness_team.png均为 2752x1536 的 16:9 比例。Harness执行模式选型Agent团队 vs 子代理 vs 混合模式完全对比一句话定位Harness 是一个面向 Claude Code 的元技能Meta-Skill你用一句领域描述它就能自动设计出专属的Agent 团队并生成配套技能文件。而选对执行模式——Agent 团队、子代理还是混合模式——直接决定你的多智能体工作流的质量与成本。本文带你 10 分钟看懂 3 种模式的差异附完整选型清单。三种执行模式速览一张表看懂差异Harness 在工作流的 Phase 2团队架构设计阶段会先做执行模式选择即 2-1 环节。三种模式的核心差异如下维度 Agent 团队默认⚡ 子代理Subagents 混合模式Hybrid核心工具TeamCreateSendMessageTaskCreateAgent工具直接调用按 Phase 混用两者通信能力团队成员可直接互发消息、实时讨论只能把结果返回主代理彼此无法通信各 Phase 按其模式运行协调方式共享任务列表自主认领任务主代理全权负责协调团队与子代理通过文件交接适合场景2 个及以上智能体需协作一次性任务、只需返回结果各阶段特性差异明显的复杂流程Token 成本较高较低轻量高效介于两者之间按需付费典型产出交叉验证、冲突讨论、缺口互补摘要结果回传主上下文阶段化流水线如并行收集→共识整合核心原则Harness 把Agent 团队作为默认首选——只要涉及 2 个以上智能体协作先考虑团队模式只有当团队成员间通信确实不需要、且团队开销大于收益时才降级到子代理。模式一Agent 团队默认首选Agent 团队是 Harness 的默认执行模式。团队领导者通过TeamCreate组建团队成员作为独立实例并行运行通过SendMessage直接通信并用共享任务列表TaskCreate/TaskUpdate自主协调。它的独门优势✅ 成员之间可以直接对话、质疑、互相验证信息无需经过领导者中转✅ 共享任务列表支持自主认领任务实时反馈与发现共享✅ 成员空闲时自动通知领导者方便及时干预✅ 支持计划审批模式高危操作可先审查再执行需要注意的限制⚠️ 每个会话同一时间只能有一个活跃团队但可以在 Phase 之间拆解旧团队、组建新团队⚠️ 不支持嵌套团队成员不能再组建自己的团队⚠️ 领导者固定不可更换Token 成本相对较高适用场景调研分析、设计-实现-验证闭环、生产者-审核者配对等需要实时协作的任务。模式二子代理轻量模式子代理模式下主代理通过Agent工具直接创建子代理支持run_in_background: true并行执行。结果以摘要形式返回主上下文子代理之间完全隔离。它的独门优势✅ 轻量、快速Token 效率高✅ 无需团队管理开销结构简单清晰✅ 结果集中回传主代理统一整合明显的局限❌ 子代理之间无法通信没有实时协作与交叉验证❌ 所有协调压力都落在主代理身上适用场景单一智能体任务、专家池式选择性调用按输入类型只调用对应专家、以及只传结果、不传过程的生成-验证场景。模式三混合模式按阶段组合的高级玩法当流程中各阶段的特性差异明显时Harness 建议按 Phase 混用两种模式。官方模板中给出了三种高频组合组合流程示例为什么这样搭⚡ 并行收集子代理→ 共识整合团队子代理并行收集独立资料 → 团队讨论、消除冲突、达成共识收集阶段无需通信整合阶段需要讨论 团队生成 → ⚡ 子代理验证团队产出初稿 → 单个子代理独立验证验证者保持独立避免自己审自己 Phase 间团队重组每个 Phase 拆解旧团队后组建新团队中间插入子代理调用不同阶段需要不同专家组合 使用混合模式时必须在编排器技能的每个 Phase 顶部显式标注执行模式如**执行模式** Agent 团队并在模式切换点处理好数据交接团队→子代理时先TeamDelete再调用Agent子代理→团队时把文件产出以读取路径传给团队成员。如何快速选型3 步决策清单官方决策树非常简洁照着问自己 3 个问题即可第 1 问智能体有 2 个及以上吗 ├── 否只有 1 个→ ⚡ 直接选子代理 └── 是 → 第 2 问 第 2 问智能体之间需要通信/交叉验证吗 ├── 是 → 选 Agent 团队默认值 └── 否 → 第 3 问 第 3 问团队通信开销是否大于收益 ├── 是 → ⚡ 选子代理只传结果的生成-验证、专家池 └── 否 → 仍选 Agent 团队如果各 Phase 特性差异明显例如收集不需要通信、整合需要讨论再升级到 混合模式把每个 Phase 的模式写进编排器即可。执行模式与 6 大架构模式的匹配建议Harness 内置 6 种团队架构模式每种都有明确的模式亲和度架构模式结构特点推荐执行模式流水线Pipeline顺序依赖分析→设计→实现→验证团队模式收益有限含并行区段时用团队扇出/扇入Fan-out/Fan-in并行独立任务后汇总必须用 Agent 团队——成员实时共享发现、互相挑战质量远超各自为战专家池Expert Pool按输入类型选择性调用专家⚡ 子代理更合适——只调需要的专家无需常驻团队生成-审核Producer-Reviewer生成后质量审查不合格重做 Agent 团队——SendMessage实时反馈最小化返工监督者Supervisor中央代理动态分配任务 Agent 团队——共享任务列表天然匹配动态分配层级委派Hierarchical Delegation自上而下递归委派团队不支持嵌套第 1 层用团队第 2 层用子代理建议控制在 2 层以内 完整模式详解与模式×架构决策表可查阅agent-design-patterns.md不同模式的数据传递方式对照选完模式后还要匹配数据传递协议。Harness 定义了 4 种策略传递策略实现方式适用模式适合场景消息传递SendMessage直接通信团队实时协调、轻量状态同步任务传递TaskCreate/TaskUpdate共享状态团队进度追踪、依赖管理文件传递约定路径读写文件团队 子代理大体积数据、结构化产物、审计留痕返回值传递Agent工具返回消息子代理结果直接回传主代理官方推荐组合团队模式任务传递协调 文件传递产物 消息传递实时沟通⚡子代理模式返回值传递结果收集 文件传递大体积产物混合模式每个 Phase 按其执行模式分别套用文件传递有统一约定中间产物存入_workspace/目录命名格式为{阶段}_{智能体}_{产物}.{扩展名}如01_analyst_requirements.md最终产物才输出到用户指定路径——这个设计让团队→子代理的跨模式交接变得干净利落。验证要点不同模式该测什么Harness 工作流的 Phase 6 对不同模式有不同的验证清单这也是区分模式成熟度的关键Agent 团队检查成员间通信路径、任务依赖关系、团队规模是否合理⚡子代理检查各智能体输入输出衔接、run_in_background设置、返回值收集逻辑混合模式检查每个 Phase 的执行模式是否已显式标注模式切换边界处数据传递是否断裂团队的产物能否无缝作为子代理的输入另外无论选哪种模式都要跑一遍有技能 vs 无技能的对比测试验证技能的实际增值。详细方法论见skill-testing-guide.md团队规模建议宁少勿多如果最终选定 Agent 团队官方给了明确的规模指引——3 个专注的成员胜过 5 个走神的成员任务规模建议成员数每人任务数小型5~10 个任务2~3 人3~5 个中型10~20 个任务3~5 人4~6 个大型20 任务5~7 人4~5 个常见问题 FAQQ1混合模式会不会让成本失控 不会失控反而更省。混合模式本质是按需付费不需要通信的收集阶段用子代理低成本需要讨论的整合阶段才开团队高质量比全程开团队更经济。Q2会话只有一个活跃团队多阶段流程怎么办Phase 之间可以先TeamDelete拆解旧团队把产物落盘到_workspace/再TeamCreate组建新团队——新团队通过读取文件即可继承上一阶段的成果。Q3新手第一套 Harness 该选哪种模式从Agent 团队默认模式开始。它覆盖绝大多数 2 智能体协作场景且 Harness 官方文档和 5 个真实团队示例都基于它构建参考材料最多。等你遇到纯并行收集、互不相关的明显场景再引入子代理。Q4子代理能嵌套吗子代理模式没有嵌套团队限制但层级委派建议控制在2 层以内——层级越深延迟和上下文丢失越严重。结语选对模式让团队架构为你所用 一句话总结本文的核心结论2 个以上智能体协作 → Agent 团队只传结果的单发任务 → 子代理各阶段特性差异明显 → 混合模式并把每个 Phase 的模式写明。Harness 的价值正在于此它不是让你手工搭建智能体团队而是用一句领域描述自动完成领域分析 → 模式选型 → 智能体定义 → 技能生成 → 编排集成 → 验证测试的完整闭环。三种模式的细节模板A/B/C 三套编排器模板都内置在 orchestrator-template.md 中真实团队配置示例可参考 team-examples.md完整的 6 阶段工作流定义见 SKILL.md。延伸阅读docs/quickstart.md — 5 分钟搭建你的第一个 Harnessdocs/experimental-dependency.md — 为什么需要开启 Agent Teams 实验开关README.md — 项目总览、6 大架构模式与实战案例【免费下载链接】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），仅供参考