智能体编排器

agent-orchestrator

分类通用

作者Agentic Awesome Skills 社区

许可MIT

评分4.40/5

使用2.8K

Agent Orchestrator (代理编排器)

概述

编排生态系统中所有代理的元技能（Meta-skill）。支持技能自动扫描、能力匹配、多技能工作流协调及注册表管理。

何时使用此技能

当你需要该领域的专业协助时

何时不要使用此技能

任务与代理编排无关时

更简单、更具体的工具可以处理该请求时

用户需要通用协助而不需要领域专业知识时

工作原理

该元技能作为整个技能生态系统的核心决策和协调层。它通过自动扫描识别相关代理，并针对复杂任务编排多个技能。

原则：零手动干预

始终在处理任何请求前进行扫描

只要在任何子文件夹中创建 SKILL.md，新技能将被自动检测并包含

已删除的技能将从注册表中自动剔除

注册新技能无需任何手动命令

---

强制工作流（所有请求）

在处理任何用户请求之前，请执行以下步骤。脚本自动使用相对路径 —— 在任何目录下均可运行。

步骤 1：自动发现（扫描）

bash

python agent-orchestrator/scripts/scan_registry.py

通过 MD5 哈希缓存实现极速运行（<100ms），仅重新处理已更改的文件。返回包含所有发现技能摘要的 JSON。

步骤 2：技能匹配

bash

python agent-orchestrator/scripts/match_skills.py "<用户请求>"

返回按相关性排序的技能 JSON。结果解读如下：

| 结果 | 操作 |
|:-------------------|:--------------------------------------------------------|
| matched: 0 | 无相关技能。在不使用技能的情况下正常运行。 |
| matched: 1 | 发现一个相关技能。加载其 SKILL.md 并执行。 |
| matched: 2+ | 发现多个相关技能。执行步骤 3（编排）。 |

步骤 3：编排（如果 Matched >= 2）

bash

python agent-orchestrator/scripts/orchestrate.py --skills skill1,skill2 --query "<请求>"

返回执行计划，包含模式、步骤顺序以及技能之间的数据流。

快速步骤（快捷方式）

对于简单查询，步骤 1+2 可以顺序组合：

bash

python agent-orchestrator/scripts/scan_registry.py && python agent-orchestrator/scripts/match_skills.py "<请求>"

---

技能注册表 (Skill Registry)

注册表位于：

code

agent-orchestrator/data/registry.json

搜索位置

扫描器在以下位置查找 SKILL.md：
1. .claude/skills/*/（在 Claude Code 中注册的技能）
2. */（顶层独立技能）
3. */*\（子文件夹中的技能，深度最高 3 层）

技能元数据

注册表中的每项包含：

| 字段 | 描述 |
|:---------------|:---------------------------------------------------|
| name | 技能名称 |
| 字段 | 说明 |
| :--- | :--- |
| skill | 技能名称 (来自 frontmatter YAML) |
| description | 完整描述 (包含触发词) |
| location | 目录的绝对路径 |
| skill_md | SKILL.md 的绝对路径 |
| registered | 是否在 .claude/skills/ 中 (true/false) |
| capabilities | 能力标签 (自动提取 + 显式定义) |
| triggers | 从描述中提取的激活关键词 |
| language | 主要语言 (python/nodejs/bash/none) |
| status | active / incomplete / missing |

注册表命令

bash

## 快速扫描 (使用 Hash 缓存)
python agent-orchestrator/scripts/scan_registry.py
详细状态表
python agent-orchestrator/scripts/scan_registry.py --status
全量重新扫描 (忽略缓存)
python agent-orchestrator/scripts/scan_registry.py --force

---

匹配算法

对于每个请求，匹配器使用以下标准为技能评分：

| 标准 | 分数 | 示例 |
| :--- | :--- | :--- |
| 查询中包含技能名称 | +15 | "use web-scraper" -> web-scraper |
| 精确匹配触发关键词 | +10 | "scrape" -> web-scraper |
| 能力类别匹配 | +5 | data-extraction -> web-scraper |
| 词汇重叠 | +1 | 查询词出现在描述中 |
| 项目加成 | +20 | 技能被分配给当前活动项目 |

最低阈值：5 分。低于此分数的技能将被忽略。

项目匹配

bash

python agent-orchestrator/scripts/match_skills.py --project meu-projeto "在此输入查询"

分配给该项目的技能将自动获得 +20 的加成。

---

编排模式

当多个技能相关时，编排器会对模式进行分类：

1. 顺序流水线 (Sequential Pipeline)

技能形成链条，前一个技能的输出作为下一个技能的输入。

适用场景： “生产者”技能（如 data-extraction, government-data）与“消费者”技能（如 messaging, social-media）混合使用。

示例： web-scraper 采集价格 -> whatsapp-cloud-api 发送警报

code

user_query -> web-scraper -> whatsapp-cloud-api -> result

2. 并行执行 (Parallel Execution)

技能独立处理请求的不同方面。

适用场景： 所有技能角色相同（全部为生产者或全部为消费者）。

示例： instagram 发布帖子 + whatsapp 发送通知（两者接收相同内容）

code

user_query -> [instagram, whatsapp-cloud-api] -> aggregated_result

3. 主 + 辅助 (Primary + Support)

由一个主技能主导，其他技能提供支持数据。

适用场景： 一个技能的分数远高于其他技能 (>= 2倍)。

示例： whatsapp-cloud-api 发送消息 (主) + web-scraper 提供数据 (辅助)

code

user_query -> whatsapp-cloud-api (primary) + web-scraper (support) -> result

详情请参阅 `References/Orchestration-Patterns.Md`

---

项目管理

将技能分配给项目可以提升相关性加成并维持持久上下文。

项目文件

code

agent-orchestrator/data/projects.json

操作

创建项目：
在 projects.json 中添加条目：

json

{
  "name": "项目名称",
  "created_at": "2026-02-25T12:00:00",
  "skills": ["web-scraper", "whatsapp-cloud-api"],
  "description": "项目描述"
}

向项目添加技能： 更新项目的 skills 数组。

从项目移除技能： 从 skills 数组中删除。

查询项目技能： 读取 projects.json 并列出已分配的技能。

---

添加新技能

若要向生态系统添加新技能：

1. 在 skills root: 下的任意位置创建文件夹。
2. 创建一个包含 YAML frontmatter 的 SKILL.md 文件：

yaml

---
name: minha-nova-skill
description: "包含激活关键词的描述..."
---
技能文档

3. 完成！ 自动发现机制将在下次请求时自动检测到。

（可选）若要支持 Claude Code 的原生发现：
4. 将 SKILL.md 复制到 .claude/skills/<名称>/SKILL.md。

显式能力标签（可选）

在 frontmatter 中添加以实现更精准的匹配：

yaml

capabilities: [data-extraction, web-automation]

---

查看所有技能状态

bash

python agent-orchestrator/scripts/scan_registry.py --status

状态解读

| 状态 | 含义 |
|:-----------|:---------------------------------------------------|
| active | SKILL.md 包含 name 和 description |
| incomplete | SKILL.md 存在但缺少 name 或 description |
| missing | 目录存在但没有 SKILL.md |

---

当前生态系统技能

| 技能 | 能力 | 状态 |
|:-------------------|:--------------------------------------|:--------|
| web-scraper | data-extraction, web-automation | active |
| junta-leiloeiros | government-data, data-extraction | active |
| whatsapp-cloud-api | messaging, api-integration | active |
| instagram | social-media, api-integration | partial |

*此表格通过 scan_registry.py --status 自动更新。*

最佳实践

提供关于项目和需求的清晰、具体上下文

在将建议应用于生产代码前进行审核

结合其他互补技能进行全面分析

常见误区

将此技能用于其专业领域之外的任务

在不了解具体上下文的情况下直接应用建议

未提供足够的项目上下文以进行准确分析

局限性

仅在任务明确符合上述范围时使用此技能。

不要将输出视为环境特定验证、测试或专家评审的替代方案。

如果缺少必要的输入、权限、安全边界或成功标准，请停止并请求澄清。

智能体编排器

Agent Orchestrator (代理编排器)

概述

何时使用此技能

何时不要使用此技能

工作原理

原则：零手动干预

强制工作流（所有请求）

步骤 1：自动发现（扫描）

步骤 2：技能匹配

步骤 3：编排（如果 Matched >= 2）

快速步骤（快捷方式）

技能注册表 (Skill Registry)

搜索位置

技能元数据

注册表命令

详细状态表

全量重新扫描 (忽略缓存)

匹配算法

项目匹配

编排模式

1. 顺序流水线 (Sequential Pipeline)

2. 并行执行 (Parallel Execution)

3. 主 + 辅助 (Primary + Support)

详情请参阅 `References/Orchestration-Patterns.Md`

项目管理

项目文件

操作

添加新技能

`技能文档`

显式能力标签（可选）

查看所有技能状态

状态解读

当前生态系统技能

最佳实践

常见误区

相关技能

局限性

扫码进交流群

智能体编排器

Agent Orchestrator (代理编排器)

概述

何时使用此技能

何时不要使用此技能

工作原理

原则：零手动干预

强制工作流（所有请求）

步骤 1：自动发现（扫描）

步骤 2：技能匹配

步骤 3：编排（如果 Matched >= 2）

快速步骤（快捷方式）

技能注册表 (Skill Registry)

搜索位置

技能元数据

注册表命令

详细状态表

全量重新扫描 (忽略缓存)

匹配算法

项目匹配

编排模式

1. 顺序流水线 (Sequential Pipeline)

2. 并行执行 (Parallel Execution)

3. 主 + 辅助 (Primary + Support)

详情请参阅 References/Orchestration-Patterns.Md

项目管理

项目文件

操作

添加新技能

技能文档

显式能力标签（可选）

查看所有技能状态

状态解读

当前生态系统技能

最佳实践

常见误区

相关技能

局限性

扫码进交流群

详情请参阅 `References/Orchestration-Patterns.Md`

`技能文档`