
关于
编排生态系统中所有代理的元技能。自动扫描技能、按能力匹配、协调多技能工作流和注册表管理。
name: agent-orchestrator description: 编排生态系统中所有代理的元技能。自动扫描技能、按能力匹配、协调多技能工作流和注册表管理。 risk: safe source: community date_added: '2026-03-06' author: renat tags:
- orchestration
- multi-agent
- workflow
- automation tools:
- claude-code
- antigravity
- cursor
- gemini-cli
- codex-cli
代理编排器
概述
编排生态系统中所有代理的元技能。自动扫描技能、按能力匹配、协调多技能工作流和注册表管理。
何时使用此技能
- 当你需要此领域的专业帮助时
不适用场景
- 任务与代理编排无关时
- 有更简单、更专业的工具可以处理请求时
- 用户需要通用帮助而非领域专业知识时
工作原理
作为整个技能生态系统的中央决策和协调层的元技能。自动扫描、识别相关代理并为复杂任务编排多个技能。
原则:零手动干预
- 始终执行扫描,在处理任何请求之前
- 新技能在任何子文件夹中创建SKILL.md后自动检测并纳入
- 已删除的技能自动从注册表中排除
- 无需手动命令来注册新技能
强制工作流(每次请求)
在处理任何用户请求之前执行这些步骤。 脚本自动使用相对路径 - 在任何目录下都能工作。
步骤1:自动发现(扫描)
python agent-orchestrator/scripts/scan_registry.py
通过MD5哈希缓存实现超快速(<100ms)。仅重新处理已更改的文件。 返回包含所有已发现技能摘要的JSON。
步骤2:技能匹配
python agent-orchestrator/scripts/match_skills.py "<用户请求>"
返回按相关性排名的技能JSON。解读结果:
| 结果 | 操作 |
|:-----------------------|:--------------------------------------------------------|
| matched: 0 | 无相关技能。正常运行,不使用技能。 |
| matched: 1 | 一个相关技能。加载其SKILL.md并遵循。 |
| matched: 2+ | 多个技能。执行步骤3(编排)。 |
步骤3:编排(当匹配数 >= 2时)
python agent-orchestrator/scripts/orchestrate.py --skills skill1,skill2 --query "<请求>"
返回包含模式、步骤顺序和技能间数据流的执行计划。
快速步骤(快捷方式)
对于简单查询,步骤1+2可以按顺序组合:
python agent-orchestrator/scripts/scan_registry.py && python agent-orchestrator/scripts/match_skills.py "<请求>"
技能注册表
注册表位于:
agent-orchestrator/data/registry.json
搜索位置
扫描器在以下位置查找SKILL.md:
.claude/skills/*/(在Claude Code中注册的技能)*/(顶层的独立技能)*/*/(子文件夹中的技能,深度最多3层)
每个技能的元数据
注册表中每个条目包含:
| 字段 | 描述 | |:---------------|:---------------------------------------------------| | name | 技能名称(来自YAML前置元数据) | | description | 完整描述(包含触发器) | | location | 目录的绝对路径 | | skill_md | SKILL.md的绝对路径 | | registered | 是否在.claude/skills/中(true/false) | | capabilities | 能力标签(自动提取 + 显式声明) | | triggers | 从描述中提取的激活关键词 | | language | 主要语言(python/nodejs/bash/none) | | status | active / incomplete / missing |
注册表命令
## 快速扫描(使用哈希缓存)
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 | 查询中的词出现在描述中 |