工具包 · Harness engineering

Harness engineering,
在視窗裡完成,而不是在設定檔裡

代理能做什麼,取決於它的 harness:人設、工具和記憶。AgentsRoom 把它們變成三個獨立的控制項,你可以按代理、按任務自由組合。

工具包把技能、MCP 伺服器、已儲存的連線和環境變數歸到一個名字下。把它附加到一個代理、單個工單、一個團隊步驟、一個專案或一個客戶資料夾。只需編輯一次,所有使用它的代理都會在下次啟動時獲得改動,Claude Code、Codex 和其他所有代理 CLI 都是如此。

一個代理的 harness
人設程式碼審查員
工具包調研
  • scan-documents
  • summarize
  • notes (MCP)
  • staging-db
專案記憶唯讀
啟動時
  • Claude Code
  • Codex
  • Antigravity
  • Cursor

一個附加到工單的調研工具包:代理在啟動時獲得它的技能、MCP 伺服器和連線,並且唯讀取專案記憶,不會寫入。

Harness engineering(為程式設計代理設計它周圍的執行環境)指的是塑造程式設計代理周邊一切的工作:它讀取哪些指令,能呼叫哪些工具,保留哪些知識。如今這些大多散落在檔案裡。這裡一個 CLAUDE.md,那裡一個 mcp.json,每個 CLI 一個技能資料夾,環境變數寫在 shell 設定檔中,而且不手動複製的話,沒有一樣能帶到下一個代理或下一個任務。

在 AgentsRoom 中,一個代理由三樣分別設定的東西組成。人設決定它是誰。工具包決定它能用什麼:技能、MCP 伺服器、已儲存的 SSH、資料庫和開發命令連線、環境變數。記憶設定決定它是否讀寫共享的專案記憶。改動其中一個,另外兩個保持不變。

工具包以引用方式附加,從不復制。一個由文件掃描技能、摘要技能和筆記應用連線組成的調研工具包,可以同時裝備一個審查代理、單個工單和整個客戶資料夾,對它的任何改進都會傳達到所有這些地方。

三個控制項,而不是一份代理定義

給任務能力而不附帶人設,保留人設而不帶記憶,或者在不同角色下複用同一套工具。

技能、MCP 伺服器和連線裝進一個工具包

從技能庫中挑選技能,選擇已儲存的 SSH、資料庫和開發命令連線,貼上你已經在用的 MCP 伺服器 JSON,再加上環境變數。憑證以 {{secret:NAME}} 引用的形式留在金鑰管理器中,在啟動時於你的電腦上解析。

以引用方式附加

代理、工單和設定儲存的是工具包本身,而不是其內容的副本。只需編輯一次工具包,所有使用它的代理都會在下次啟動時獲得新的技能和伺服器。

覆蓋你已經在用的每個層級

可以把工具包附加到一個代理、一個已儲存的代理、單個待辦工單、代理團隊中的一個步驟、整個專案,或一個客戶資料夾,其子資料夾還可以追加自己的工具包。

為單個任務提供能力

工單可以帶上自己的工具包,而不改變它的代理。這些工具包會疊加在代理自己的工具包之上;當工單的技能模式為「替換」時,則替換掉全部工具包(代理、專案和資料夾)。

記憶與人設分離

按代理把專案記憶設為「關閉」「唯讀」或「讀寫」,還可以只為某個工單單獨覆蓋。「唯讀」讓知識庫保持可用,同時不讓審查代理改寫它。

所有代理 CLI,桌面與手機

技能以文字形式送達每個 CLI,在 Claude Code 和 Antigravity 上還會作為原生技能送達。MCP 伺服器按每個 CLI 自己的格式寫入。你可以在桌面版或行動應用中建立並附加工具包,也可以讓代理透過 AgentsRoom 工具來完成。

一分鐘內建好一個工具包

不用編輯檔案,也不用手動重啟任何東西。

  1. 1

    開啟工具包庫

    點選標題欄中「代理」旁邊的公文包圖示,或任意工具包欄位旁邊的「管理」,然後選擇「新建工具包」。

  2. 2

    填寫內容

    給它命名,挑選技能和連線,貼上 MCP 伺服器,新增環境變數。令牌請使用 {{secret:NAME}}。

  3. 3

    附加

    在「編輯代理 > 高階選項 > 工具包」、工單、團隊步驟、「專案設定 > 能力與權限」或「資料夾設定 > 知識」中附加。

  4. 4

    選擇記憶

    就在工具包下方,把專案記憶設為「關閉」「唯讀」或「讀寫」,或者保持繼承。

  5. 5

    啟動

    代理下次啟動時,工具包會展開到它的 CLI 中:技能、伺服器、連線和變數,你的儲存庫裡不會寫入任何東西。

為什麼要把人設、工具和記憶分開

過去,一份代理定義同時承載所有東西。想在另一個角色下複用一套技能和伺服器,就得重新搭一遍;而讓代理遠離專案記憶的唯一辦法,是用最簡系統提示詞連人設一起去掉。

分開之後,這三個控制項能應對真實場景:一個讀取記憶但從不寫入的審查員,一個需要筆記伺服器而它的代理恰好沒有的一次性調研工單,一個所有代理都必須連到同一個預發布資料庫的客戶資料夾,一個只在自己那一輪使用瀏覽器工具包的團隊步驟。

對於不想維護設定檔的人來說,這也是進入 harness engineering 的入口:每個選擇都在代理視窗中一目瞭然,隨你的帳戶同步到其他電腦,一眼就能核查。

須知

  • 改動在代理下次啟動時生效。已經在執行的會話會保持它啟動時的配置。
  • 工具包中的專案技能或連線只在其所屬專案中生效。帳戶技能在所有地方生效。
  • 工具包屬於你的帳戶。在與同事共享的團隊中,每個人啟動時只會解析自己的工具包。
  • 團隊步驟有工具包,但沒有記憶設定:對於不能寫入任何內容的步驟,請使用該步驟的「唯讀步驟」開關。
  • 每個代理、工單、步驟、專案或資料夾最多 20 個工具包,每個帳戶最多 200 個。
  • 透過 SSH 在遠端機器上執行的代理會獲得工具包中的技能,但不會獲得其中的 MCP 伺服器。

常見問題

什麼是 harness engineering?

它是一種塑造程式設計代理所處環境的做法,而不只是打磨提示詞:它載入的指令,它能呼叫的工具和 MCP 伺服器,它讀寫的知識。AgentsRoom 把這些要素做成三個控制項(人設、工具包、記憶),你可以按代理、按任務分別設定。

能在多個代理上覆用同一套技能和 MCP 伺服器嗎?

可以。把它們放進一個工具包,附加到每個代理上,或者附加到專案或資料夾,讓其中的所有代理都獲得它。編輯工具包後,它們都會在下次啟動時更新。

能讓單個工單獲得它的代理沒有的 MCP 伺服器嗎?

可以。給工單附加一個工具包。這次執行會在代理自己的工具包之外額外獲得它,代理已儲存的配置不會改變。

如何在不丟掉人設的情況下,阻止代理寫入專案記憶?

把它的專案記憶設為「唯讀」,或設為「關閉」以完全隱藏記憶。人設和工具保持原樣。你也可以只在某一個工單上這樣設定。

它支援 Codex 和其他代理 CLI 嗎,還是只支援 Claude Code?

支援 AgentsRoom 啟動的每一個代理 CLI。技能在所有地方以文字形式送達,在 Claude Code 和 Antigravity 上還會作為原生技能送達;MCP 伺服器按每個 CLI 自己的配置格式寫入;連線和變數無論用哪個 CLI 都會跟著代理走。

我的令牌存放在哪裡?

從不存放在工具包裡。工具包只儲存指向金鑰管理器的 {{secret:NAME}} 引用,真正的值在代理啟動時於你的電腦上解析。

代理能替我建立工具包嗎?

可以,只要你開口。AgentsRoom 工具包括 toolkits_list、toolkits_get、toolkits_save 和 toolkits_delete,而 agents_save、待辦工單、團隊步驟以及專案或資料夾設定都接受工具包列表。代理被明確告知,絕不能為了給自己開通權限而建立工具包。

你可能還喜歡

Multi-Agent Workflow • Handoff • Feedback Loop

AgentsRoom Agent Teams 把 AI 編碼代理串聯成一支真正的工程團隊。視覺化工作流程編輯器 (n8n 風格畫布) 用來連線 Dev、QA、PM、Security 和 DevOps 角色。自動交接,附帶摘要、git diff、風險與測試提示。機器驗證的品質門 (由你的測試套件說了算,而不是代理), 並行的 QA 與 Security 審查分支,條件連線,反饋迴圈,迴圈上限。按團隊選擇角色的執行方式:一個代理在角色之間變形並保留全部上下文,或者每個角色一個線上代理,即時互相發訊息。這是你在 Claude、Codex、GitHub Copilot CLI、Cursor 以及另外 13 個代理 CLI 上的代理一直缺少的多代理編排器。

MCP 伺服器

MCP 伺服器只需宣告一次,就能交給 Claude Code、Codex 和所有代理 CLI。從官方 MCP 登錄檔中挑選,把金鑰放在金鑰管理器裡,用一個「連線」按鈕登入 Notion、Linear 等 OAuth 伺服器。

專案記憶

為您的 AI 編碼代理提供長期記憶。決策、架構和陷阱在會話之間持續存在,並與專案中的每個人共享。免費,無限制。

自定義代理

從 14 個內建代理角色中選擇,新增來自 The Agency 的專業代理,或建置您自己的自定義 AI 編碼代理及其系統提示。然後透過聊天與您的團隊分享您的代理,並將其發布到社群,以便每個人共同提升。

金鑰管理器

把 API 金鑰、令牌和密碼存進作業系統鑰匙串,在開發命令和代理環境裡用 {ref} 引用,交給 AgentsRoom 在啟動時解析。代理只看得到名稱,看不到值,任何內容都不會同步到伺服器。

一次裝備好你的代理

在 macOS、Windows 和 Linux 上免費使用,還可以用行動應用在手機上管理工具包。

免費下載 AgentsRoom

配套應用:隨時隨地監控你的 Agent

使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。

獲取擴充功能
Chrome Web Store

把 Bug 和需求直接傳送到您的公開待辦清單。

多專案管理
多供應商
多代理執行
即時狀態
檔案差異與提交
行動應用
即時預覽
代理團隊
瀏覽器自動化
Backlog 驅動開發
提示詞庫
技能庫
檢視所有功能