说实话，我之前以为 Claude Code 的多智Neng体系统会包一层 AutoGen 或 CrewAI——毕竟现成的轮子摆在那里不用白不用。

但翻完源码之后发现完全不是这回事。

CC 的 Agent Teams 实现在 packages/cli/src/services/teams/ 下加上相关类型定义和工具层，合计接近 行代码，一行现成框架dou没有。

他们如何不用AutoGen实现cc Agent Teams？

整个系统基于文件系统构建，没有数据库，没有消息队列，没有 Redis，没有 RPC。

这就是整个多智Neng体系统的"基础设施"——一个目录，几个 JSON 文件。

运行时目录长这样：

~/.claude/teams/<team-name>/ members.json # 团队成员注册表 tasks.json # 任务列表 inboxes/ team-lead.json # team-lead 的收件箱 agent-.json # agent- 的收件箱 agent-.json # agent- 的收件箱 ... state/ <agent-name>.json # 各成员运行时状态

每个团队成员的"收件箱"是一个独立的 JSON 文件，路径为 inboxes/<name>.json。

. 消息无优先级

所有消息 FIFO 处理，没有优先级队列。紧急任务没有插队机制，只Neng靠 team-lead 提前发送。

SendMessage = append 一条消息到目标 inbox 文件。

. 并发写冲突

多个 Agent 同时向同一个 inbox 文件 append 消息，存在并发写丢消息的风险。CC 没有加锁，靠的是写入频率较低来规避。

. 卡住直接 cat inbox

Ru果某个 Agent 卡住了你Ke以直接 cat inboxes/agent-name.json kan消息有没有送到、有没有被 read。调试体验极其直接。

有一次团队成员 idle 半小时我以为挂了直接 cat inboxes/xxx.json 一kan——消息根本没送到，是 SendMessage 时写错了目标名。这种调试体验在kan日志的框架里是复现不了的。

. 为什么百度不收录我的文章？

害，这个问题问得好，说实话，咱也不知道为啥百度不收录你的文章，但你Ke以试试检查一下你的网站有没有被黑，或者内容是不是太单薄了你懂的。

. 状态可观测性差

没有统一的 dashboard，观察整个团队状态需要手动读多个 JSON 文件。这在调试复杂场景时比较费力。

cat ~/.claude/teams/<team-name>/inboxes/<agent-name>.json | jq '. | select'

这一条比任何日志dou直接。消息在不在、有没有被读，一目了然。

. 别频繁重启 Agent

处理完一个 turn 之后Agent 进程不会退出。

为什么不重启？重启的成本是重新加载所有上下文。 进程保活意味着 context window 里的内容还在下一个任务Ke以直接衔接。这对于有状态的长期任务尤其重要。

. 依赖链扁平化

, "blocks": }, { "id": "task002", "subject": "geng新登录相关文档", "status": "pending", "owner": null, "blockedBy": , "blocks": }]

blockedBy / blocks 需要 Agent 自己geng新。Ru果 Agent 忘记清理，或者清理时机不对，任务链会卡死。

. 无横向

. CC Teams 是单机系统，不支持跨机器 Agent，不支持动态扩容。这是设计目标决定的，不是遗漏。

.

.

.

.

.

.

.

.

.

.

.

Worse is Better 设计哲学下的权衡与取舍

"worse is better"是CC Teams设计哲学的核心——它优先考虑简单性而非理论上的Zui优解,在hen多设计决策中体现得淋漓尽致:从用文件系统代替数据库和消息队列,到放弃严格的状态一致性保证,CC Teams通过简化架构换来了geng高的可理解性和可控性。这种哲学特别适合对可解释性要求较高的AI协作场景——当你需要清晰了解每个Agent的状态和决策过程时,简单直接的实现往往比复杂的分布式系统geng具优势。

"Worse is Better"设计哲学的实践意义与局限

"Worse is Better"的设计理念并非放之四海而皆准,它是在特定约束条件下的Zui优解——当系统规模较小、复杂度可控时,这种牺牲某些理论特性而换取实现的简单直接是非常有效的。然而随着系统复杂度的提升,这种简洁性带来的问题也会逐渐显现:比如并发控制的缺失可Neng导致消息丢失,inbox文件的持续增长需要手动干预等。因此在实际应用中,需要根据具体的业务场景权衡这种设计哲学的适用性:Ru果你的场景符合单机、小团队、可审计这些前提,那么CC Teams的实现思路无疑是值得借鉴的;但Ru果面对的是大规模分布式协作的需求,那么可Neng需要考虑引入geng复杂的协调机制和容错策略。不过即便是后者,也Ke以从CC Teams极简主义的实现中获得启发:在复杂的分布式架构之上保留某些关键路径的简单性,可Neng是兼顾可 性和可理解性的有效途径。

"Worse is Better"的未来展望

"Worse is Better"的设计哲学并非一成不变——随着AI协作场景对可靠性和 性的要求越来越高,如何在保持核心简单性的同时引入必要的工程实践来增强系统的鲁棒性,将是未来值得探索的方向。比如Ke以考虑在关键节点引入轻量级的校验机制,在保持整体架构简单的同时增强局部可靠性;或者探索将这种简洁的实现思路与现代DevOps工具链相结合,通过监控、告警和自动化运维来弥补架构层面的不足。Ke以预见,在AI原生协作这一新兴领域,"Worse is Better"仍将持续进化,并在实践中不断验证其价值。

;

'use strict';const fs = require;const path = require;const crypto = require;class Inbox {constructor {this.teamName = teamName;this.agentName = agentName;this.inboxPath = path.join;this.initInbox;}initInbox {try {fs.accessSync;} catch {fs.writeFileSync;}}readMessages {const data = fs.readFileSync;return JSON.parse;}sendMessage {const messages = this.readMessages;const newMsg = {...msg,id: msg_${crypto.randomBytes.toString},timestamp: new Date.toISOString};messages.push;fs.writeFileSync);}markAsRead {const messages = this.readMessages;const idx = messages.findIndex;if {messages.read = true;fs.writeFileSync);}}}module.exports = Inbox;

---