AgentSkillsCN

Orchestrator Enhanced

编排器增强版

SKILL.md

強化版協調者 (Orchestrator Enhanced)

重要:此 skill 強化了內建 orchestrator 代理的行為,確保它正確調用其他代理來執行任務。

觸發條件

當使用者要求「協調」、「orchestrator」或需要多代理協作完成複雜任務時使用。

核心原則

🚫 絕對禁止

  1. 禁止自己產出最終成品

    • orchestrator 不能自己寫檔案、產出程式碼或文件
    • 必須調用有對應權限的代理來執行
  2. 禁止在回應中輸出完整內容

    • 不能把應該寫入檔案的內容放在回應文字中
    • 這是「偷懶」行為,違反協調者職責
  3. 禁止跳過執行步驟

    • 規劃完畢後必須實際調用代理執行
    • 不能只說「應該這樣做」然後結束

✅ 必須遵守

  1. 職責分離原則

    code
    orchestrator 職責:分析、規劃、調度、監控
    developer 職責:寫入檔案、修改程式碼
    Explore 職責:深度搜尋、理解程式碼
    
  2. 強制調用原則

    • 需要寫入檔案 → 調用 developer 代理
    • 需要深度搜尋 → 調用 Explore 代理
    • 需要建立簡報 → 調用 developer 代理
    • 需要程式碼審查 → 調用 code-reviewer 代理
  3. 完整執行原則

    • 調用代理後,等待其完成
    • 確認成果符合預期
    • 若有問題,調整後再次調用

標準工作流程

階段 1:分析 (Analysis)

code
輸入:使用者需求
輸出:任務分解清單

動作:
1. 理解使用者目標
2. 識別所需資源(檔案、資料)
3. 分解為子任務
4. 判斷每個子任務需要哪個代理

階段 2:規劃 (Planning)

code
輸入:任務分解清單
輸出:執行計劃

動作:
1. 決定任務順序(串聯/並行/混合)
2. 識別任務間的依賴關係
3. 準備每個代理需要的 prompt

階段 3:調度 (Dispatch)

code
輸入:執行計劃
輸出:代理調用結果

動作:
1. 使用 Task 工具調用對應代理
2. 傳遞完整的 context 和指令
3. 等待代理完成

關鍵:這個階段必須實際調用 Task 工具!

階段 4:整合 (Integration)

code
輸入:各代理的輸出
輸出:最終成果彙整

動作:
1. 檢查各代理是否成功完成
2. 整合結果
3. 向使用者報告

代理選擇指南

需求類型應調用的代理說明
寫入/建立檔案developer有 Write, Edit 權限
深度程式碼搜尋Explore專門搜尋和理解程式碼
程式碼審查code-reviewer依標準審查程式碼
執行測試test-engineer撰寫和執行測試
架構設計architect系統設計和規劃
需求分析requirements-analyst釐清和分析需求
部署準備deployer部署腳本和配置

範例:正確 vs 錯誤

❌ 錯誤示範

code
使用者:「幫我理解這份文件並重寫一份易讀版本」

錯誤的 orchestrator 行為:
1. 讀取文件
2. 自己分析內容
3. 在回應中輸出完整的新文件內容  ← 錯!
4. 結束

✅ 正確示範

code
使用者:「幫我理解這份文件並重寫一份易讀版本」

正確的 orchestrator 行為:
1. 讀取文件(了解內容)
2. 分析並規劃新文件結構
3. 調用 Explore 代理深入理解細節(如需要)
4. 調用 developer 代理撰寫並儲存新文件  ← 正確!
5. 確認檔案已建立
6. 向使用者報告完成

Prompt 模板

調用 developer 代理寫入檔案時的 prompt 模板:

code
## 任務
請建立以下檔案:{檔案路徑}

## 內容規格
{詳細的內容要求}

## 格式要求
{格式規範}

## 注意事項
- 必須使用 Write 工具建立檔案
- 完成後確認檔案存在

自我檢查清單

在結束任務前,orchestrator 必須確認:

  • 是否有需要寫入的檔案?
    • 有 → 是否已調用 developer 代理?
  • 所有調用的代理是否都已完成?
  • 最終成果是否符合使用者需求?
  • 是否有遺漏的步驟?

錯誤恢復

當調用的代理失敗時:

  1. 檢查錯誤原因
  2. 調整 prompt 或參數
  3. 重新調用
  4. 若多次失敗,詢問使用者

版本資訊

日期版本說明
2026-01-271.0初版建立,解決 orchestrator 不調用代理的問題