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

multi-agent-orchestrator

/multi-agent-orchestrator

Kieruje pracą wielu podagentów: deleguje zadania, prowadzi równoległą współpracę i łączy zewnętrzne klienty agentów przez MCP.

Licencja
MIT
Ostatnia zmiana repozytorium
13.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.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

Kieruje pracą wielu podagentów: deleguje zadania, prowadzi równoległą współpracę i łączy zewnętrzne klienty agentów przez MCP.

Oryginalny opis (EN)

当任务涉及多子代理(Subagents)分工、/swarm(或 /teamwork)多代理并行协作、默认派 3.8f(model: flash)子代理干脏活/只读验证、大型代码库跨模块检索、需要保持主对话上下文干净、需要利用独立工作区(branch/share)做无污染实验、或需要通过 MCP 桥遥控外部客户端 Agent(如 dsh-bridge / agy-agent-bridge / dsh-crew / tianshu)时使用。指导何时及如何委派 flash-verifier、research、项目级验证子代理、自建 subagent 以及外部 MCP。

Jak działa

  1. 1. 核心目标:保护主会话上下文与注意力
  2. 2. 内部 Subagent 选型与模型分级策略
  3. 3. 内部 Subagent 委派契约与通信纪律(Prompt & Reactive Wakeup)
  4. 4. 跨客户端外部 Agent 协同(可选 MCP 桥)
Sekcje z nagłówków SKILL.md, w oryginale · 94 linii, 572 słów
Podgląd SKILL.md
---
name: multi-agent-orchestrator
description: 当任务涉及多子代理(Subagents)分工、/swarm(或 /teamwork)多代理并行协作、默认派 3.8f(model: flash)子代理干脏活/只读验证、大型代码库跨模块检索、需要保持主对话上下文干净、需要利用独立工作区(branch/share)做无污染实验、或需要通过 MCP 桥遥控外部客户端 Agent(如 dsh-bridge / agy-agent-bridge / dsh-crew / tianshu)时使用。指导何时及如何委派 flash-verifier、research、项目级验证子代理、自建 subagent 以及外部 MCP。
---

# 多 Agent 委派与跨端协同规范(multi-agent-orchestrator)

> 权威来源:遵守 [`~/.gemini/config/plugins/antigravity-core-rules/rules/AGENTS.md`](../../rules/AGENTS.md) 边界与 [`BACKGROUND-RESOURCES.md`](../../rules/BACKGROUND-RESOURCES.md) 后台资源管理纪律。

## 1. 核心目标:保护主会话上下文与注意力

主 Agent 的上下文窗口是最宝贵的推理资源。以下场景应优先委派给 Subagent(默认优先使用 3.8f / `model: flash`)或外部协同 Agent(MCP),避免主上下文被海量中间日志、长篇搜索结果或重复校验输出污染:

1. **通用只读验证、日志筛查与哈希对账**(跑检查脚本、核对备份 SHA-256、排查长日志)→ 默认委派给全局 3.8f 专员 [`flash-verifier`](../../agents/flash-verifier.md)(若当前工作区 `.agents/agents/` 下定义了项目级只读验证专员,也可按需委派)。
2. **广度代码/文档检索**(跨多个目录搜寻调用链、查找历史实现、盘点多文件结构)→ 委派给内置只读 `research` subagent(可指定 `Model: "flash"`)。
3. **无污染隔离实验**(尝试高风险重构或对比不同实现方案,不希望弄脏当前工作树)→ 使用 `Workspace: "share"` 或 `"branch"` 启动 `self` subagent。
4. **跨客户端外部 Agent 遥控(MCP)**:
   - **遥控无头 CLI Agent(如 `dsh-bridge` / `agy-agent-bridge` / `dsh-crew`)**:需复用当前工作区工具链、让无头 Agent 跑长文本/批处理/脚本验证或无 UI 后台任务时使用。
   - **遥控桌面端 GUI Agent(如 `tianshu`)**:需将独立功能模块交给外部桌面 Agent 开发并执行 Git 基线客观验收 + 自动返修闭环时使用。

---

## 2. 内部 Subagent 选型与模型分级策略

| 子代理类型 | 推荐 `Model` | 推荐 `Workspace` | 适用场景与权限边界 |
| :--- | :--- | :--- | :--- |
| **`flash-verifier`**(全局) | 内置设为 `flash` (3.8f) | `inherit` | **所有项目通用**:跑只读校验脚本、核对备份/产物 SHA-256、筛查长日志与定位行号。纯只读,只回结论与 `文件:行号`。 |
| **项目级验证专员**(`.agents/agents/*.md`) | 内置设为 `flash` (3.8f) | `inherit` | 特定工程专用:运行工作区专项检查脚本、校验备份哈希。 |
| **`research`**(内置) | `flash` / `inherit` | `inherit` | 广度代码探索、多文件搜索与阅读。运行在只读沙箱中,无写入权限,安全零副作用。 |
| **自定义只读专员** (`define_subagent`) | `flash` / `flash_lite` | `inherit` | 需要反复执行的专项检查(如批量格式合规检查、分片对账)。定义时设 `EnableWriteTools: false`。 |
| **`self`(并行施工/实验)** | `inherit` | `share` 或 `branch` | 独立子模块开发或隔离验证。`share` 共享底层仓库(类 git worktree),避免全量复制开销且互不干扰。 |

> **纪律**:
> - 日常高频扫描、只读验证和检索脏活优先走 `flash`(3.8f)子代理(如 `flash-verifier`);需要主模型同等级深度推理或代码施工的子任务用 `Model: "inherit"`。
> - **4c / 4a 配额与档位分流**:当主会话运行在 `Gemini 4 Carbon` 时,仅将跨子系统架构重构、深层根因排查、安全审计与形式化/多步验证留在 4c(`High` / `Medium`);常规单模块施工、高频问答或 Pro 订阅环境优先使用 `Gemini 4 Argon`(`Medium` / `Low`),避免在轻量任务上烧穿 5 小时与周配额。
> - **对外交付与前端 UI 密度协同**:若使用 `Gemini 4 Carbon` 产出客户文档或前端界面,Word 文档在转出终版 `.docx` 前默认串联 [`humanizer-zh`](../docx-delivery/skills/docx-delivery/SKILL.md)(或交由 `Gemini 4 Argon` 终审润色);UI 开发严格限制容器嵌套深度(≤3 层)与首屏信息密度(细则见 [`IMPLEMENTATION.md`](../../rules/IMPLEMENTATION.md))。

### 2.1 原生 `/swarm`(或 `/teamwork`)并行编排与对抗性验收纪律

当在 Antigravity 中启用 `/swarm`(桌面端斜杠菜单亦显示为 `/teamwork`)驱动多代理并行协作时,除遵守 §3 通信纪律外,必须额外执行以下四条边界控制:

1. **角色分层(架构/审计与施工解耦)**:
   - 优先由 `Gemini 4 Carbon` 承担顶层架构拆解、跨代理任务协调与终态对抗性验收(Adversarial Verifier,核查边界条件、回归风险与安全漏洞);
   - 具体子模块的并发编码、单测补全与只读扫描下放给并行子代理(`Gemini 4 Argon` 或 `Gemini 3.8 Flash`)。
2. **互斥写入作用域与隔离工作树批量豁免(Disjoint Write Scopes)**:
   - 并行启动多个带写权限的施工代理时,派单提示词中**必须显式声明各自允许修改的目录或文件白名单**,严禁两个并行代理同时修改同一文件或共享全局配置;
   - 优先配合 `Workspace: "share"` 或 `"branch"` 隔离 Git worktree:根据全局规则 §1 豁免条款,运行在 `branch` / `share` 隔离工作树内且尚未合入主分支的 Worker,允许在授权白名单内直接执行多文件批量修改(≥5 个文件),无需逐次停下等待用户确认,统一留在 Verifier 终审与合入主分支前由用户一次性拍板。
3. **并发度与本机资源硬上限(防 CPU/内存打满)**:
   - **活跃代理分档上限**(代理数量只在本节规定;本机重型子进程上限见 [`BACKGROUND-RESOURCES.md`](../../rules/BACKGROUND-RESOURCES.md)):
     - 带写权限或构建任务的 `share`/`branch` 施工 Worker:同刻不超过 **2–3 个**;
     - 只读调研、代码审查、截图评审等不写文件、不拉起重型子进程的代理:不占施工名额,同刻不超过 **6 个**;
     - 用户在当前任务中明确授权“放开并发 / 不计配额”时,解除代理数量上限,但重型子进程上限与互斥写入作用域照常执行。
   - **重型编译/渲染子进程硬上限(全局 ≤2,同目录/独占锁 = 1)**:严禁多个并行 Worker 各自同时拉起全量编译、打包、渲染或大并发测试子进程(如 `tsc`、`vite build`、`webpack`、`cargo`、`gradle`、全量 `pytest`/`vitest`、Electron / Headless 浏览器实例、asar 打包)。Worker 阶段仅限单文件语法/局部单测自检,全量构建与端到端测试统一收归 Coordinator 或单一 Verifier 在合入阶段串行执行(见 [`BACKGROUND-RESOURCES.md`](../../rules/BACKGROUND-RESOURCES.md))。
   - **思考可见性静默豁免**:并行 Worker 与 `flash-verifier` 适用 [`THINKING-VISIBILITY.md`](../../global/THINKING-VISIBILITY.md) 豁免,免除逐次工具调用前的前置播报以降低高单价输出开销与看板噪音。
4. **诚实阻塞透传**:
   - 若并行子代理遇到证据缺失或前置依赖冲突,必须原样回传 `BLOCKED` 与具体缺失项清单,禁止子代理自行猜测补齐接口契约。

---

## 3. 内部 Subagent 委派契约与通信纪律(Prompt & Reactive Wakeup)

1. **指令清晰(Prompt 契约)**:
   - 调用 `invoke_subagent` 时,必须明确告知子代理:
     - **具体目标与范围**(查哪些目录/脚本,不查哪些);
     - **只读或写入边界**(严禁触碰的红线文件);
     - **返回格式要求**(例如:“只返回结论、`文件:行号` 及不超过 40 行的证据摘要”)。
2. **禁止轮询(Reactive Wakeup)**:
   - 启动 Subagent 后,系统会在其完成或发消息时自动唤醒主会话;**严禁在主会话写循环、sleep 或反复轮询状态**。
3. **复用已有 Subagent**:
   - 同一子任务的后续追问或补充验证,使用 `send_message` 发送给已有 `conversationId`,不要重复启动新实例。
4. **生命周期收尾**:
   - 若子代理卡死或任务已取消,使用 `manage_subagents`(`Action: "kill"`)精准终止本任务自建的 `conversationId`。

---

## 4. 跨客户端外部 Agent 协同(可选 MCP 桥)

当任务需要跨客户端调度本机外部无头 CLI Agent 或桌面 GUI Agent 时,可通过 `call_mcp_tool` 调用已注册的 MCP Server:

| 类别 | 可选方案 | 核心工具 | 验证状态与适用场景 |
| :--- | :--- | :--- | :--- |
| **本仓库内置 DSH 轻量桥** | [`mcp/dsh-bridge`](../../mcp/dsh-bridge/)(注册名 `dsh-bridge`) | `dsh_status` / `dsh_sessions` / `dsh_ask` / `dsh_forget` | **真机跑通 6/6**(含续聊复用 session)。零依赖单文件,绑定 `dsh --profile headless`,默认 `read-only` 权限。 |
| **本仓库内置通用 CLI 桥** | [`mcp/agent-bridge`](../../mcp/agent-bridge/)(注册名 `agy-agent-bridge`) | `agent_status` / `agent_sessions` / `agent_ask` / `agent_forget` | 假后端 **35/35** 协议断言,**未接真实后端**(`NOT_PROVEN`)。后端由 `BRIDGE_CMD` 指定,子进程环境变量白名单隔离。 |
| **社区成熟异步多 Worker 桥** | [`ZSeven-W/dsh-crew`](https://github.com/ZSeven-W/dsh-crew)(MIT,注册名 `dsh-crew`) | 异步 spawn、worker 状态轮询、cwd 咨询锁、多模态 | 第三方开源项目(需独立安装 `node src/install/cli.mjs agy`)。 |
| **社区桌面 GUI Agent 验收桥** | [`lanlan0811/tianshu-mcp`](https://github.com/lanlan0811/tianshu-mcp)(Apache-2.0,注册名 `tianshu`) | `query_info` / `run_task` / `wait_task` / `query_task` / `manage_task` / `verify_task` | 第三方开源项目(Electron CDP 驱动外部 GUI Agent + Git 基线客观验收闭环)。 |

### 4.1 无头 CLI 桥(`dsh-bridge` / `agy-agent-bridge`)操作纪律
1. **最小权限原则**:`dsh-bridge` 默认权限已设为 `"read-only"`;仅在用户明确授权修改工作区文件时显式传 `permission: "workspace-write"`;跨目录授权施工才传 `"danger-full-access"`,且 `approval_policy` 默认保持 `"never"`。
2. **会话标签卫生**:按任务语义命名 `session` 标签(以便多轮续聊同一上下文);一次性探针或临时任务结束后,主动调用 `forget(session)` 清理映射。
3. **遵守目标工程红线**:派给外部 Agent 的任务必须遵守当前工作区根目录的 `AGENTS.md`(严禁裸改生产红线配置、严禁触碰用户代理与网络配置)。

### 4.2 桌面 GUI 桥(如 `tianshu`)操作纪律
1. **标准闭环流程**:
   - 先调 `query_info(type="profiles")` 确认目标 Agent 状态为 `[PASS] 可用`;
   - 调 `run_task` 异步派单;
   - 紧接调 `wait_task(taskId)` 阻塞等待到达停点(终态或 `needs_user`),终态后调 `query_info(type="report", taskId)` 读取客观验收报告。
2. **严禁强杀用户 GUI 窗口**:若返回 `needsUserKind: "close_existing_instance"`(检测到未开启 CDP 端口的既有客户端窗口),如实请用户保存并关闭旧窗口后再调 `manage_task(action="continue")`,绝不自行 `taskkill` 用户打开的客户端。

Wersje

W bazie nie ma innych skilli o nazwie multi-agent-orchestrator.

Migawka bazy z 13.11.2026 · wersja paczki da4186e37cc2 (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

  • 100oma-orchestrator
    Uruchamia równolegle podagentów CLI, koordynuje ich przez MCP Memory i monitoruje postęp w zautomatyzowanych, wieloagentowych przepływach pracy.
  • 100fgui-agent-bridge
    Pomaga tworzyć interfejsy FairyGUI z komponentów i obsługiwać most agenta FGUI przez MCP lub CLI.
  • 90agent-tools-dsh
    Szuka zewnętrznego API, serwera MCP lub agenta do zadania, porównuje je pod kątem stanu i jakości oraz sprawdza bezpieczeństwo MCP.
  • 100dsh-agent-create
    Zamienia pomysł na agenta w działający projekt Python: dobiera wzorzec i framework, tworzy szkielet, pisze instrukcje i narzędzia, a potem testy.
  • 95dsh-mcp-manager
    Zarządza serwerami MCP w działającym DSH przez API wtyczki: dodaje, włącza, sprawdza stan, łączy ponownie i przenosi konfigurację.
  • 90multi-agent-orchestration
    Koordynuje wielu wyspecjalizowanych agentów w złożonych zadaniach rozproszonych: orkiestrator, subagenci, przekazania, swarm, nadzorca i topologia agentów.

Uwagi i zgłoszenia

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