HumanLayer

一句話介紹

HumanLayer是一套面向軟體團隊的AI編程智能體環境，可把任務、智能體對話、研究文件、設計稿、實施計劃和代碼工作樹集中在同一工作區。

工具簡介

HumanLayer強調讓工程師持續參與關鍵決策，而非將複雜需求直接交給模型一次性地生成代碼。結構化的工作流程會在實作之前完成澄清、代碼庫研究、設計審閱以及分階段規劃。

目前之產品與早期同名SDK並非同一定位。早期HumanLayer主要是為高風險的智能體工具調用加入人工審批，而現行產品則已發展為AI編程環境及團隊級智能體編排平台。

主要功能

任務、會話與工件統一管理

每個任務都可以同時關聯多個智慧體的對話內容、研究與設計成果、實施計劃以及程式碼結構。如此一來，團隊成員就能圍繞同一個任務來查看進度，從而避免上下文資訊分散在聊天窗口和文件工具中的問題。

QRSPI結構化工作流

該平台將複雜的開發任務拆分為六個階段：Questions、Research、Design、Structure、Plan和Implement。在每一個階段中，都會有可審閱的成果，這樣就能在產生大量代碼之前，及時發現錯誤。

多種任務工作流

除了完整的QRSPI流程之外，任務建立介面還提供了RPI、RPI Outline、PRD-Oriented、Oneshot和Freeform等模式。使用者可以根據改動的規模，選擇進行深入研究、從提綱出發來執行任務、以產品需求為導向，或直接處理簡單的任務。

研究、設計與規劃工件

研究文件、設計說明、結構大綱、模型生成的介面草圖以及實施計劃，都會成為與任務相關的工件。這些工件可以進行版本控制並被共享，如此一來，團隊就不必依賴那些越來越多且難以審閱的對話記錄了。

評論驅動的設計審閱

工程師、產品經理和技術負責人可以直接在設計文件中留下評論，智慧體則會根據這些討論結果來調整方案。這種方式將評論與實作流程相連結，因此適合在編碼之前找出架構上的誤解或產品中的疏漏。

完整會話可見性

平台會顯示各個任務下各個會話的狀態、時間以及相關的工件，這樣就能輕鬆了解智能體目前是在研究、等待還是正在執行任務。團隊可以在同一個介面上切換不同的任務和會話，並持續向智能體提供反饋。

多倉庫工作區與Worktree

一個任務可以關聯多個代碼倉庫，並為所選的倉庫建立隔離的工作樹。此功能適用於那些需要同時修改伺服器端、前端以及共享型態的函式庫，但又不想讓不同的智慧體會話互相覆蓋工作目錄的團隊。

本地與雲端並行智能體

本地守護進程能夠在電腦上同時運行多個智慧體會話，而長期任務則可以交給雲端守護進程處理。平台會同步狀態，讓使用者能夠透過網頁、桌面端或手機介面查看進度。

快捷鍵與命令面板

HumanLayer提供了針對鍵盤操作的任務、會話、工件以及動作切換功能。如此一來，頻繁進行開發工作的使用者就能減少在編輯器、終端機、工作單和文件頁面之間反覆尋找相關資訊的時間。

支援的智能體與模型渠道

HumanLayer採用BYOK方式，使用者可透過現有的AI訂閱服務或API金鑰來進行連接。目前頁面上列出了Claude Code、Codex、Copilot和Fireworks等模型，並表示未來還會持續增加新的模型或訂閱選項。

BYOK並不代表使用成本為零。HumanLayer不會收取以代幣計算的平臺費用，但模型訂閱、API代幣、雲端運算以及企業基礎設施仍可能產生額外的開支。

典型使用流程

用完整工作流處理複雜需求

1. 建立任務，可從文字描述、Linear工單或Jira工單中導入需求。
2. 選擇要參與的代碼倉庫，並決定是立即建立工作樹、稍後再建立，還是不建立工作樹。
3. 讓智能體先生成澄清問題，補充業務目標、技術約束和驗收標準。
4. 進入研究階段，檢查其對代碼庫結構、依賴和既有模式的理解。
5. 審閱設計文件並透過行內評論修正介面、資料流與架構判斷。
6. 確認結構和實施計劃包含文件位置、測試用例、驗收項與回滾思路。
7. 批准後進入實現，並在每個階段查看代碼、測試和智能體反饋。
8. 完成後由人工執行代碼審查、測試、安全檢查和合併決策。

用輕量流程處理小改動

1. 為缺陷修復、文案調整或小範圍重構建立獨立任務。
2. 選擇RPI Outline、Oneshot或Freeform，避免為簡單改動建立過重流程。
3. 限制允許修改的倉庫、目錄和測試範圍。
4. 檢查智能體的差異、測試結果和未解決的問題。
5. 確認沒有越權修改或敏感資訊後再提交代碼。

任務創建與工作區配置

• 任務描述應包含目標、非目標、技術約束和可驗證的完成標準。
• 多倉庫任務要明確主倉庫以及每個配套倉庫承擔的職責。
• 工作樹適合並行隔離變更，但仍需規劃分支命名、依賴安裝和清理策略。
• 從Linear或Jira匯入工單之後，應補充工單中缺失的程式碼庫相關資訊。
• 高風險遷移、權限和支付邏輯應使用完整工作流並設置人工檢查點。

工件與團隊協作

• 研究工件記錄代碼庫結構、依賴關係和既有實現模式。
• 設計工件用於討論技術方案、資料流、介面及替代路徑。
• 結構與計劃工件將大型改動拆成可檢查的小階段。
• 內聯圖表和界面草圖能夠幫助團隊更快理解互動與架構。
• 評論和決策會反饋給智能體，使工件成為執行流程的一部分。
• 工件與任務綁定，便於新成員回看為何採用某種實現。

多倉庫與並行開發

價格與套餐

截至2026年8月23日，HumanLayer公開了Starter、Pro和Enterprise三種方案。Starter適用於人數在三名以內的小團隊，Pro則是按使用者數量及月份來計費，而Enterprise則需要聯繫銷售人員，以確定部署細節及合約條件。

套餐選擇建議

• 個人或三人以內的團隊可以先用Starter驗證工作流，每月200個會話可能限制高頻並行開發。
• 需要無限任務、多倉庫協作、遠端守護進程或團隊工件審閱時適合Pro。
• 需要統一身份登入、審計日誌、私有網路或本地部署時應選擇Enterprise並確認合約。
• 所有套餐都應把模型訂閱、API密鑰和雲端運行成本納入總體預算。
• 價格、稅費和權益可能調整，購買前應以帳戶結算頁或銷售報價為準。

BYOK費用說明

平台允許使用已有的Claude、Codex等訂閱或API金鑰，因此HumanLayer的費用與模型本身的費用是相互獨立的。在評估成本時，應同時考慮平台使用權、模型消耗量、遠端運行所需的資源，以及內部審核所需的时间。

適合哪些用戶

• 需要在大型或多倉庫代碼庫中使用AI智能體的軟體工程團隊。
• 希望將研究、設計、規劃和實施納入統一審閱流程的技術負責人。
• 同時運行多個編碼會話並需要工作樹隔離的進階開發者。
• 希望從Linear或Jira工單啟動智能體任務的產品研發團隊。
• 有遠端守護進程、審計日誌、私有VPC或本地部署要求的企業。
• 重視可追溯決策和持續累積工程上下文的平台團隊。

不太適合的情況

• 只需要單文件補全、簡單問答或偶爾生成短代碼的使用者。
• 無法提供受支援模型訂閱或API金鑰的團隊。
• 不願維護任務邊界、設計審閱和人工批准流程的個人。
• 禁止程式碼或開發工件進入外部雲服務，且未採購私有部署的組織。
• 希望依賴完全開源且可自行部署現行平台全部組件的使用者。

產品優勢

• 把需求澄清、代碼庫研究、設計、計劃和實現組織成連續流程。
• 任務、會話、工件和工作樹統一關聯，方便團隊理解開發狀態。
• 設計評論能夠直接反饋給智能體，減少文件與執行脫節。
• 支援多倉庫與並行工作樹，適合複雜工程環境。
• 本地和雲端智能體可以共同承擔不同持續時間的任務。
• BYOK允許團隊繼續使用已經採購的模型渠道。
• 免費Starter可供小團隊低成本驗證協作方式。

使用限制與風險

• 智能體仍可能誤解代碼、引入缺陷或生成不安全實現，人工審查不能省略。
• 結構化流程會增加前期討論成本，不一定適合極小改動。
• 多會話並行可能造成重複工作、依賴衝突和更高模型消耗。
• 工作樹只能隔離目錄，不能替代分支策略、持續集成和權限管理。
• BYOK金鑰與開發環境權限需要妥善隔離，避免智能體接觸無關的生產資源。
• 雲端會話可能處理代碼、提示詞和工件，敏感組織應先完成數據與合規評估。
• 服務、功能及公開套餐仍可能變化，關鍵採購條件應寫入合約。

隱私與資料安全

HumanLayer的運營主體為QueryTale, Inc.。其隱私政策適用於網站、軟體及相關服務，並說明了可能會收集的資訊，包括聯絡人資料、帳戶資訊、付款資訊、使用者生成的內容、使用活動記錄、裝置資訊以及大約的位置資訊等。

敏感代碼與金鑰管理

1. 為HumanLayer和模型渠道創建獨立賬戶或專用金鑰。
2. 只授予當前倉庫和任務所必需的檔案、命令與網路權限。
3. 將生產憑證、客戶數據和個人資訊排除在提示詞與工件之外。
4. 在允許雲端守護進程處理代碼前完成數據分類和跨境審查。
5. 使用代碼審查、自動測試、秘密掃描和依賴檢查驗證輸出。
6. 任務結束後撤銷臨時密鑰並清理不再使用的作業樹和會話。

開源與GitHub說明

現行官網明確表示，HumanLayer平台目前尚未整體開源，但相關的研究、規劃以及工作流程已經公開。不能因為過去的版本中可以查看代碼，就將目前的雲端平台、本地守護進程以及團隊服務全部視為開源。

早期HumanLayer與CodeLayer的倉庫曾採用Apache-2.0許可證，現有的倉庫說明及開發狀態仍保留著過渡期的痕跡。早期的SDK文件上已標明其已被CodeLayer取代，相關的SDK代碼也已被從主專案中移除。

早期SDK與現行產品的差異

基本資訊

常見問題

HumanLayer是什麼？

它是一套將 AI 程式設計工具、任務、對話、工程文件以及程式碼結構整合在一起的團隊開發平台。其核心價值在於，能讓工程師在研究、設計和實作等關鍵階段持續進行審核。

HumanLayer免費嗎？

Starter方案免費，最多支援3名團隊成員以及每月200次會話。若需要更高的使用量、多個倉庫工作區、遠端守護進程以及更先進的協作功能，則可選擇Pro或Enterprise方案。

Pro套餐多少錢？

目前公開的價格為每位使用者每月100美元。模型訂閱或API使用量並不包含在該費用之中，需透過BYOK途徑另行支付。

是否支援Codex？

支持。現行產品頁面將Codex列為BYOK智能體和模型渠道，同時也列出Claude Code、Copilot與Fireworks。

是否必須使用完整QRSPI流程？

不必如此。使用者還可以選擇 RPI、RPI Outline、PRD-Oriented、Oneshot 或 Freeform，根據任務的複雜度來減少或增加檢查階段。

能處理多個倉庫嗎？

可以。Pro方案包含多倉庫工作區和工作樹，創建任務時可為多個倉庫準備隔離目錄。

HumanLayer是開源軟體嗎？

現行平台尚未整體開源，只有部分工作流和歷史專案公開。早期倉庫的Apache-2.0許可無法直接代表當前商業平台的全部組件。

早期人工審批SDK還能用於新項目嗎？

不建議。相關文件已明確說明，早期的SDK已被CodeLayer取代，SDK代碼也已被從主專案中移除，新專案應根據當前產品的能力重新評估方案。

代碼會一直留在雲端嗎？

公開的隱私政策並未對所有程式碼與工作檔案規定統一的保存期限，而是根據業務需求及法律要求來決定其保存方式。處理敏感資料的團隊應與銷售部門確認有關資料流動、保存、刪除以及私人部署的相關規定。

可以完全取代程式碼審查嗎？

不可以。平台雖能幫助團隊更早地審查研究、設計和計劃，但模型仍可能產生錯誤或不安全的程式碼，最終的測試、權限檢查以及合併工作仍需由團隊負責。

總結

HumanLayer適合那些希望將 AI 程式設計從單次對話的方式，提升為團隊協作流程的使用者。透過任務、工件、評論、工作樹，以及本地或雲端會話等功能，它讓複雜的改動在實施之前能夠有更多可驗證的參考資料。

選擇時應重點比較團隊規模、每月會話量、多倉庫需求、模型費用、雲端代碼處理以及合規要求。還需區分現行的商業平台、公開工作流與已廢棄的早期SDK，避免基於歷史倉庫作出錯誤的部署判斷。