AI Native 手册
组织篇

组织:什么时候需要 ops

多仓库、多人协作之后,单靠每个仓库的 CLAUDE.md 不够用了

亲历组织阶段 · 通用更新于 2026-10-16

当同一个组织有了第二个要共享规则的代码仓库,或者有了不该让所有写代码的人看到的内容,单靠每个仓库各自的 CLAUDE.md 就管不住了。这时候要升到组织档,多做四件事:建一个 ops 仓放跨仓库的结论,给组织配一个 ops agent,把记忆分成公开和私人两层,让规则能自动回流到每个项目。

为什么每个仓库一份 CLAUDE.md 不够

我同时运营两个组织:十几个代码仓库、几十个 agent、几位协作者。在有 ops 之前,问题是一点点冒出来的:

  • 同一条规则在三个仓库的 CLAUDE.md 里各写一遍,改了一处,另外两处还是旧的
  • 跨仓库的决策(命名、权限、谁负责什么)没有归宿,只能写在某个 PR 描述里,半年后谁也找不到
  • 事故复盘里有客户和商业细节,放不进将来要开源的代码仓
  • 在 A 仓库里开的会话,不知道 B 仓库上周刚定下的事

这些都不是“写得不够多”,而是没有一个专门放“组织层面”东西的地方。

升档信号

下面三条满足任意一条,就该从产品档升到组织档(完整判断见选档):

信号你会看到的症状
同一组织有 2 个以上代码仓库,要共享规则和决策同一段规则在多个 CLAUDE.md 里复制粘贴
有不该让所有写代码的人看到的内容,或者代码仓是一个上游项目的 fork复盘、客户信息、权限清单不知道往哪放
有不写代码的协作者(运营、市场、商务)他们要看 SOP,却得去代码仓里翻

反过来,只有一个仓库的产品不需要 ops 仓;只是打算开源、或者有长期有效的决策,在仓库里放一个 docs/adr/ 就够了。这本手册自己就是产品档:它的写作规范放在仓库根目录的 STANDARDS.md,不需要 ops 仓。

组织档要多做的四件事

这也是我建议的落地顺序:先建 ops 仓,把跨仓库的决策和复盘搬过去;再配 ops agent;记忆分层随用随整理;进化回路最后补,但不能不补。我自己就是前三件做得勤、第四件补得晚,结果吃了亏(见让 ops 和项目一起进化)。

我的结构

个人总助手                  跨组织路由:这件事归哪个组织、交给谁
├── 组织 A 的 ops agent     这个组织的宪法、权限、复盘
│   ├── SOP skill
│   └── SOP skill
└── 组织 B 的 ops agent
    ├── SOP skill
    └── SOP skill

三层各管一件事:

  • 个人总助手:一个用户级 skill,只做路由。它不存任何组织的规则,只判断“这件事归谁”,然后交给对应组织的 ops agent
  • ops agent:每个组织一个。它知道这个组织的宪法(ADR、playbook、红线)放在哪,知道哪些事可以直接做、哪些必须先问人
  • SOP skill:可重复的具体操作,比如打包、部署、合并上游、给新成员开权限。它们大多是从反复手工执行的操作里提炼出来的

粒度是每个组织一个 ops agent,不是每个仓库一个。权限、成员、跨仓库决策都是组织层面的;按仓库拆,同一份宪法会被复制成很多份,然后各自漂移。两个组织也不能共用一个:它们的权限边界和保密内容不同,混在一起,迟早会把一个组织的信息带进另一个组织的文档里。

常见坑

相关

本页目录