Harness如何设计团队架构：Phase 2的3个关键子步骤详解

Harness如何设计团队架构：Phase 2的3个关键子步骤详解

【免费下载链接】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 的智能体团队架构工厂（Team-Architecture Factory）：你只需一句话描述业务领域，它就能自动设计出智能体团队并生成配套技能。而整个 6 阶段工作流中最核心、最考验设计功力的，正是Phase 2：团队架构设计——它决定了你的智能体团队"怎么协作、用什么阵型、拆成几个人"。

🧭 一分钟了解：Harness 的 6 阶段工作流

Harness 的主流程定义在 skills/harness/SKILL.md 中，完整工作流如下：

Phase 1: 领域分析 ↓ Phase 2: 团队架构设计（Agent Teams vs Subagents）← 本文重点 ↓ Phase 3: 智能体定义生成（.claude/agents/） ↓ Phase 4: 技能生成（.claude/skills/） ↓ Phase 5: 集成与编排 ↓ Phase 6: 验证与测试

Phase 1 搞清楚"要做什么"，Phase 3 及以后负责"落地实现"，而 Phase 2 则回答最关键的架构问题：用团队还是子代理？选哪种协作阵型？每个智能体负责什么？这三个问题分别对应 Phase 2 的 3 个子步骤：

⚙️ 子步骤2-1：如何快速选择执行模式（团队 vs 子代理）

这是新手最常纠结的一步。Harness 给出的原则很明确：智能体团队是默认首选。2 个及以上智能体需要协作时，优先使用团队模式，因为团队成员之间可以直接通信（SendMessage）、共享任务列表（TaskCreate），能互相分享发现、挑战结论、补全遗漏，从而显著提升产出质量。

三种模式怎么选？看这张决策表：

推荐的决策顺序（新手照做即可）：

1. 先问自己："2 个以上智能体能用团队模式设计吗？"——能就选团队，这是默认值；
2. 只有当智能体之间结构性地不需要通信（只传结果）、且团队开销大于收益时，才选择子代理；
3. 各阶段特性明显不同时考虑混合模式，并记得在编排器里写明每个阶段用哪种模式。

完整的对比表和决策树可以参考 skills/harness/references/agent-design-patterns.md，其中的"模式选择决策树"用三问就能帮你定下模式。

🏗️ 子步骤2-2：6 大架构模式，哪种阵型最适合你的任务

定好执行模式后，第二件事是从 6 种预定义的团队架构模式（agent-design-patterns.md）中挑选最贴合任务特性的阵型：

💡两个实用技巧：

• 实际项目更常用"复合模式"：例如"扇出 + 生产者-审查者"（4 种语言并行翻译→各自母语审校）、"流水线 + 扇出"（分析串行→实现并行→集成测试串行），可参考 复合模式对照表；
• 扇出/扇入模式建议必须用智能体团队：调查者之间实时分享发现、互相挑战，质量远高于各自为战。

✂️ 子步骤2-3：用 4 条标准决定"要不要拆分智能体"

阵型确定后，最后要回答：这个团队到底需要几个智能体？Harness 在 SKILL.md#L74-L76 中给出了 4 轴判断法，对照 分离标准表 逐项打分即可：

原则：一个智能体专注一个角色，复用性最高、重复最少。如果一个智能体身兼两职，先考虑能不能拆开。

举个例子：做"深度研究"团队时，"网络搜索"和"学术检索"领域不同、可并行、上下文各自独立——按 4 条标准都指向拆分；而"引用核对"只是报告撰写流程中的一小步、领域重叠——按标准应该合并进报告智能体。

🚀 Phase 2 完成之后：设计蓝图如何落地

Phase 2 的产出是一张"团队架构蓝图"，它直接驱动后续阶段：

• Phase 3：按蓝图把每个智能体写成定义文件（agent-design-patterns.md 中的定义结构模板），包含核心角色、工作原则、输入/输出协议和团队通信协议；
• Phase 4：为每个智能体生成配套技能（SKILL.md + references/）；
• Phase 5：用编排器把"谁在什么顺序上协作"串成完整工作流，模板见 orchestrator-template.md；
• Phase 6：验证团队规模、通信路径与触发条件是否符合预期。

📌 新手建议：设计完成后对照 SKILL.md 末尾的产出检查清单，确认"执行模式已明确、智能体不重复、每个调用都标注模型"等要点，再进入实现阶段。

📚 延伸阅读：核心文件速查

想动手体验或深挖细节，从这几份资料入手：

• 📖 skills/harness/SKILL.md：6 阶段主工作流的完整定义，Phase 2 三个子步骤的权威出处
• 📐 skills/harness/references/agent-design-patterns.md：执行模式对比、决策树、6 大架构模式与智能体分离标准
• 🌍 skills/harness/references/team-examples.md：5 个真实团队配置示例
• 🚀 docs/quickstart.md：5 分钟上手指南，从安装到跑通第一个团队
• 📝 README.md：项目总览、架构模式总表与使用场景提示词

掌握 Phase 2 的这 3 个子步骤——选对执行模式、挑对架构阵型、拆对智能体——你就掌握了 Harness 团队架构设计的核心方法论。下一篇文章，我们继续拆解 Phase 3 的智能体定义生成细节。

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