Knowledge

九角色 Agent 组织图:决策所有权、词汇纪律与资源绑定

九角色 Agent 组织图:决策所有权、词汇纪律与资源绑定

九宫格机器人工作证墙:九个 Agent 角色各占一格,人类只出现在战略一格

系列:Idea-to-Production · 概念篇

给 Agent 起名字很容易,给它们划决策边界很难。当两个 Agent 都”觉得”自己该改同一份架构文档时,角色扮演就破产了。本文讲九角色组织图背后真正的工程问题:哪些决定归谁、词汇如何禁止漂移,以及为什么”角色”必须是资源绑定的单位,而不是提示词里的人设。

为什么值得看

多数多 Agent 系统的”角色”停留在角色扮演:同一个模型换个 system prompt,演产品经理、演工程师。这样的角色一遇冲突就失效——两个角色都”觉得”自己该改架构文档,谁说了算没有答案,因为”谁该改哪份文档”从来没人写下来。

我们的组织图是一份权限与工件所有权的分配方案:每个角色拥有什么决定、产出什么文档、运行哪些循环,全部写在定义里,并且有一个跨仓库的词汇纪律防止它腐化。

你将学到三点

  1. 角色 = 决策所有权 + 工件所有权 + 常驻循环三件套,缺一件就只是人设。给 Agent 分工,先分工”谁有权改哪份文档”。
  2. 一套词汇、两种拼写:角色的内容文件夹名与运行时 ID 严格 1:1 映射;改名必须全仓库清扫,否则作业路由会静默失效。
  3. 平台职能不要伪装成角色:锁回收、失联标记这类机件级职责,交给平台看门狗和文档化标准,比虚构一个”监督 Agent”更诚实。

组织图本体:谁拥有什么决定

九个角色,各自的答案是”独占一块决策权”:

角色 拥有的决定 常驻循环
产品与项目管理 战略、需求定义、任务派发(两棒)、每日 issue 分诊 分诊每日 09:00
工程架构 方案与核心模块设计、仓库脚手架、设计任务裁决、每日 PR 评审 PR 巡检每日 09:00
全栈工程 详细设计、实现规划、按特性实现与单元/集成测试 随任务队列
UI/UX 与文案 界面设计、交互流、产品文案、已发布应用文档 随任务队列
QA 与发布 E2E 策略与执行、CI/CD、发布、事故回滚 E2E 每日门禁;发布每月 1/15 日
服务与数据运营 用量/订阅/健康/漏斗四类报告 双周派发、7 天窗口
市场与增长 社交内容、增长与竞品报告、需求回传 双周派发、7 天窗口
行政与财务 每周公司治理报告:效率与成本(含 token 用量)、迭代节奏、质量信号三章 每周一 09:00
自主迭代哨兵 平台侧:锁回收、失联实例标记;质量评审已溶解进检查点与发布门 常驻看护,无排班

三个观察,比表格本身更重要。

派发权只有一个来源

只有 PM 角色能批量造任务并派发(两棒派发),其他角色可以新建单条任务(如发现 bug 给全栈),但不能重组计划。这避免”谁都能插单”导致的依赖图腐烂。

质量不是角色,是机制

哨兵角色的历史版本曾是”全量质检员”,最终我们把它的评审职能溶解成两条规则:逐交付物评审检查点(无 PASS 不算 Done)和集成面发布门(BLOCK 即阻断)。剩下的机件职能——回收过期锁——本来就该由平台代码实现。让 Agent 去巡检锁表,等于给确定性机件加上不确定性执行者。

回滚不需要人,但需要写下来的标准

QA 角色的事故回滚不是临场判断,是文档化的决策标准:观察期内的部署回归、Sev-1、错误预算耗尽且回归信号为正——满足才回滚。回滚 = 用最后一个健康 tag 重跑部署链,随后仍走两阶段关闭,把 bug 交回需求环。

词汇纪律:两种拼写,一个真源

同一个角色在系统里有两种名字:知识层里的内容文件夹(如 agents/product-program-manager/)和调度层里的运行时 ID(如 agent-pm)。它们 1:1 映射,且这条映射被定为不容协商的不变式:

这条纪律的成本极低(一次清扫),收益在故障模式上:词汇漂移的症状是”某类任务神秘地无人执行”,没有报错、没有日志,只有看板上的沉默积压。

给 Agent 系统做可维护性设计,首先是给它的命名空间做。

角色作为资源绑定的单位

组织图不只是文档结构,它是部署单位。工作实例创建时唯一的必填项就是角色;绑定该角色的全部资源——Agent 定义、技能、工作流、领域知识——自动进入实例工作空间。对比架构师与 PM 两个角色,绑定的技能与工作流几乎完全不重叠:

同一工作站上两个角色实例的资源绑定对照:架构师绑定方案设计、脚手架与评审技能,PM 绑定需求、派发与分诊工作流,几乎不重叠

这带来一个很实用的推论:改进某个角色的能力,只需要改知识层对应文件夹,所有同角色实例即刻生效(符号链接,详见《为什么要拆成三个仓库:知识、调度、档案的分离法则》);而扩容某个角色的吞吐,只需要多开实例,不需要改任何定义。能力演进与容量伸缩沿着同一条角色边界解耦。


总结

  1. 画你的 Agent 组织图时,先写”决策与工件的所有权表”——谁能改哪份文档、谁能造任务、谁的标准触发回滚——再写角色简介;顺序反了就会得到一群互相踩线的聊天人格。
  2. 把角色名当作公共 API 管理:1:1 映射、单点定义、改名走清扫。命名空间纪律是多仓库 Agent 系统最便宜的可观测性。
  3. 检查你的”质检/监督”角色是不是机件伪装:凡是要求确定性、周期性、幂等性的职责(回收锁、巡检过期、去重),应该在平台代码里实现,而不是托付给一个 LLM 工位。

同系列下一篇:《人不在环内:一个 AI 自主交付组织的概念契约》,讲这套组织图背后的概念契约。

📖 Read in English

← Back to all articles