CCB项目共享记忆详解用.ccb/ccb_memory.md让多智能体无缝协作【免费下载链接】claude_codex_bridgeVisible multi-agent CLI workspace for mixing Codex, Claude, Gemini, Kimi, Qwen, Cursor, Copilot, Pi, OpenCode, and other AI coding agents项目地址: https://gitcode.com/gh_mirrors/cl/claude_codex_bridgeCCBclaude_codex_bridge是一个可视化多智能体 CLI 工作区可以把 Codex、Claude、Gemini、Kimi、Qwen、Cursor、Copilot、OpenCode 等十余个 AI 编码智能体放在同一个终端里协同工作。而CCB 项目共享记忆的核心就是项目根目录下的.ccb/ccb_memory.md文件它是一份所有智能体共同读取的团队记忆让你只需写一次协作规则所有 Agent 都能无缝继承真正实现多智能体无缝协作 。为什么多智能体协作需要一份共同记忆当你在一个项目里同时运行 3 个以上 AI 编码智能体时最常见的痛点是每个 Agent 只认识自己的私有记忆CLAUDE.md、AGENTS.md、GEMINI.md等互不知晓对方的存在同样的项目约束、交接约定要复制粘贴到多个 provider 私有文件里改一处漏一处Agent 之间委派任务时缺乏统一的沟通规范协作容易失控。CCB 项目共享记忆的设计目标非常明确让所有受管 Agent 知道彼此存在、使用统一的/ask通道协作、并把跨 Agent 的稳定信息收敛到一个文件里。把跨 Agent 的稳定信息放进共享记忆比把同一段说明复制到多个 provider 私有记忆里可靠得多。——README/zh.md一键获得共享记忆.ccb/ccb_memory.md 如何自动生成你不需要手动创建这个文件。CCB 的启动流程内置了仅在缺失时创建的安全语义自动创建启动 CCB 时若项目根目录不存在.ccb/ccb_memory.md会自动用内置模板生成一份永不覆盖一旦你编辑过这个文件后续任何版本的模板更新都不会改动它种子记录初次生成时会在运行时状态里记录模板版本和文件哈希state/memory.seed.json用于判断这份文件还是原始模板优雅降级即使项目根目录只读CCB 也会继续启动并记录警告而不是直接报错。默认模板非常克制核心内容只有两件事告诉每个 Agent你是一支 CCB 管理的团队中的一员以及规定跨 Agent 协作统一使用 CCBask通道例如/ask agent message并要求委派时写清目标、范围、假设与验证方式。模板定义在 lib/project_memory/template.py。共享记忆该写什么4 类最值得沉淀的内容.ccb/ccb_memory.md不是项目说明书也不该堆砌大段 CLI 文档。建议只写跨 Agent 稳定成立的信息按官方推荐分为四类类别示例‍‍ 团队协作规则代码风格约定、提交信息格式、谁负责评审⚠️ 项目约束禁止修改的目录、必须运行的测试、技术栈红线 长期上下文架构决策、当前迭代目标、已知技术债 Agent 交接约定任务委派格式、回复要点、阻塞上报方式一个典型的写法示例## 项目约束 - 所有改动必须通过 pytest test/ -x -q 后再交付 - 不要修改 rust/crates 下的代码除非被明确委派写完保存即可——下次任何 Agent 启动时CCB 会自动把这份内容注入给它们。幕后机制CCB 如何把共享记忆分发给每个 Agent这是共享记忆最巧妙的设计。每个 Agent 启动前CCB 会生成一份记忆包memory bundle按固定顺序拼装四类内容CCB 运行时协作规则由 CCB 生成保证ask提交即停、结果链续跑等控制契约始终最新CCB 共享项目记忆你的.ccb/ccb_memory.mdProvider 原生项目记忆按各 provider 的内存所有权策略决定是否合并Agent 私有记忆.ccb/agents/agent/memory.md。随后这份记忆包会被投影到每个 provider 各自认识的位置无需你手动同步Provider投影目标路径Claude Code.ccb/agents/agent/provider-state/claude/home/.claude/CLAUDE.mdCodex.ccb/agents/agent/provider-state/codex/home/AGENTS.mdGemini.ccb/agents/agent/provider-state/gemini/home/.gemini/GEMINI.mdOpenCode生成 agent 专属opencode.jsoninstructions指向记忆包渲染与物化的核心实现分别在 lib/project_memory/renderer.py 和 lib/project_memory/materializer.py。整个过程是幂等的内容没变就不重写文件写入失败也只会警告降级不会阻塞 Agent 启动。共享记忆 vs Agent 私有记忆如何分工项目里还有一个可选的私有记忆文件.ccb/agents/agent/memory.md用于某个 Agent 的个性化信息共享记忆.ccb/ccb_memory.md全队可见适合大家都必须知道的规则私有记忆.ccb/agents/agent/memory.md只注入给该 Agent适合个人偏好、专属注意事项两个文件都是用户数据CCB 的常规启动流程永远不会删除或改写它们。一个实用组合把提交信息用英文、Conventional Commits写进共享记忆把我习惯先列 TODO 再动手写进某个 Agent 的私有记忆。团队协作要不要把 .ccb/ccb_memory.md 提交到 Git默认情况下.ccb/目录属于本地运行时状态应整体忽略.ccb/*但如果希望团队成员共享同一套 Agent 协作规则这正是共享记忆的价值所在只需白名单放行这一个文件.ccb/* !.ccb/ !.ccb/ccb_memory.md注意官方刻意不强制放行.ccb/ccb.config因为里面可能含 API Key、URL 等敏感路由信息。相关文档与源码想深入了解 CCB 项目共享记忆的完整契约与实现可以阅读设计计划docs/ccb-project-shared-memory-plan.md配置与目录布局契约含共享记忆文件归属规则docs/ccb-config-layout-contract.md记忆模板与分发实现lib/project_memory/多语言 README含共享记忆使用说明README/zh.md小结.ccb/ccb_memory.md用最小成本解决了多智能体协作中的信息孤岛问题——一处编写、自动创建、永不覆盖、按 provider 精准分发。配合/ask跨 Agent 通信你的 AI 编码团队从此拥有统一的团队大脑 。【免费下载链接】claude_codex_bridgeVisible multi-agent CLI workspace for mixing Codex, Claude, Gemini, Kimi, Qwen, Cursor, Copilot, Pi, OpenCode, and other AI coding agents项目地址: https://gitcode.com/gh_mirrors/cl/claude_codex_bridge创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考