agent-harness
ar27111994 · 程式設計 · 生產力
agent-harness 是一款開源 CLI，用來管理驅動 AI 程式開發代理的可重用資源，例如 skills、MCP 伺服器、指令與提示詞套件。如果你曾經想要一個 MCP 伺服器套件管理器，這個工具已經很接近了。它會掃描工作區、挑出符合任務的資源、把它們鏡射到一份固定版本的本地副本，接著串接到你使用的任何宿主，不論是 VS Code、Cursor、Zed、Claude Code、OpenCode、Pi 還是 Codex。對一款給 AI 代理用的 CLI 而言，任務狹窄而明確：決定你的代理能使用什麼。
關於 agent-harness
agent-harness 是什麼
agent-harness 是一款 Node.js 與 TypeScript 的 CLI，負責處理與 AI 程式開發代理共事時枯燥又容易出錯的部分：讓它們的可重用資源保持井然有序。有人把它描述成 AI 代理資源管理器，這說法很貼切。多數開發者現在都得在超過一種編輯器之間，兼顧 skills、MCP 伺服器、指令檔與提示詞套件。每個工具都希望這些資源放在不同位置、用不同格式。agent-harness 把這團混亂變成一條可重複的生命週期。
它不執行代理。它為你原本就在用的宿主準備可檢視的輸入，讓你在任何東西改變之前，先看到什麼東西會進到工作區。核心模型刻意保持樸素：單一指令介面、宿主轉接層、預覽優先的寫入，以及明確的原生安裝步驟。專案採用 MIT 授權，託管在 GitHub 上。
最大的限制在於涵蓋範圍。它管理七種程式開發宿主的資源，並且要求 Node 23 以上，所以如果你的工作流程完全在瀏覽器中、或在不支援清單上的工具裡進行，它就還派不上用場。那麼誰該略過它？任何只碰單一宿主、從不更改設定的人。它也很年輕，這表示真實世界的實戰案例比大型套件管理器來得少。
開始使用
- 安裝 Node.js 23 以上，以及 npm 和 Git，然後執行
npm install -g @ar27111994/agent-harness。 - 在你想要設定的工作區裡，用
agent-harness setup hosts和agent-harness setup doctor --host vscode檢查你的宿主支援什麼（把 vscode 換成你自己的宿主）。 - 一次執行整條流程：
agent-harness workspace opencode --intent general，選擇像是frontend或research這樣符合你專案的意圖。 - 檢視產生的
.agent-harness/資料夾，看看發現了什麼、選了什麼、準備了什麼。 - 需求改變時就重跑同一個指令；若想在檔案變更套用前先看到計畫，就先使用預覽模式。
產品資訊
快速了解 agent-harness 的定價、支援平台與效能。
適合對象
這項工具最適合的使用者、任務與情境。
使用者
- 同時兼顧多個 AI 程式開發宿主的開發者：只要你熟悉終端機，它能在 VS Code、Cursor、Zed、Claude Code、OpenCode、Pi 與 Codex 之間維持同一套一致的資源。
- 想要可重複設定的團隊：固定版本的鏡射與預覽優先的寫入，留下一份可審查的變更紀錄。沒有託管儀表板，所以審查在本機進行。
- 開源貢獻者與愛好者：MIT 授權與轉接器架構讓擴充變得容易，前提是你讀得懂 TypeScript。
任務
- 安裝並串接 MCP 伺服器：它準備一組數量有限的伺服器，並依宿主套用，而不是手動編輯設定檔。
- 管理代理 skills 與指令：資源會自動被探索、排序與啟用，所以你不必在專案之間複製 markdown。
- 稽核代理能存取什麼：每次執行都會在 `.agent-harness/` 下寫出可檢視的 JSON，當你需要追溯某項能力的來源時很有幫助。
- 更新既有設定：同一條生命週期能乾淨地重跑，所以更新資源不代表要從零開始。
情境
- 專案中途換編輯器：同一套資源流程會把你的 skills 與 MCP 伺服器帶到新宿主。
- 帶新同事上手：他執行同樣的工作區指令，就能進到相近的資源環境。
- 把有風險的輸入擋在外面：看起來不安全的候選項目會先進隔離資料夾，而不是直接進入你的工作區。
主要功能
跨宿主的資源生命週期
不論你選哪個宿主，agent-harness 都執行同一條生命週期：探索、推薦、鏡射、準備、啟用，然後串接。這種一致性很重要，因為底層工具什麼都不一致。一個能在 Claude Code 運作的 skill，打包方式跟給 Cursor 用的不一樣，而這個工具把這些差異收攏在單一指令介面之後。一個介面，一條生命週期。
一行指令完成工作區設定
workspace <host> 指令是新使用者的預設路徑。它執行廣泛探索、排序候選項目、準備並啟用選中的資源，最後完成該宿主的串接，全都只靠一行像 agent-harness workspace cursor --intent frontend 的指令。像 devops、design 或 research 這類意圖會把選擇導向你的工作類型，而且可以傳入多個。設定就是一行。這就是它的魅力。
預覽優先的串接
串接宿主不會修改任何東西，除非你主動要求。預設情況下，wire <host> 只會寫出一份可審查的計畫，什麼都不碰。你可以讀取確切的目標路徑與預定的寫入內容，準備好再套用或重設。對任何曾被工具悄悄改寫編輯器設定的人來說，這是一道受歡迎的界線。
固定版本的鏡射與隔離
這個工具不是把資源直接從網路拉進你的工作區，而是把一組數量有限的資源鏡射成可重現的本地成品，並為每一代固定版本。看起來有風險的候選項目會被導入隔離資料夾，而不是被啟用。結果是一套你能檢視、能回溯的設定，而不是一套在你腳下不斷變動的設定。
ARD 發佈者與取用者
agent-harness 實作 Agentic Resource Discovery 1.0 規範，這套標準由 Google、Microsoft、Hugging Face、GitHub 與 NVIDIA 支持。它會發佈 .well-known/ai-catalog.json，讓登錄庫能索引它精選的資源，也能把其他 ARD 登錄庫當成探索來源取用。它的標語總結了這個意圖：隨處探索，到處安裝。
七個宿主轉接器
專案為 VS Code（搭配 Copilot）、OpenCode、Cursor、Zed、Claude Code、Pi 與 OpenAI Codex 註冊轉接器。每個轉接器負責自己宿主的檔案、設定、套用與重設行為，以及安全界線。有些轉接器沿用另一個宿主的套件配置，卻依自己的政策排序，這讓 Cursor 之類的宿主能相容於 Copilot 風格的資源。
感知意圖的推薦
推薦會權衡政策、需求訊號、信任、成本與多樣性，而不只是人氣。官方與已驗證的來源會優先，而當擁有者證據對不上時，第一方來源會被降級。結果就是更少可疑套件進到你的工作區，更多真正符合你正在打造東西的套件。
優缺點
優點
- 用單一指令介面解決七個熱門 AI 程式開發宿主之間的實際問題
- 預覽優先的寫入與固定版本的鏡射，讓變更可檢視、可回溯
- 在 MIT 之下免費且開源，並有乾淨的轉接器架構供擴充
- 隔離處理與重視信任的排序，增添一層供應鏈的謹慎
缺點
- 要求 Node.js 23 以上，所以較舊的環境得先升級
- 不支援瀏覽器或非 CLI 的宿主，這直接排除了某些工作流程
- 仍處於早期、使用者基數小，所以邊緣情況與文件可能落後
- 預期你熟悉終端機，這讓一般使用者難以親近
常見問題
它管理 AI 程式開發代理所依賴的可重用資源，例如 skills、MCP 伺服器、指令與提示詞套件。它探索候選項目、加以排序、鏡射一份固定版本的本地副本，接著把選中的串接到你選的宿主。它本身不執行代理。
相關內容
探索與 agent-harness 相關的工具、技能與文章。
agent-harness 替代方案
Base Code
Base44 (Wix) · 程式設計 · 生產力Base Code 是 Base44 推出的共享雲端開發環境。團隊在對話中描述對既有 GitHub 儲存庫的修改，看著預覽確認結果，再以 Pull Request 交回工程團隊。
Google EmbeddingGemma 2
Google DeepMind · 寫作 · 圖片 · 程式設計Google EmbeddingGemma 2 是 7.4 億參數的開源模型，能把文字、程式碼、圖片、音訊與影片畫面轉成同一個 768 維空間裡的向量，在手機與筆電上就能執行。
GitGlow
GitGlow · 程式設計 · 生產力GitGlow 是桌面版 Git 用戶端，把你自己的程式碼與 AI 代理程式的變更集中在同一份審查裡，讓你在交付前看清楚機器上究竟要送出什麼。