agent-organizationlisted
Install: claude install-skill Trustbaselab/trustbase-skills
# Agent 组织化
## 何时使用
- Agent 数量从 3 个涨到 10 个以上,开始说不清「谁负责什么」
- 出了故障,翻日志才能定位到是哪个 agent
- 两个 agent 在做同一件事,或者互相等对方
- 想加新 agent,但不知道挂在哪里、向谁汇报
- Agent 数量在涨,总产出没涨
**不适用**:
- 只有 1–3 个 agent → 直接写清楚每个的职责就够了,不需要组织结构
- 纯粹的 pipeline(A→B→C 固定流转)→ 那是工作流不是组织,用 DAG 编排
- 需要的是**技术框架**(调度器、消息队列)→ 这是**管理问题**,换框架解决不了
---
## 一、先诊断:你现在有的是「集合」还是「组织」
**四个判据,中任意一条就说明还是集合:**
| # | 判据 | 检查方法 |
|:-:|---|---|
| 1 | 定义与注册不一致 | 配置文件里的 agent 数 ≠ 运行时数据库里的数 |
| 2 | 有成员没有汇报关系 | 遍历所有 agent,`reports_to` 为空的 |
| 3 | 有成员没有权限边界 | `boundaries` 为空的 = 不知道它能写什么 |
| 4 | 只有运行次数没有产出指标 | 能回答「跑了没」,不能回答「干得好不好」 |
**⭐ 更柝 2026-11-15 的真实诊断结果:**
```
yaml 定义 12 个
DB 注册 21 个 ← 判据 1 命中:差 9 个
缺 reports_to 9 个 ← 判据 2 命中
缺 boundaries 20 个 ← 判据 3 命中(只有 1 个有)
缺 kpi 21 个 ← 判据 4 命中(全部只有 runs/fails 计数)
```
**结论:它有 21 个 agent,但不是组织。**
---
## 二、三原则(李彦宏 2026-11-12 百度世界)
| 原则 | 原文 | 落地成什么 |
|---|---|---|
| **打破岗位边界** | 岗位是工业时代的单元,任务是智能时代的单元 | 不把 agent 绑死在固定职责上,按任务调度 |
| **沉淀隐性知识** | 个人经验显性化并沉淀到平台,才构成组织智能 | 建 `handbook/`,每个坑写成规则 |
| **设计流程闭环** | 「可衡量 + Looping = 持续进化」 | 每个 agent 有 KPI,失败必须回写规则 |
**⭐ 最有用的判断:** 如果一本手册删掉后组织照常运转,它还没形成组织智能。
---
## 三、四件套:任何一个 agent 必须有的四个属性
**缺任何一个,这个 agent 就是管理黑洞。**
```yaml
- name: xxx
role: "English Role / 中文名" # ① 它是谁
reports_to: vigiliae # ② 向谁负责
boundaries: # ③ 它能做什么
allow: ["read data", "append record"]
deny: ["delete records", "publish ext