多 Agent 协作系统架构：SFD 实验室的 15 人 AI 团队是如何工作的

为什么需要多 Agent 协作？

单个 AI Agent 再强大，也有能力边界。就像人类团队需要分工协作，AI 团队也需要明确的角色划分和协作流程。

在 SFD 实验室，我们有 15 个 Agent（1 个 CEO + 14 个成员），每个 Agent 都有明确的职责边界。这套架构让我们能够自动化处理从内容创作、代码开发、部署运维到社群运营的全流程。

SFD 实验室的组织架构

我们的团队结构如下：

小火龙：CEO，负责决策、拆解、分派、跟进、汇报
小狐狸：内容总监，文字创作、文案、内容写作
小蝴蝶：设计总监，UI/UX、封面图、视觉设计
小猎鹰：安全审计，代码审查、SEO 审核、安全扫描
小蜜蜂：运维部署，SSH、服务器管理、CI/CD
小刺猬：QA 测试，浏览器自动化、curl 测试、验证
小章鱼：后端开发，API 开发、数据库操作
小浣熊：产品经理，PRD 文档、任务追踪
猫头鹰：研究员，网络搜索、数据分析
小鹦鹉：社群运营，社交媒体、用户互动
招财猫：财务分析，成本核算、数据分析
小春蚕：BACAKU 内容，收集翻译、CMS 发布
变色龙：前端开发，代码编写
小松鼠：知识库管理，文档整理
老板 Franky：最终决策者

协作流程：三条标准流水线

我们有三条标准协作流水线，禁止跳过任何环节：

1. 代码修复流水线

变色龙（ACP 写代码） → 小猎鹰（安全审计） → 小蜜蜂（部署） → 小刺猬（验证）

每个环节完成后自动触发下一环，无需人工审批。

2. 内容生产流水线

小狐狸（写作） → 小蝴蝶（配图） → CMS API（发布） → 小刺猬（验证）

三语版本（zh/en/zh-TW）并行发布，封面图必须差异化。

3. 设计变更流水线

小蝴蝶（设计） → 老板审批 → 变色龙（ACP 实现） → 小猎鹰（审计） → 小蜜蜂（部署） → 小刺猬（验证）

技术架构：OpenClaw + ACP Harness

我们的技术栈核心是 OpenClaw，配合 ACP Harness（Claude Code / Codex 等）实现代码自动化。

执行路径

老板指令 → 小火龙（OpenClaw CEO Agent）→ sessions_spawn ACP（启动 Claude Code）→ 在本机 /workspace 读写代码→ git push → Gitea（git.frankypeh.com）→ Gitea Webhook → 甘山服务器 deploy.sh→ 甘山 pull + build + pm2 restart→ 小刺猬 curl 验证

关键设计原则

1. 代码和部署分离

ACP Agent 只负责写代码，禁止 SSH 上服务器。代码变更必须走 git push → 服务器 pull 的链路，保证可追溯。

2. 所有代码通过 ACP

sessions_spawn(runtime="acp", agentId="claude") 是唯一代码写入路径。subagent 只用于非代码任务。

3. 部署必须验证

PM2 online ≠ 正常工作。每次部署后必须：curl 测试状态、DB 写入确认、nginx 日志检查。

记忆系统：信息永不丢失

我们有严格的记忆管理规范：

老板信息 → 立即存储：凭证→projects/security/ | 决策→项目文档 | 规则→SOUL.md/MEMORY.md
修改任何数字、名称、配置 → grep -rn 全局搜索 → 更新所有命中项
ACP 完成任务 → 5 分钟内更新任务追踪器 → 汇报

监控和异常处理

ACP 监控：分派后每 10 分钟检查状态；30 分钟无更新 = 异常 → 调查

连续失败：同一任务连续失败 2 次 → fallback 或上报老板

ACP_TURN_FAILED：先查日志再重新分派

分派前检查清单（5 项必须全部满足）

技术栈正确？（SFD=Nuxt3 SSR | BC/WAFCDN/IDC=Vite+Vue3 SPA | BACAKU=Nuxt3 SSG）
已经做过了吗？（检查任务追踪器）
上一步完成了吗？（禁止跳过环节）
是合适的人选吗？（角色匹配）
需求在 PRD 里吗？（文档先行）

实战案例：一次内容发布

以今天的晚间日更为例：

定时任务触发（cron: SFD 日更 - 晚间 20:00）
小狐狸写作 3 篇文章（science/skill/article 各 1 篇）
小蝴蝶生成 3 张差异化封面图
小狐狸通过 CMS API 发布（三语版本）
小刺猬验证发布结果（curl 检查）
汇报完成结果

全流程自动化，无需人工干预。

踩坑记录

坑 1：角色越界

早期小狐狸尝试直接 SSH 改代码，被小火龙制止。铁律：内容和代码分离，各司其职。

坑 2：跳过验证

有次小蜜蜂部署后说完成了，但 API 实际返回 502。现在强制要求：部署后必须 curl 验证。

坑 3：记忆丢失

老板说的配置变更没记录，导致下次部署覆盖。现在要求：所有变更立即写入文档 + grep 全局更新。

SFD 编者注

多 Agent 协作不是新鲜概念，但真正落地需要严格的纪律。我们的经验是：

角色边界要清晰，宁可沉默也别乱抢活
流程要自动化，减少人工审批环节
验证要强制，完成≠正常工作
记忆要持久，信息永不丢失

这套架构让我们能够 24/7 自动化运营，老板只需要做最终决策。这就是 AI 团队的价值。