Ordewell 多代理任務編排工具 – 概覽與核心功能
Ordewell 的作用 — 將單一目標轉化為可編輯的多代理計畫
Ordewell 能將自然語言目標轉換為具備型別的計畫，其中每個任務都指定了執行器 (runner)、模型 (model)、思考強度 (thinking effort) 與模式 (mode)。在消耗任何 token 之前，計畫可以進行編輯，讓開發者能針對每個任務選擇合適的模型、重新連接依賴關係，並在不遺失已完成工作的情況下增加或移除步驟。
- Planner 運作於唯讀的探索範圍內：它可以查詢儲存庫，提出澄清問題，然後在最後一條訊息中發出最終計畫。
- 執行階段會為每個 AI 任務啟動獨立的編碼代理 (coding-agent) 會話，並遵循依賴圖 (dependency graph)，透過執行器輸出中的唯一標記來驗證完成情況。
- 手動任務會以檢查清單項目的形式出現，使用者可以將其標記為已完成。
- Planner 不需要額外的 API key；它可以重複使用您已擁有的 Claude Code、Codex 或 OpenCode 訂閱。
- 內建支援多種執行器，並可透過插件清單 (plugin manifest) 新增額外的執行器。
快速上手 – 安裝與執行終端機介面 (TUI)
npm install -g ordewell
ordewell # 啟動全螢幕 TUI
- 首次啟動時會提示您選擇一個 planner 與一個或多個 runners (例如：Claude Code, Codex, OpenCode)。無需預先提供 API key。
- 相同的流程也適用於
npx ordewell(無需全域安裝) 或 VS Code 擴充功能 (code --install-extension ordewell.ordewell)。 - 對於無頭自動化 (headless automation)，每個斜線指令也是一個子指令；設定
AI_PROVIDER或適當的*_API_KEY環境變數來執行ordewell plan … && ordewell run而無需介面。
核心概念與工作流程
- 目標定義 – 提供自然語言描述，例如：
"Add rate limiting to the public API"。 - Planner 研究 – Planner 以唯讀方式讀取儲存庫，提出澄清問題並收集證據。
- 計畫生成 – 產生一個有序的任務清單，每個任務都標註了 runner、model、effort 與 mode。計畫是一個可以編輯的型別化產物 (artifact)。
- 執行 – 獨立任務會並行執行 (預設最大 3 個並行會話)。每個 AI 任務都在其專屬會話中執行；手動任務則成為檢查清單。
- 判定引擎 (Verdict Engine) – 只有當任務的唯一完成標記出現在執行器的輸出中時，任務才會被標記為 PASS。結束代碼 (exit codes) 會被保留作為診斷證據；任務可以手動標記為 complete 或 not done。
三種使用者介面，一個核心引擎
| Interface | 主要使用案例 |
|---|---|
| VS Code 擴充功能 | 整合的串流時間軸、即時研究步驟與可展開的任務卡片。允許在原位重新指定 runners 與 models。 |
| Terminal UI (TUI) | 透過 SSH 進行全螢幕、鍵盤驅動的工作流程；tab 切換聊天與計畫面板，單鍵快捷鍵驅動計畫 (例如：f 開始, E 執行全部)。 |
| CLI | 可腳本化、無頭自動化；每個 UI 行動也是一個子指令 (ordewell plan, ordewell run, ordewell task-runner)。 |
所有介面都共享相同的核心套件 (core/, cli/, vscode/, web/) 並透過本地守護程序 (daemon) (ordewell web --daemon) 通訊，該程序會暴露一個 JSON-over-WebSocket API。
設定檔要點
| Setting | Default | Effect |
|---|---|---|
Provider key (OPENROUTER_API_KEY, ANTHROPIC_API_KEY, …) |
— | 所選 AI provider 的必要條件；Ordewell 會從設定的 key 進行自動偵測。 |
ORCHESTRATOR_MODEL |
deepseek/deepseek-v4-flash |
用於研究與計畫生成之 Planner 模型。 |
ORDEWELL_PLANNER_EFFORT |
— | 編碼代理 Planner 的思考強度等級 (例如：high, low)。 |
ORDEWELL_MAX_PARALLEL |
3 |
最大並行 AI 任務會話數 (1–5)。 |
環境變數可以透過 ordewell key set …, ordewell model set …, 或 VS Code 設定面板進行設定。變更會立即生效，無需重新啟動 daemon。
可擴展性 – 自定義 Runner 與插件
- 內建執行器包括 Claude Code, Codex, 與 OpenCode。
- 可透過建立插件清單 (
ordewell plugins create my-runner) 並從 Git URL 安裝 (ordewell plugins install github:user/repo) 來新增額外的執行器。 - 插件可以託管在 GitHub, GitLab, Bitbucket, 或 Codeberg；其他來源需要透過本地複製 (clone) 進行。
Hacker News 社群回饋
@ramon156: “I would love a deterministic program that can confidently make plans for lower-cost models like DeepSeek. The LLM part won’t be deterministic, but it’s easier to measure quality this way.” – 強調了對使用預算型模型進行可重複計畫的需求。
@Lalabadie: “I opened the page looking for a differentiator, but everything about the project is AI-written (including author replies).” – 指出對於專案屬性為 AI 生成內容的觀感，這可能會影響信任度。
@sharathr: “Have you tried https://github.com/highflame-ai/codeoid” – 建議使用替代的程式碼生成工具進行比較。
@ac-ciano: “[dead]” – 表示原作者的評論已被移除，無法提供額外資訊。
平台支援與 Windows 注意事項
| Surface | Linux | macOS | Windows |
|---|---|---|---|
| VS Code 擴充功能 | ✅ | ✅ | ✅ |
| API server | ✅ | ✅ | ✅ |
| CLI | ✅ | ✅ | ✅ |
| TUI (requires tmux) | ✅ | ✅ | Needs WSL |
- TUI 依賴 tmux 來處理每個任務的終端機；請透過您的套件管理器安裝它 (
apt install tmux,brew install tmux)。 - 在 Windows 上，請使用執行代理 CLI 的原生安裝程式，以避免大型系統提示詞 (system prompts) 在
.cmdshim 上的限制。 - 確保已安裝 Git for Windows，以便 Planner 的唯讀 shell 指令 (
ls,grep, 等) 能保持一致的行為。
架構快照
packages/
├─ core/ # Pure TypeScript: Session, PlanStore, Planner, Orchestrator, Orchestrator, VerdictEngine
├─ cli/ # TUI, plan/run/status commands, thin terminal driver
├─ cli/ # TUI, plan/run/run/status commands, thin terminal driver
├─ vscode/ # Extension UI, streaming planner timeline, task cards
└─ web/ # Hono HTTP + WebSocket daemon (127.0.0.1:3742)
TUI 核心是一個純粹的 reducer，它會回傳 {state, effects}，並搭配一個渲染器 (renderer) 來發出每一行終端機內容，確保 UI 邏輯是可測試且與 UI 無關的。
授權條款
Ordewell 是根據 Apache License 2.0 發佈的。根據 NOTICE 檔案，名稱與標誌 (logos) 不包含在授權條款內。
Sources
相關
- 專案
- 專案
- 專案
- 專案
- 專案