全部文章
Agent 设计2026-05-29

Why a Single Agent Still Holds You Back and What the Swarm Architecture Actually Changes

用 Obsidian + Claude Code 的 swarm 架构替代单一 agent,两个小时完成配置,之后项目管理系统的维护变成系统运行的副产品,不再需要人工介入。

为什么一个 agent 仍然在拖累你?

这篇文章的答案是:不是 agent 的能力问题,是架构问题。

当你用一个 agent 处理所有事情,它需要同时维护:项目状态、你的偏好、当前任务进度、历史决策、团队信息。这个 agent 的上下文在每次任务之间不断膨胀,导致它处理新任务时需要花更多时间"重新理解现状",而不是直接开始工作。

Swarm 架构的解法是把这些事情分散到多个 agent,每个 agent 专职负责一块。

#单一 agent 的问题:上下文竞争

当你只有一个 agent,每次你让它处理一个新任务,它需要先"理解"当前状态:

  • 这个项目现在是什么情况?
  • 上次我们讨论的优先级是什么?
  • 我之前做出了哪些决策,它们的基础是什么?

这个"理解"过程在每次任务开始时都会重复。而且当任务涉及多个领域时,单个 agent 的上下文会变得拥挤——它需要在同一个对话里同时处理来自不同领域的信号,互相干扰。

这就是"单一 agent holding you back"的真正含义:不是因为它不够聪明,而是因为它需要同时做太多的事情,而这些事情在共享同一个上下文。

#Swarm 架构的实际含义

Swarm 不是"一堆 agent 在一起工作"这种模糊的概念。它的实际含义是:

每个 agent 有自己的专职上下文。

在这个系统里,你可能有:

  • 项目状态 agent :只负责维护项目当前状态的文件,每次任务执行后更新状态,不关心其他领域
  • 决策追踪 agent :只负责记录和回顾你做过的决策,以及这些决策的理由
  • 任务执行 agent :只负责具体任务的执行,它每次启动时从项目状态 agent 读取上下文,不需要理解整个系统

这三个 agent 不需要互相"对话"。它们通过 Obsidian 的共享文件交互——每个 agent 写入自己的专职文件,其他 agent 读取它需要的信息。

这就是为什么文章说"系统成本是两个小时的周末时间":两个小时写四个 Skill 文件,定义每个 agent 的职责边界和交互方式。之后系统就跑起来了。

#Obsidian 在这个架构里的角色

Obsidian 的本质是一个文件夹里的 Markdown 文件。它在这个架构里充当的不是"笔记工具",而是多 agent 系统的共享内存层

每个 agent 知道:

  • 自己负责哪个文件
  • 其他 agent 会写入哪个文件
  • 如何读取需要的信息

这意味着任何能够读写本地文件的工具,都可以成为这个多 agent 系统的一部分——不需要 API,不需要插件,不需要复杂的集成工作。

Claude Code 恰好具备这个能力:它可以直接读写本地文件。所以它天然就是 Obsidian 和 agent 系统之间的桥梁。

#为什么说"两小时改变了一切"

大多数人在读到这里的时候会想:"两小时设置一个系统听起来很美好,但真的能 work 吗?"

答案在文章里是具体的:"你的项目管理系统停止和你的实际工作竞争,开始作为实际工作的副产品运行。"

这句话翻译一下是:当项目状态的更新变成 agent 执行任务的自然结果,你不需要专门花时间去维护系统。Agent 每完成一个任务,就会自动更新状态文件,因为 Skill 文件里已经规定了这个行为。

你不需要记得去更新系统。系统是活的,它在你的工作流里实时运行。

#Swarm vs 单一 agent 的实际差异

维度单一 agentSwarm 架构
上下文复杂度所有领域共享同一个上下文每个 agent 维护独立上下文
扩展性新增领域需要 agent 变得更复杂新增领域只需要新增 agent
故障隔离一个 bug 影响整个 agent一个 agent 出错不影响其他 agent
维护成本需要持续清理上下文每个 agent 专职维护自己的文件
启动时间每次启动需要重新理解全局agent 只读取自己负责的文件

#两个小时的实质性工作

两个小时具体做了什么:

  1. 定义 agent 职责边界 :哪些事情归哪个 agent管,这个定义需要在写代码之前就想清楚
  2. 写 Skill 文件 :用 Skill 文件的方式把这些职责边界固化,让 Claude Code 知道在不同场景下调用哪个 agent
  3. 设置 Obsidian 文件结构 :建立每个 agent 对应的文件名和格式规范
  4. 测试核心场景 :验证 agent 在真实任务中的协作路径是否符合预期

两个小时的价值不是"节省了多少时间",而是建立了一个可以持续自主运行的系统 。它不是一个需要你每天维护的工具,而是一个一旦跑起来就会自己运转的资产。

#谁适合迁移到 Swarm 架构

如果你符合以下情况,这个架构值得认真考虑:

  • 你的 agent 项目已经有一定复杂度,单一 agent 经常出现"上下文混乱"的问题
  • 你需要同时处理多个领域,每个领域有不同的专业要求
  • 你发现每次启动 agent 都需要大量"重新对齐"时间
  • 你的团队里有多个人需要和同一个 agent 系统交互

对于刚开始用 agent 的用户,单一 agent 仍然是最好的起点。但当你的需求开始多元化,单一 agent 的局限性就会显现。提前了解 Swarm 架构的思路,可以在需要的时候更快地完成迁移。