jnMetaCode/agency-orchestrator

Agency Orchestrator – 是什麼

Agency Orchestrator (AO) 是一個基於 Node.js 的工具，可讓您同時運行多個 AI「專家」來解決任務。您可撰寫極簡的 YAML 工作流程，描述哪些角色應參與、做什麼，以及步驟之間的依賴關係，或讓 AO 從單一自然語言提示中自動產生工作流程。引擎隨後呼叫選定的大語言模型（LLM）提供方，盡可能並行執行步驟，並將輸出整合為最終交付成果。

核心理念

概念	AO 如何實現
多代理協作	AO 內建了 267 個中文角色（以及可選的多語言套件）。每個角色僅是一個系統提示，告訴 LLM 以特定專家身份行動（例如「產品經理」、「財務規劃師」）。
零程式編排	您可執行 ao compose "<任務描述>" --run，AO 會自動選擇合適的專家，設計 DAG（有向無環圖）步驟，並執行。無需 YAML，無需程式碼。
YAML 工作流程檔案	對於可重複的流程，您撰寫一個簡短的 YAML 檔案，列出 steps、每個步驟的 role、task 提示、可選的 acceptance 準則，以及 depends_on 依賴關係。AO 解析檔案，建構 DAG 並執行。
圖形化 Studio	本地 Web UI（ao web）允許您拖曳節點、選擇角色、編輯提示，並即時查看進度。UI 與 CLI 共用相同的角色庫和工作流程檔案。
提供方彈性	AO 可使用 11 個 LLM 提供方（Claude、DeepSeek、OpenAI、Gemini 等）。其中 7 個可透過本地安裝的 CLI（Claude-code、Copilot-cli 等）在無需 API 金鑰的情況下運作。
安全優先的服務切換	AO 可將底層 Claude 服務替換為自訂端點，並自動備份原始設定，若發生問題可一鍵還原。
結果分享	執行完畢後，可產生自包含的 HTML 報告（ao report），或透過 Webhook 將輸出推送到 DingTalk、Feishu 或 WeChat 群組（--notify）。

誰會用它？

• 個人創業者：希望擁有「AI 驅動的團隊」來起草商業計畫、市場分析、內容日曆等。
• 產品經理：需要快速可行性研究、PRD 審查或跨領域設計審查。
• 開發者：希望獲得 AI 生成的程式碼審查、架構評估或可交付給編碼代理的骨架程式碼。
• 內容創作者：尋找 AI 驅動的腦力激盪、腳本撰寫和影片生成流程。
• 團隊：希望擁有可重複、可審計的工作流程（接受標準、版本化輸出、可恢復執行）。

快速上手（3 步啟動）

1. 安裝 – npm install -g agency-orchestrator（或下載 Electron 桌面客戶端以實現零安裝體驗）。
2. 執行一行命令 – ao compose "幫我分析做一個AI記帳工具的可行性" --run。AO 會自動選擇合適專家，建構 DAG，並輸出簡潔摘要。
3. 探索範本 – ao run workflows/一人公司全员大会.yaml -i idea="..." 執行預建構的「一人公司」工作流程，包含計畫、行銷、財務等模組。

關鍵指令（CLI 快捷表）

指令	作用
ao demo	快速示範多代理協作。
ao compose "<句子>"	從自然語言生成工作流程。
ao compose "..." --run	生成並立即執行。
ao run <workflow.yaml>	執行已儲存的 YAML 工作流程。
ao team save <workflow.yaml> --name <team>	將角色陣容儲存為可重用的「團隊」。
ao run --team <team> "<新任務>"	在新提示上重用已儲存的團隊。
ao prompt optimize "<提示>" --save <name>	讓 AO 優化提示並儲存。
ao report	產生上次執行的可共享 HTML 報告。
ao serve	啟動 MCP 伺服器，使 Claude Code 或 Cursor 等工具可程式化呼叫 AO。

架構亮點

• 角色庫 位於 ~/.ao/roles（或自訂 AO_AGENTS_DIR）。每個角色是一個包含系統提示的 Markdown 檔案。
• 工作流程引擎 讀取 YAML，建構 DAG，解析步驟間的 {{variables}}，並透過選定的 LLM 提供方執行每個步驟。
• 並行性 – AO 自動偵測獨立分支並並行執行（可透過 concurrency 設定）。
• 接受標準與斷言 – 步驟可宣告 acceptance 標準或 assert 规則（檔案數量、令牌大小、正規表示式匹配）。失敗的斷言會觸發重試或定向重做。
• 可恢復性 – --resume 和 --from 允許您使用先前儲存的輸出從特定步驟重新啟動，實現低成本迭代。
• 可擴充的「技能」 – 小型可重用方法論（如測試驅動開發、結構化程式碼審查）可透過 skill 欄位附加到步驟。

生態與擴充

• 多語言角色套件（agency-agents-ko、pt-br、ar 等）可透過 npm 安裝，並在 Studio 中選擇。
• 創意資產 – AO 內建 1500+ 圖像提示和 76 個影片範本，可直接從 UI 使用。
• Docker / NAS 部署 – 官方鏡像 ghcr.io/jnmetacode/agency-orchestrator，使用簡單 docker run 命令；掛載 ao-data 卷以持久化金鑰和輸出。
• 整合 – 內建 14 個 AI 編碼助手（Claude Code、Cursor、Copilot 等）的 MCP 介面，使這些工具可無需撰寫膠水程式碼直接呼叫 AO 工作流程。

何時使用 AO 優於簡單替代方案

情況	使用 AO	使用單對話 LLM
需要 多個 專家觀點（產品、技術、財務、行銷）	✅ AO 建構團隊並合併結果	❌ 需反覆提問並手動拼接
希望擁有可重複、可審計的流程（含接受檢查）	✅ YAML + assert/acceptance	❌ 無內建驗證
偏好圖形化拖曳視圖	✅ Studio UI	❌ 無 GUI
希望本地執行且無需支付 API 呼叫費用	✅ 使用 CLI（Claude-code、Copilot-cli、Ollama）或免費無密鑰提供方	❌ 多數單對話服務需密鑰

---

總結：Agency Orchestrator 是一個真正的、生產就緒的框架，用於協調多個 AI 代理解決複雜、跨領域的任務，同時提供低程式碼 CLI 和功能完整的 Web Studio。它明確定位於 AI 代理 / 多 LLM 編排領域。