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 替代方案
Forefront
Forefront · 程式設計Forefront 是一個用來打造開源 AI 的網頁平台。你可以用自己的資料微調主流的開源語言模型、評估它們的表現，再透過 API 執行，或匯出後自行架設。想要封閉式平台的便利、卻堅持要自己擁有模型與資料的開發者，就是這裡的目標客群。
Startkit
StartKit.AI · 程式設計Startkit 是一套用來打造 AI SaaS 與 AI 包裝產品的樣板。可以把它想成一個 AI 新創樣板，把枯燥的部分都先接好了：驗證、Stripe 與 Lemon Squeezy 付款、用量限制、交易型電子郵件，以及一套能與 OpenAI、Anthropic、Groq 或 Llama 溝通的 AI API 啟動套件。你複製儲存庫、設定價格，然後專心在產品中使用者真正願意付費的部分。它建構於 React 與 Tailwind 之上的 Next.js，所以大部分的樣板程式碼對你來說並不陌生。
Testim
Tricentis · 程式設計Testim 是專為網頁、行動與 Salesforce 應用程式打造的 AI 測試自動化平台，用來建立並執行端到端測試。它靠機器學習在介面變動時維持測試穩定，團隊因此少花時間修補壞掉的定位器。對於一款今天就能開始使用的自動化測試工具來說，這表現不算差。你透過在瀏覽器錄製動作來建立測試，需要更多控制時再補上 JavaScript。對忙碌的 QA 團隊來說，這是個可靠的選擇。