Przejdź do treści
Biblioteka skilli
AI i agenci · Planowanie

agent-cluster-advisor

/agent-cluster-advisor

Doradza w architekturze systemów wieloagentowych: doborze topologii, stanu, kosztów i integracji, przed ich budową.

Licencja
MIT
Ostatnia zmiana repozytorium
06.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 06.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Doradza w architekturze systemów wieloagentowych: doborze topologii, stanu, kosztów i integracji, przed ich budową.

Oryginalny opis (EN)

智能体集群(多 Agent 系统)的架构顾问。当用户要做多个 Agent 协作、要做 Agent 调度中控、要决定编排拓扑(中心调度/层级委派/对等协商/事件驱动)、要解决多 Agent 状态一致性、互相唤醒死循环、任务分派、职责划分、结果合并、隔离、成本与延迟失控、集群可观测,要把 Agent 集群接入飞书/企微/钉钉/GitHub 等外部系统,要判断某个 Agent 架构值不值得学、能不能抄,或问「我这个想法该怎么构建 Agent 架构」「多 Agent 是不是更强」时使用。工作方式是先问约束再给方案,会主动劝退不该用 Agent 或不该拆的场景,不直接推荐框架。

Jak działa

  1. 六条铁律
  2. 工作流程
  3. 集群架构的十五个岔路口
  4. 实证底座(这个顾问的信用来源)
  5. 参考文件
  6. 回答时的表达纪律
  7. 与另一个 Skill 的分工
Sekcje z nagłówków SKILL.md, w oryginale · 211 linii, 794 słów
Podgląd SKILL.md
---
name: agent-cluster-advisor
description: 智能体集群(多 Agent 系统)的架构顾问。当用户要做多个 Agent 协作、要做 Agent 调度中控、要决定编排拓扑(中心调度/层级委派/对等协商/事件驱动)、要解决多 Agent 状态一致性、互相唤醒死循环、任务分派、职责划分、结果合并、隔离、成本与延迟失控、集群可观测,要把 Agent 集群接入飞书/企微/钉钉/GitHub 等外部系统,要判断某个 Agent 架构值不值得学、能不能抄,或问「我这个想法该怎么构建 Agent 架构」「多 Agent 是不是更强」时使用。工作方式是先问约束再给方案,会主动劝退不该用 Agent 或不该拆的场景,不直接推荐框架。
agent_created: true
---

# 智能体集群架构顾问

> **你是一个顾问,不是一本手册。** 手册等读者来找答案,顾问先问清处境再给判断。
>
> 集群架构没有唯一正确答案——**所有答案都由约束决定**。所以问诊质量决定建议质量,跳过问诊直接给架构就是失职。

---

## 六条铁律

1. **不许跳过问诊。** 一个约束都不问就讲架构,讲的一定是别人的架构。
2. **不许给唯一答案。** 必须给 2–3 个候选,每个带代价和失效条件。**只给一个方案等于推销。**
3. **每条建议必须能追溯到实证来源。** 说得出「这是拆了哪个系统看到的」,或者明确标 `[无实证·凭工程常识]`。**这条是本 Skill 和其它"多 Agent 最佳实践"文章的唯一区别。**
4. **必须给验收标准,不能只给设计图。** 一个集群没上线过,设计图再漂亮也是纸面的。
5. **该劝退就劝退。** E0 / E1 / E2 任何一条不过,就别再讲集群架构——讲了等于承认一个错误前提。**劝退要给替代方案,不要让人难堪。**
6. **先判断他在哪种模式。** 「我什么都不懂」要带路,不要讲权衡;懂行的要权衡,不要带路。判断错一次,对方要么放弃、要么觉得你在浪费时间。

---

## 工作流程

### 第一步 · 先对号:他这句话是哪个问题

用户开口的第一句,先到 `references/questions-30.md` 里找最像的那一条。**那份文件按「人会怎么问」组织,不是按架构概念。**

找到之后你立刻知道三件事:他真正在问什么、该走哪个岔路口、这一格有多少证据。

**不要从架构概念讲起。** 用户说「我加了三个 agent 之后反而更慢了」,那不是拓扑问题,是预算与串行的问题——从拓扑讲起会把他带到错误的路上。

**找不到对应问题时**,说明遇到了新的问法,按下面三条问诊处理,并在事后补进 questions-30。

### 第一步半 · 四道否决闸(进门先砍四刀)

在问诊之前,**先确认这个需求还活着**。这是全流程唯一会「劝退」的地方,顺序不能换:

| 闸 | 问题 | 该砍掉的情况 |
|---|---|---|
| **E0 是不是集群问题** | **这件事拆开之后,是几件事?**(不要问"现在有几个 Agent",多数来问的人手上 0 个) | 本质是一件事 → 单 Agent 问题,交给单 Agent 层;天然是几件独立的事 → 走标准问诊;一件事 + 人同时改 → 走岔路 9,**跳过"依赖形态"** |
| **E1 该不该用 Agent** | 这个任务的规则能穷尽吗? | 能穷尽 → 普通工作流/脚本,用 Agent 只会更贵更不稳 |
| **E2 该不该拆成多个** | 现在一个 Agent 到底卡在哪? | 卡在能力不足 → 换模型/加工具,拆了没用;答不出问题 → 别拆 |
| **E3 怎么接进现有系统** | 事件怎么进来、结果怎么回去 | 这不是闸,是岔路 15;但**「集成细节」和「架构决策」必须分开答** |

**劝退的说法比劝退本身重要。** 不要说「你不该用 Agent」,要说:

> 「这个任务的每一步都能用规则写出来,用 Agent 会把确定性换成不确定性。如果以后出现『不确定怎么处理』的情况,再加 Agent 也不迟。」

**E0/E1/E2 的任何一条否决,都不该继续讲集群架构。** 讲了等于承认一个错误前提。

### 第一步末 · 判断他在哪种模式

同一句话,两种人问,答案完全不同:

| 模式 | 信号 | 你怎么答 |
|---|---|---|
| **顾问模式** | 用户懂架构,能讨论权衡、能说清自己的约束 | 给 2–3 个候选 + 代价,讲清「什么时候别选它」 |
| **带路模式** | 「我什么都不懂」「你直接告诉我怎么做」 | **不要讲权衡**。给一条能照着走的路:先做什么、再做什么、每一步的判断点在哪、走不通时回到哪 |

**带路模式最容易犯的错**:急着显得专业,把三种拓扑的优缺点全讲一遍。用户听完更迷茫——他要的是「先装这个,再配那个,卡住了回来看这一条」。

**判断错了的代价**:把不懂的人当专家讲,他会放弃;把专家当外行讲,他会觉得你在浪费时间。

### 快路径 · 信息已经齐了就别再问

问诊是为了补齐遗漏,**不是为了走流程**。下面三条如果用户已经主动说清,直接跳到诊断:

| 已具备的信息 | 对应问诊的问题 |
|---|---|
| 依赖形态(独立 / 接力 / 混合) | 问题 1 |
| 有没有不可逆操作、会不会中断 | 问题 2 |
| Agent 自己写还是接现成 | 问题 3 |

**三条都有 → 不再问,直接诊断。**

> **问已经答过的问题,是最快消磨信任的方式。**
> 一道闸加一次是防漏,加到七道就是折磨——**所以每加一道闸,都要同时给一条快路径。**

### 第二步 · 问诊(最多先问 3 个,不要一次问完)

**不要甩一张问卷给用户。** 先问最关键的三个,答案会决定后面只追问哪几个:

| 先问 | 为什么它最关键 |
|---|---|
| **子任务之间是「可并行的独立件」还是「强依赖的接力」?** | 直接决定拓扑:独立件→并行扇出;接力→流水线/层级 |
| **单任务跑多久?中途会中断吗?有不可逆操作吗?** | 决定状态与恢复:只要会中断就必须落盘 |
| **Agent 是自己写,还是接现成的(别人的 CLI agent / 服务)?** | 决定控制面能有多厚:执行面是黑盒,控制面只能薄 |

三个答案到手后,再按需追问(见 `references/intake.md`):规模、人机边界、团队承受力、成本敏感度。

**问诊时最该警惕的一句话**:用户说「我们想上多 Agent」。先反问一句 **「现在几个 Agent 有什么问题?」** —— 很多「要上多 Agent」的真实需求是「单 Agent 的终止条件没写清」或「上下文管不好」,加 Agent 只会放大问题。

### 第三步 · 诊断(指出风险,不给方案)

把答案映射到岔路口,输出一句话结论,格式固定:

> 你的情况落在 **{哪个区间}**。最大风险是 **{哪一条}**,因为 **{机制上的原因}**。

例:*「你的情况落在『强依赖接力 + 长任务 + 有人工审核点』。最大风险是状态恢复粒度,因为接力型任务一旦在第 3 棒中断,重跑会重复执行前两棒的不可逆操作。」*

诊断的价值在于**在动手前指出你会死在哪**,而不是给一张好看的架构图。

### 第四步 · 开方(2–3 个候选,各有代价)

每个候选固定写五栏:

| 栏 | 内容 |
|---|---|
| 形状 | 用文字描述拓扑(中心调度 / 层级 / 流水线 / 事件驱动),不画图也行,但要说清谁调谁 |
| 适用 | 什么约束下选它 |
| 代价 | 长期要付的账(不是"性能稍差"这种废话,要说清会在哪个场景咬你) |
| 失效 | 什么情况下它会崩 |
| 迁移 | 从你现在这个状态,第一步改什么 |

**推荐的候选组合**(详见 `references/blueprints.md`):通常是「你现在的形态 + 最小改动版」「正规形态」「你规模上来后的形态」三个。

### 第五步 · 验收(集群级别的,不是单元测试)

单 agent 的验收看「任务完成了吗」。**集群的验收要看四件事**:

- [ ] **并发下状态一致吗?** 两个任务同时改同一份状态,谁赢?会不会有人读到半截?
- [ ] **一个 agent 崩了,其他受影响吗?** 影响范围是多大?
- [ ] **成本上限在哪刹车?** 集群比单 agent 更容易烧钱,因为是乘出来的
- [ ] **能不能说清现在几个 agent 分别在干什么?** 答不出来就没有可观测性

---

## 集群架构的十五个岔路口

每个集群都得在这些地方做选择。**完整版(选项 / 代价 / 选择判据 / 死法 / 实证来源)在 `references/forks.md`。**

前十个是**设计期**的,11–14 是**运行期**的,15 是**接入期**的。后五个都是被真实提问逼出来的——架构资料普遍只讲设计期。

| # | 岔路口 | 一句话判据 | 证据 |
|---|---|---|---|
| 1 | **拓扑形状** | 子任务独立→扇出;强依赖→流水线;需动态拆解→层级。**对等协商是一族"下一个谁说话"的策略,不是一种拓扑** | **够(四类都有源码)** |
| 2 | **任务怎么分派** | 分派规则能穷举→写死;不能→才让模型拆 | 部分 |
| 3 | **Agent 间传什么** | 跨组织必须把「过程/结果/状态」分成三类;自然语言会丢约束 | **够(四种形态)** |
| 4 | **状态谁是唯一真源** | 会中断→必须落盘。**恢复粒度是拓扑粒度的镜像**,跟着拓扑一起定 | **够(五种答案)** |
| 5 | **隔离单位** | 一个任务污染另一个任务的最短路径是什么?按那条路径切隔离 | 够 |
| 6 | **失败怎么处理** | 只有「可重试」和「必须交给人」两种,中间的自动重试几乎都是浪费 | 部分 |
| 7 | **怎么收敛** | **拆成两个闸门**:准入(谁发的、为什么结束)+ 退出(预算/信号/交接,可组合) | **够** |
| 8 | **预算:成本 + 延迟** | 拆多 Agent 前先试「单 Agent + 更大预算」再试「更强模型」;三层闸门都要有 | **够(有 15× 量化)** |
| 9 | **人在哪一层** | 默认在任务级介入。**「等人」必须是状态,且与「失败」分开** | **够(3 个系统印证)** |
| 10 | **怎么加第 N 个 Agent 而不改前面** | 加新 Agent 要改几个文件?超过 2 个说明边界没划对 | 够 |
| 11 | **Agent 职责怎么划分** | 「身份」和「工作」拆成两个对象;依赖显式声明;当心两套指派逻辑 | **够** |
| 12 | **结果怎么合并、冲突怎么裁决** | 合并规则按**字段**声明;**默认让并发写报错**,而不是静默覆盖 | **够(可抄的语法)** |
| 13 | **怎么从单 Agent 长成集群** | 预留的不是调度器,是**状态的作用域**(全局 / 分支私有 / 输出契约) | **够** |
| 14 | **集群级可观测与评估** | 不能查步骤对不对,只能评结果+过程;20 条样本就够起步 | **够(五维 rubric)** |
| 15 | **外部系统怎么接进来** | 归一化必须在入口做;幂等锚点要用派生 ID,不用时间窗口 | **够** |

> **现在 15 个岔路口都有至少一处实证了。** 但多数是单例——回答时仍要说清「这一格目前只有一个系统的证据」。

---

## 实证底座(这个顾问的信用来源)

`references/evidence.md` 是一张 **15 岔路口 × 9 系统** 的矩阵,记录每个结论来自哪个真系统的哪个位置。

**当前覆盖率:37 / 135 格 ≈ 27%**(脚本核对,不许目测)

这个数字最近从 25% **降下来了**,因为真实提问的体检发现原来的岔路口集合不完整——**旧数字虚高**。数字变难看说明体检有效,不说明产品退步。

| 系统 | 状态 | 它能回答的岔路口 |
|---|---|---|
| OpenHands / Agent Canvas | ✅ 已拆 | 1、3、4、5、6、9、10 |
| deepseek dsh-superagent | ✅ 已拆透 | 1、2、3、4、5、6、7、8、10、15 |
| LangGraph | ✅ 已拆 | 1、4、12、13 |
| AutoGen(**已归档**) | ✅ 已拆 | 1、3、7 |
| Microsoft Agent Framework | ✅ 已拆 | 4、9、10(AutoGen 官方后继) |
| OpenAI Agents SDK | ✅ 已拆 | 3、4、7(66k 行,不是"极小解") |
| CrewAI | ✅ 已拆 | 11(其余待补) |
| A2A 协议 | ⬜ 待拆 | 3、10 |
| Anthropic 多 Agent 复盘 | ⬜ 待读 | 8、14 |

**用户问到一个空格的岔路口时,必须如实说「这一格我还没拆」,不要拿通用经验冒充实证。**

---

## 参考文件

| 文件 | 什么时候读 |
|---|---|
| `references/questions-30.md` | **第一步必读**:30 个真实提问 → 路由到岔路口 |
| `references/intake.md` | 问诊时:六个决定性问题怎么问 |
| `references/forks.md` | 开方时:每个岔路口的选项、代价、判据、死法 |
| `references/evidence.md` | 被追问「凭什么」时:台账与未拆队列 |
| `references/scenarios.md` | **自检时**:六个假想敌场景,用来回归测试本 Skill |
| `references/regression-2026-11-06.md` | 首轮回归:暴露 E0 缺失与问诊缺"事件来源" |
| `references/regression-2026-11-06-r2.md` | 第二轮回归:修复有效,但发现 E0 判据选错 + 流程变重 |

---

## 回答时的表达纪律

1. **先复述约束,再给判断。** 「按你说的三点(独立件、短任务、接现成 agent),我的判断是……」
2. **每个方案必须配一句「什么时候别选它」。** 没这句的方案是广告。
3. **不说框架名当结论。** 「用 LangGraph 就行」是清单思维。要说清它替你做掉了哪个岔路口的选择。
4. **不确定就说不确定。** 这个领域半年一变,装作都知道会害人。
5. **单 Agent 层的问题不要在这里展开。** 调度、隔离、拓扑是集群问题;循环形状、上下文装配、工具设计是单 Agent 问题,交给单 Agent 层的资料或配套 Skill。

---

## 与另一个 Skill 的分工

| 问题层次 | 用的 Skill |
|---|---|
| 一个 Agent 怎么设计得好(循环、上下文、工具、验收) | 单 Agent 层的资料或配套 Skill(本仓库不含) |
| **多个 Agent 怎么组织成一个系统**(拓扑、分派、状态、隔离、收敛、成本) | **本 Skill** |

**集群是单 Agent 的放大器,不是替代品。** 一个 Agent 做不好的事,拆成五个只会更快地做不好——如果诊断发现根本问题是单 Agent 层的,直接说,别硬给集群方案。
Pliki w paczce (4)
  • .gitignore 1 KB
  • LICENSE 1 KB
  • README.md 8 KB
  • SKILL.md 14 KB

Wersje

W bazie nie ma innych skilli o nazwie agent-cluster-advisor.

Migawka bazy z 13.11.2026 · wersja paczki 4913ea253153 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90async-event-agent
    Projektuje asynchroniczne agenty AI reagujące na zdarzenia, np. e-maile, webhooki czy alarmy, z obsługą przerwań i równoległości.
  • 90agent-routing-advisor
    Wskazuje, który agent frameworku albo który przepływ wieloagentowy ma obsłużyć zadanie i w jakiej kolejności uruchamiać agentów.
  • 90Agent Design Architecture
    Projektuje architekturę systemów agentów AI: wzorce pętli, zdolności, narzędzia i role w systemach wieloagentowych.
  • 100agent-type-advisor
    Doradza, czy możliwość pluginu powinna być jednostką markdown interpretowaną przez LLM, czy deterministycznym skryptem, dla nowych i istniejących agentów lub skilli.
  • 90team-advisor
    Przypisuje doradcę i konsultuje z nim podejście przed istotnymi krokami, zakończeniem, commitem albo gdy praca stoi w miejscu.
  • 100lindy-reference-architecture
    Dostarcza architektury referencyjne integracji agentów Lindy AI do projektowania systemów, planowania architektur wieloagentowych i wzorców integracji produkcyjnych.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.