组织 ops agent 的五个组成部分

一个组织的 ops agent 由五样东西组成：身份与路由、宪法、私人记忆、执行能力、进化回路。少了前两样，它只是一个会聊天的助手；少了后两样，它会和组织一起老化。每个组织配一个，不是每个仓库配一个。

五件套复制本节链接

① 身份与路由复制本节链接

身份要写清楚三件事：管什么、不管什么、什么时候必须停下来问人。实现方式有两种：

不管哪种实现，身份文件的内容都差不多。以组织 A 的 subagent 写法为例：

---
name: org-a-ops
description: 组织 A 的 ops agent。处理跨仓库决策、成员与权限、发版部署 SOP、复盘归档。
memory: user
---

你是这个组织的 ops agent，在 ops 仓里工作。

## 你管什么
- 跨仓库决策（decisions/）、协作剧本（playbooks/）、复盘（retros/）
- 成员入职、权限变更、发版、部署：按对应的 SOP skill 执行，不临场发挥

## 动手之前
1. 先读 CLAUDE.md 里的红线
2. 在 decisions/ 里找和这件事相关的 ADR；找不到就问，不要自己拍板
3. 涉及权限、删除、对外发布的操作，先列计划，等人确认

## 不归你管
- 某个代码仓内部的实现 → 请用户到那个仓库里开会话
- 另一个组织的事 → 交回个人总助手

每个组织用一个唯一的名字，比如 org-a-ops、org-b-ops。memory: user 的记忆目录按 agent 名区分，两个组织都叫 org-ops，就会共用同一份记忆，正好违反后面说的“两个组织不能混用”。如果这个 agent 只在 ops 仓里用，也可以改成 memory: local，让记忆按项目隔离。要注意，这只是把记忆分开存放，不是访问控制：同一台机器上的任何会话都读得到这些文件。真正需要隔离的内容，靠仓库权限和账号来分。

② 宪法：团队共同遵守的结论复制本节链接

宪法放在 ops 仓，走 PR、经过审查，人人可查：ADR 记决策，playbook 记协作方式，runbook 记操作步骤，复盘记发生过的事，红线记绝对不能做的事。

ops agent 不需要背下宪法，只需要知道去哪找、什么时候必须找。这和 OpenAI 在《Harness engineering》里的做法一致：入口文件只写一页“地图”，细节放进结构化的 docs/，那里才是唯一的事实来源。

红线要尽量下沉成系统规则。能写成 deny 规则或 hook 的，就不要只写在文档里（见权限规则）。

③ 私人记忆：你个人的判断复制本节链接

有些东西不该进宪法：你对某个合作方的判断、你偏好的决策方式、还没验证的猜测。它们放在私人记忆里，不进 git，不经审查。

我的做法是在 ops agent 的 skill 目录里放一个 memory/，在 SKILL.md 里写明什么时候读、什么时候写。Claude Code 也有原生的写法 📚业界做法：subagent 定义里加 memory 字段。user 存在 ~/.claude/agent-memory/<名字>/，按 agent 名区分、跨项目、不进 git；local 存在项目的 .claude/agent-memory-local/<名字>/，按项目隔离、不进 git；project 存在 .claude/agent-memory/<名字>/，进 git、团队共享。前提是自动记忆没有关闭。

公开和私人怎么分、为什么不要再加新的存储，见记忆分层。

④ 执行能力：SOP 打包成插件复制本节链接

ops agent 动手做事，靠的是 SOP skill（打包、部署、合并上游、成员入职这类重复操作）、hook、CI 卡点和 MCP。只在你本机能用的 SOP，团队用不上。🧪试用中 把它们打包成插件，放进一个私有 GitHub 仓库做团队插件市场：

{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": { "source": "github", "repo": "<组织>/<插件市场仓库>" }
    }
  },
  "enabledPlugins": {
    "org-a-ops@team-tools": true
  }
}

一个限制要提前知道：插件里带不了权限规则。插件的 settings.json 只认 agent 和 subagentStatusLine 两个键，通用的 deny 只能做成插件里的 hook，或者由一个 setup skill 写进各仓库的 settings（见让 ops 和项目一起进化）。

⑤ 进化回路复制本节链接

宪法不会自己更新。ops agent 的最后一块，是让每次复盘真正改变点什么：复盘 → 规则 → hook；用 /schedule 建一个每周跑的园丁 agent，读新复盘、提 PR 更新 playbook、查失效链接；定期体检护栏还在不在。这三件事我还在试，单独写在让 ops 和项目一起进化。

粒度：每个组织一个复制本节链接

• 按仓库拆：宪法被复制成多份，各自漂移；跨仓库的问题没有人管
• 所有组织共用一个：权限边界和保密内容混在一起，迟早串台
• 每个组织一个：正好和权限边界、成员、决策的范围对齐

跨组织的事，交给最上面的个人总助手路由（结构见组织篇首页）。

起名：避开 AIOps复制本节链接

AIOps 在业界已经是固定术语，指用 AI 做 IT 运维：告警聚合、异常检测、根因分析。拿它给自己的 ops agent 起名，搜索、沟通、向别人解释的时候都会混淆。用“组织名 + ops”，或者干脆起一个独立的名字。

业界对应的理念复制本节链接

更完整的讨论见背后的理念。

常见坑复制本节链接

• 模板复制后会各自漂移
• 同一个组织的记忆不要按目录分裂
• 防护规则会悄悄失效

相关复制本节链接

• ops 放哪：独立仓还是放进项目
• 记忆分层
• 子 agent 提示词模板
• 背后的理念