一句话复制你的AI协作体系：如何把Synapse发给同事

一句话复制你的 AI 协作体系：把 Synapse 发给同事的实践

我搭 Synapse 的时候，没想过”怎么让别人用”这个问题。体系跑起来了，团队工作流顺了，情报管线自动推送，CEO Agent 每天定时汇报——感觉挺好。直到有一天一个朋友问我：你这套东西，我能直接用吗？

我顿了一下。怎么给他？发一堆 YAML 文件？写一份安装文档？还是把整个 Git 仓库 clone 过去再陪他调三天？这个问题让我意识到，一个 AI 工作流体系能不能被复用，和它本身做得好不好，几乎是两件完全独立的事。

问题出在哪里：体系是”活”的，文档是”死”的

传统软件工具的传播路径是：写好文档 → 用户照着安装 → 配置 → 运行。AI 协作体系不一样。Synapse 的核心不是代码，是 CLAUDE.md 这个 Harness 配置文件——它定义了 AI 的角色、决策层级、执行禁区、派单规则、跨会话状态管理。换句话说，行为规则和部署配置是同一个文件。

这就是关键：Prompt 本身就是部署文档。CLAUDE.md 里写”Lysander 被明确禁止直接调用 Bash 工具”，不是注释，不是说明——Claude 读到它，这条规则就生效了。我不需要额外写”如何安装这个限制”，限制就活在配置文本里。

所以当朋友问”怎么用”的时候，正确答案不是发文档，是：把 CLAUDE.md 发过去，让他把里面的 Lysander、刘子杨、Synapse-PJ 替换成他自己的信息，然后在新的 Claude Code 会话里打开项目。整个体系，包括 AI 的角色定位、执行链流程、决策分级、派单制度，全部随着这一个文件加载生效。

可移植性的前提：规则要内聚，不要散

这里有一个设计上的教训。早期我的 Synapse 规则是散的——部分在 CLAUDE.md，部分在 Python 脚本里，还有一些是靠 Hook 触发的 Shell 命令。每次我想解释”为什么 AI 会这样工作”，都要拉出三四个文件。朋友想复用，他要理解所有这些才能改动任何一处。

后来我做了一次收敛：把行为规则全部回归 CLAUDE.md，把代码层的东西（Hook 脚本、拦截器）降格为执行工具，而不是规则定义者。规则只有一个权威来源。这样做之后，“传播成本”一下子降了很多——我可以说：你只需要理解这一个文件。

具体来说，Synapse 的 CLAUDE.md 现在承担三件事：Guides（前馈控制，定义 AI 该怎么做）、Workflow（结构化流程，定义执行链步骤）、Constraints（约束系统，定义 AI 不能做什么）。这三层是内聚的，不是散装的。

个人化配置：一张替换表解决适配问题

第二个实际问题是个人化。我的 Synapse 里有我的名字、我的 CEO 名称、我的公司叫法。朋友要用，他不想接管一个叫”Lysander”的 AI，他要它叫他自己的 AI CEO 名字。

解决方案很粗暴但有效：在 CLAUDE.md 顶部放一张配置替换表，列清楚哪些词需要 Ctrl+H 全局替换，每个配置项的说明是什么，预计耗时 3 分钟。就这样。不需要环境变量，不需要 .env 文件，不需要运行时配置注入——因为 AI 读文本，文本里写的就是它认识的。

这个设计决策背后是一个认知：AI 工作流的”配置文件”是自然语言，修改它不需要懂代码。朋友的 PM 同事，不懂 Python，不懂 YAML schema，但他能做 Ctrl+H 替换。体系对他来说就是可用的。

剩下的摩擦点：状态和工具依赖

当然不是零摩擦。Synapse 有两部分不在 CLAUDE.md 里：一是跨会话状态（active_tasks.yaml，记录进行中任务），二是外部工具依赖（n8n 定时触发、Slack 通知、Claude Code Scheduled Agents）。

状态文件可以从空文件开始，新用户第一次用不需要历史状态，这部分问题不大。工具依赖是真实的成本——如果朋友没有配置 n8n，定时触发的情报管线就跑不起来。但这是功能降级，不是体系崩溃。没有自动化，手动跑同样的 Prompt，核心的执行链和决策体系仍然有效。

这让我意识到一个原则：体系的核心行为要能在最小依赖下运行，自动化是增强，不是前提。一个 AI 协作框架，如果没有 Webhook 就完全跑不起来，它的传播成本会非常高。

总结：Prompt 即部署文档的三条原则

回到最初的问题——怎么把这套东西发给同事？现在我的答案是：发仓库，让他读 CLAUDE.md 顶部的个人化配置说明，5 分钟内完成替换，打开新会话，体系生效。

这背后有三条可复用的原则：

1. 规则内聚，单一权威来源。 行为规则只活在一个地方。散装规则是传播的杀手。

2. 自然语言配置，不要代码化。 AI 读文本，配置就写在文本里。个人化靠替换，不靠环境变量。

3. 核心功能最小依赖，自动化按需叠加。 体系的本质行为要能在没有外部工具的情况下运行，自动化是加速，不是前提。

如果你在构建 AI 工程团队，欢迎参考我们开源的 Synapse 框架。它不是另一个 AI 聊天界面，而是一套关于”如何让 AI 在团队里稳定协作”的工程实践——角色体系、执行链、决策分级、跨会话状态管理都在里面。