Harness Fan-out/Fan-in模式：多个Agent如何并行调查并汇合结果

Harness Fan-out/Fan-in模式：多个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

Harness 是一个 Claude Code 插件（元技能），可以从一句领域描述自动设计出 Agent 团队并生成配套技能。本文带你彻底搞懂它 6 种架构模式中最常用的一种——Fan-out/Fan-in（扇出/扇入）：多个 Agent 如何像一支调查小组一样并行开工、实时互通、最终汇合成一份完整报告。

什么是Fan-out/Fan-in：拆开并行、汇成一份

Fan-out/Fan-in（中文常称"扇出/扇入"）的思想和现实中"派几个人分头调查，再开个碰头会汇总"完全一样：

┌→ [专家A] ─┐ [分发] → ├→ [专家B] ─┼→ [整合] └→ [专家C] ─┘

它最适合的场景是：同一份输入，需要从不同视角、不同领域分别深入。比如综合调研——官方渠道、媒体报道、社区口碑、背景与竞争环境可以同时开查，最后由负责人整合成一份综合报告。

Harness 把它列为 6 种团队架构模式之一（Pipeline、Fan-out/Fan-in、Expert Pool、Producer-Reviewer、Supervisor、层级委托），完整模式对比见 agent-design-patterns.md。

什么时候该用Fan-out/Fan-in：4个典型场景

⚠️ 关键提醒：整合阶段的决定整体质量。并行做得再快，如果最后的汇总只是"简单拼接"，报告就会像碎片堆砌。

实战走一遍：4人调研团队的完整流程

team-examples.md 里给了一个完整的调研团队范例，流程如下：

Phase 1 准备→ 分析用户输入的主题，创建_workspace/工作目录

Phase 2 组队→ 用TeamCreate组建 4 人团队，用TaskCreate登记 4 项调查任务，每人认领一份

Phase 3 并行调查→ 4 位成员独立开查，但不是互不干扰——发现有趣线索会用SendMessage互相同步（比如媒体调查员发现的融资新闻，直接发给背景调查员跟进）；遇到矛盾信息则直接当面"辩论"

Phase 4 汇合→ 负责人读取 4 份产出，整合成综合报告，矛盾信息并列保留并注明来源

Phase 5 收尾→ 解散团队，_workspace/中间产物全部保留，方便事后审计

并行时Agent怎么"通气"：三种协作通道

这是 Fan-out/Fan-in 模式里最容易被低估的部分——并行≠孤立。Harness 默认用"Agent 团队"模式，成员间有三条通信通道：

1. 📨 消息（SendMessage）：定向点对点，分享发现、提出质疑，不用经过负责人中转
2. 📋 共享任务清单（TaskCreate/TaskUpdate）：所有人看得见谁在做什么、进度到哪，自己会去认领空闲任务
3. 📁 文件（_workspace/约定路径）：大份产出统一写成文件，命名规范如01_analyst_requirements.md，最终由负责人统一读取

💡 一个有意思的效果：某位调查员的发现能实时修正另一位调查员的调查方向，这是"一个人独自查"做不到的质量提升。

汇合不是拼接：整合阶段做什么

Fan-in 阶段负责人要做四件事，缺一不可：

• 收集：用 Read 读取各成员在_workspace/中的产出文件
• 对齐：交叉验证各方结论，识别重叠与冲突
• 标注：矛盾数据不删除，而是注明来源并列呈现（如"官方称X，社区反馈Y"）
• 交付：生成最终单一产出物到用户指定路径

完整的编排模板（含错误处理表：某成员失败时重试→改派→报告中注明缺失）见 orchestrator-template.md。

新手上手3个实用建议

1. 控制团队规模：小任务 2~3 人、中任务 3~5 人即可，人越多协调开销越大——"3个专注的成员强过5个散漫的成员"
2. 并行任务必须真正独立：如果任务B必须等任务A的结果，那是 Pipeline（流水线）而不是 Fan-out，硬拆只会制造等待
3. 快速起步：按 quickstart.md 的步骤安装并开启 Agent Teams 后，只要说一句 "Build a harness for deep research"（为深度调研搭建团队），Harness 就会自动生成调研 Agent 团队和配套技能，详见 SKILL.md

相关核心文件

• 主技能定义（6阶段工作流）：skills/harness/SKILL.md
• 6种架构模式详解：skills/harness/references/agent-design-patterns.md
• 5个真实团队范例（含调研团队）：skills/harness/references/team-examples.md
• 编排器模板（数据流+错误处理）：skills/harness/references/orchestrator-template.md
• 5分钟快速上手：docs/quickstart.md

【免费下载链接】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