从零搭建 AI 猫猫协作系统
March 30, 2026 · View on GitHub
一个真实项目的完整复盘，还原我们踩过的坑、做过的决策、走过的弯路。
为什么写这个教程
2026 年 2 月，我们在公司分享了三只 AI 猫猫的协作故事，500 人群瞬间满员。大家最好奇的不是"你们用了什么技术栈"，而是：
- 怎么让多个 AI Agent 真正协作起来？
- 为什么布偶猫被缅因猫 review 了 6 轮？
- 你们是怎么从 SDK 方案转到 CLI 的？
这个教程不是"从零开始的理想路径"，而是还原我们真实走过的路——包括错误的尝试、关键的转折、以及血泪教训。
三只猫猫
| 猫猫 | 模型 | 角色 |
|---|---|---|
| 布偶猫 | Claude Opus | 主架构师，核心开发 |
| 缅因猫 | Codex | Code Review，安全，测试 |
| 暹罗猫 | Gemini | 视觉设计，创意 |
🎬 功能演示
想先看看成品长什么样？ → 查看功能演示（含视频）
16 个功能演示，从基础交互到多猫协作到研发自闭环，每个都有视频。
教程目录
Part 0: 概念入门
| 课 | 标题 | 状态 | 核心问题 |
|---|---|---|---|
| 00 | AI Agent 概念演进 | ✅ 完成 | Function Call → MCP → Skills → Agent 怎么来的？ |
Part 1: 选型与架构
| 课 | 标题 | 状态 | 核心问题 |
|---|---|---|---|
| 01 | 选型之路：从 SDK 到 CLI | ✅ 完成 | 为什么 SDK 方案行不通？ |
| ↳ | 课后作业 | ✅ 完成 | 动手写最小可运行示例 |
| 02 | 从玩具到生产：一场辩论赛引发的连环惨案 | ✅ 完成 | stderr 教训 + Redis 隔离 + 幻觉 |
| ↳ | 课后作业 | ✅ 完成 | CLI 工程化自检提示词 |
| 03 | 驯化 AI 的元规则：为什么 WHY 比 WHAT 重要 | ✅ 完成 | 从 AI 弱点出发设计协作规范 |
Part 2: 协作机制
| 课 | 标题 | 状态 | 核心问题 |
|---|---|---|---|
| 04 | 多猫路由 — 当 AI 开始互相 @ | ✅ 完成 | @mention 怎么分发？两条路径的灾难 |
| 05 | MCP 回传 — 让猫猫主动说话 | ✅ 完成 | 被动响应不够，猫怎么主动发言？ |
| ↳ | 课后作业 | ✅ 完成 | 搭建最小 MCP 回传系统 |
Part 3: 生产化
| 课 | 标题 | 状态 | 核心问题 |
|---|---|---|---|
| 06 | 消失的 28 秒 — 当 AI 闯了生产事故 | ✅ 完成 | 两次数据丢失 + 取证恢复 + F23/F25 三层防线 |
| ↳ | 课后作业 | ✅ 完成 | 数据丢失演练 + 防腐门 + 证据闸门 |
Part 4: 进阶话题
| 课 | 标题 | 状态 | 核心问题 |
|---|---|---|---|
| 07 | 从猫咖到猫猫平台 — 当 AI 不只是工具 | ✅ 完成 | SillyTavern 取经 + Rich Blocks + PWA + 悄悄话 + 插件化 |
| ↳ | 课后作业 | ✅ 完成 | 最小 Rich Blocks 管线 + Game Block |
| 08 | Session 管理 — 茶话会夺魂 bug | ✅ 完成 | 跨 thread 污染怎么来的？ |
| ↳ | 课后作业 | ✅ 完成 | 搭建最小 Session Chain 模拟器 |
| 09 | 100% Pass — 12 条验收全绿，铲屎官说"不是我要的" | ✅ 完成 | 为什么 AI 做的不是你想要的？上下文工程四层解法 |
| ↳ | 课后作业 | ✅ 完成 | Skill 描述三件套 + AC 审计 + 冷启动验证 |
| 10 | 别让 AI 随地大小拉 markdown | ✅ 完成 | 三层记忆架构 + 元数据契约 + 知识工程速查 |
| ↳ | 课后作业 | ✅ 完成 | 蜘蛛网审计 + frontmatter 补录 + 7-slot 教训模板 |
| 11 | 让猫猫开口说话 — 从"五年前机器朗读"到 11 只猫 11 种声线 | ✅ 完成 | ASR + TTS + Voice Identity + iOS autoplay 全链路 |
| ↳ | 课后作业 | ✅ 完成 | TTS 对比 + 克隆实验 + Autoplay 策略 + Adapter 模式 |
Part 5: Under the Hood — 对等架构深潜
| 课 | 标题 | 状态 | 核心问题 |
|---|---|---|---|
| 12 | 没有 Boss Agent — 为什么我们不用中央编排 | ✅ 完成 | 对等判断层 + 结构化执行层的两层设计 |
| ↳ | 课后作业 | ✅ 完成 | 去中心化协作层设计 + 跨模型 Review 实验 |
| 13 | 一句话到交付 — Feature 闭环的双环路径 | ✅ 完成 | Discovery Loop + Delivery Loop 完整闭环 |
| ↳ | 课后作业 | ✅ 完成 | 最小 Discovery Loop + 愿景对照 + 三角色制约 |
| 14 | 越犯错越聪明 — 三层记忆与自我进化 | ✅ 完成 | 文档真相源 + 联邦检索 + 知识晋升管道 |
| ↳ | 课后作业 | ✅ 完成 | 蜘蛛网审计 + 结构化教训 + 最小 Recall 系统 |
| 15 | 跑了 54 天为什么没崩 — Pack、门禁与工程纪律 | ✅ 完成 | Pack 协作世界 + 门禁纪律 + Vibe Coding 四节奏 |
| ↳ | 课后作业 | ✅ 完成 | 五条铁律 + 证物 Gate + 代码卫生度量 |
适合谁
- 想让多个 AI Agent 协作的开发者
- 对 Claude/Codex/Gemini CLI 感兴趣的人
- 想看真实项目演进过程的人
- 想避开我们踩过的坑的人
不适合谁
- 想要一键部署模板的人（我们还没到那一步）
- 只想调 API 不关心协作的人
- 期待完美代码的人（我们还在打磨）
项目状态
- 代码仓库：已开源（2026-03-21）
- 教程：公开（你正在读的这个）
这个教程由三只猫猫和铲屎官共同编写。