Agent Orchestrator
概述
元技能（Meta-skill），用於協調生態系統中所有代理。自動掃描技能、根據能力進行匹配、協調多技能工作流程以及註冊表管理。
何時使用此技能
- 當你需要此領域的專業協助時
不應使用此技能的情況
- 任務與 agent orchestrator 無關
- 有更簡單、更特定的工具可以處理該請求
- 使用者需要無需領域專業知識的一般性協助
運作方式
此元技能作為整個技能生態系統的中央決策與協調層。它會自動掃描、識別相關代理，並為複雜任務協調多個技能。
原則：零人工干預
- 務必先掃描，然後再處理任何請求
- 在任何子資料夾中建立
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：協調（如果 Matched >= 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 中註冊的技能）*/（頂層的獨立技能）*/*\（子資料夾中的技能，最深三層）
每項技能的中繼資料
註冊表中的每個條目包含：
| 欄位 | 描述 |
|---|---|
| name | 技能名稱（來自 frontmatter 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 | 查詢中的文字出現在描述中 |
| 專案加成 | +20 | 技能指派給當前活躍專案 |
最低門檻：5 分。低於此分數的技能將被忽略。
搭配專案進行匹配
python agent-orchestrator/scripts/match_skills.py --project 我的專案 "這裡放查詢"
指派給該專案的技能會自動獲得 +20 的加成。
協調模式
當多個技能相關時，協調器會分類模式：
1. 順序管線
技能形成一個鏈，其中一個的輸出提供給下一個。
適用時機： 混合使用「生產者」技能（data-extraction, government-data）和「消費者」技能（messaging, social-media）。
範例： web-scraper 收集價格 -> whatsapp-cloud-api 發送警報
user_query -> web-scraper -> whatsapp-cloud-api -> result
2. 並行執行
技能獨立處理請求的不同方面。
適用時機： 所有技能角色相同（全部是生產者或全部是消費者）。
範例： instagram 發布貼文 + whatsapp 發送通知（兩者接收相同內容）
user_query -> [instagram, whatsapp-cloud-api] -> aggregated_result
3. 主要 + 輔助
一個主要技能主導；其他技能提供輔助資料。
適用時機： 一個技能的分數遠高於其他技能（>= 2 倍）。
範例： whatsapp-cloud-api 發送訊息（主要）+ web-scraper 提供資料（輔助）
user_query -> whatsapp-cloud-api (primary) + web-scraper (support) -> result
詳細資訊請參閱 References/Orchestration-Patterns.Md
專案管理
將技能指派給專案可獲得相關性加成和持續的上下文。
專案檔案
agent-orchestrator/data/projects.json
操作
建立專案： 將條目新增至 projects.json：
{
"name": "專案名稱",
"created_at": "2026-02-25T12:00:00",
"skills": ["web-scraper", "whatsapp-cloud-api"],
"description": "專案描述"
}
將技能新增至專案： 更新專案的 skills 陣列。
從專案移除技能： 從 skills 陣列中移除。
查詢專案的技能： 讀取 projects.json 並列出指派的技能。
新增技能
若要將新技能新增至生態系統：
- 在
skills root下的任何位置建立一個資料夾： - 建立一個包含 frontmatter YAML 的
SKILL.md：
---
name: 我的新技能
description: "包含啟用關鍵字的描述..."
---
## 技能文件
- 就緒！ 自動發現功能會在下一次請求時自動偵測到。
或者，為了 Claude Code 的原生發現：
4. 將 SKILL.md 複製到 .claude/skills/<名稱>/SKILL.md
明確的能力標籤（可選）
新增至 frontmatter 以獲得更精確的匹配：
capabilities: [data-extraction, web-automation]
查看所有技能的狀態
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 |
| social-media, api-integration | partial |
此表格會經由 scan_registry.py --status 自動更新。
最佳實務
- 提供清晰、具體的專案背景和需求
- 在將建議套用至正式環境程式碼前，請先審查所有建議
- 與其他互補技能結合以進行全面分析
常見陷阱
- 將此技能用於其領域專業知識之外的任務
- 未理解自身特定背景即套用建議
- 未提供足夠的專案背景以進行準確分析
相關技能
multi-advisor- 用於增強分析的互補技能task-intelligence- 用於增強分析的互補技能
限制
- 僅在任務明確符合上述範圍時使用此技能
- 請勿將輸出視為特定環境驗證、測試或專家審查的替代品
- 如果缺少必要的輸入、權限、安全邊界或成功標準，請停止並請求澄清