Gentle-AI：為你既有的 AI 編碼代理裝上記憶、規範與可驗證的流程
Gentle-AI configures the AI coding agents you already use: Claude Code, Cursor, OpenCode, Codex, Pi, and more. Choose persistent memory, Spec-Driven Development, curated skills, MCP servers, personas, and optional bounded review. Open source, no agent lock-in.
秒懂
- 它是什麼？
- Gentle-AI 不是另一個 AI 編碼代理，而是一個設定器。它把你已經安裝的 Claude Code、Cursor、OpenCode 或 Codex，變成具備持久記憶、規劃流程和技能庫的工程環境。本文根據官方文件與儲存庫內容，檢視它的實際運作方式、安裝步驟、限制與適用對象。
- 適合誰用？
- Gentle-AI 適合已經每天使用 Claude Code、Cursor、OpenCode 或 Codex，且受夠代理每次從零開始、無法記住專案慣例的開發者。它也適合想在不同代理與機器間取得一致行為的團隊。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫在最近一天內有新的提交。
- 用什麼語言寫的？
- 主要是 Go（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月15日）與我們的分析，不構成法律意見。
開源專案深度解析
它解決的不是「沒有代理」的問題，而是「代理太健忘」的問題
多數開發者安裝 Claude Code 或 Cursor 後，很快就會碰到一個具體挫折：代理寫得出程式，但下一次會話就忘了你上次決定的架構、你討厭的寫法、你專案裡的特殊慣例。它也沒有意見，不會主動告訴你「這個功能太大，應該先寫規格」。Gentle-AI 的定位很明確，它不提供新的代理 runtime，而是設定你機器上已經存在的代理。README 用一句話形容這種落差：安裝代理後，它只是「一個會寫程式的聊天機器人」。Gentle-AI 要把它變成「記得你的決定、遵循你的慣例、依照任務大小選擇工作風格、並能產出可審查證據」的環境。這個問題的對象是每天使用代理的人，不是剛開始嘗試 AI 編碼的新手。
Engram 記憶與技能庫：代理如何不再每次從零開始
Gentle-AI 的核心元件是 Engram，README 標註為「Recommended」。它提供跨會話的持久記憶，讓決策、bug 修正與上下文在重啟後仍然存在。實際機制是：Gentle-AI 把 Engram 設定成代理可讀取的記憶檔案或工具，代理在每次任務開始時可以查詢過去的決定。另一個推薦元件是 Skills，這是一組策展過的編碼技能庫，代理只有在任務匹配時才會載入對應技能。這與「把所有指令塞進 system prompt」的做法不同，後者會讓上下文膨脹、成本上升且容易互相衝突。Skills 的設計是條件式載入，代理先判斷任務類型，再決定要使用哪個技能。這個架構的好處是，你不需要為每個專案重寫提示詞，而是由代理根據任務動態選擇。但文件沒有詳細說明技能的格式或如何自行擴充，這對進階使用者可能是個障礙。
Spec-Driven Development 與 bounded review：把「先規劃再寫」變成可選流程
Gentle-AI 提供兩個選擇性的工作流程。SDD 是 Spec-Driven Development，針對「較大的功能」設計，代理會先寫規格再實作，而不是直接產生程式碼。RDD 是 Receipt-Driven Development，README 有列出但沒有詳細解釋，從名稱推測是要求代理在完成後產出「收據」或證據清單。加上「可選的 bounded review」，意思是審查步驟有範圍限制，不是無止盡地要求代理自我檢查。這些流程的價值在於，它們把「代理如何工作」從黑箱變成可預期的步驟。對團隊來說，這代表每個成員的代理會用相同的方式處理大型任務，而不是各自隨興發揮。但要注意，SDD 與 RDD 都是選用元件，如果你不選，代理還是會用預設的即興模式。文件也暗示這些流程會增加每次任務的步驟數，對於只想快速修正一行 typo 的場合，可能過於繁重。
安裝與驗證：gentle-ai 指令、doctor 檢查與「拒絕安裝」原則
安裝流程從官方文件的下載頁開始，README 只給了兩個核心指令。第一個是執行 gentle-ai，它會啟動互動式選擇，讓你挑選要設定的代理、元件與 persona。第二個是 gentle-ai doctor，用來驗證安裝結果。README 特別強調一個原則：Gentle-AI 永遠不會替你安裝 AI 代理。如果你選了一個它偵測不到的代理，它會拒絕執行，並印出你應該自己執行的確切指令。這是一個重要的安全設計，它避免了設定器在不知不覺中下載並執行來路不明的軟體。對使用者來說，這代表你必須先手動裝好 Claude Code 或 Cursor 等工具，Gentle-AI 只負責寫設定檔、裝記憶庫、掛技能。安裝後的更新方式，README 有「Keeping it up to date」一節，但內容沒有在此提供，實際更新指令可能需要查閱 Wiki。
權限防護與模型切換：安全邊界與供應商彈性
Permissions 元件是一個安全優先的護欄，內建 deny list，涵蓋 ~/.ssh、.env 與憑證檔案。這表示代理在讀取檔案時會被限制，不能隨意存取你的私鑰或環境變數。這個設計直接回應了 AI 編碼代理最大的風險之一：代理為了完成任務，可能會讀取不該讀的敏感檔案。GGA（Gentleman Guardian Angel）則是一個 AI 供應商切換器，讓你在不同模型之間切換，可能是為了成本或品質考量。Context7 是另一個 MCP 伺服器，負責抓取即時的框架與函式庫文件，減少代理依賴過時的訓練資料。這些元件都是選用的，你可以只裝 Engram 與 Skills，不裝權限防護，但那就失去了安全邊界。文件沒有說明 deny list 是否可以自行擴充，這對有特殊安全需求的使用者是個需要查證的點。
跨代理一致性與「無鎖定」承諾的實際代價
Gentle-AI 宣稱支援 Claude Code、Cursor、OpenCode、Codex、Pi 等多種代理，且「不鎖定代理」。實際做法是，它把設定轉換成每個代理各自的設定格式，而不是要求你改用特定 runtime。這對團隊很有價值，因為不同成員可能偏好不同代理，但團隊仍能強制一致的記憶與流程。然而，跨代理一致性有其代價。每個代理的設定檔格式、技能載入機制、MCP 支援程度都不同，Gentle-AI 必須針對每個代理維護對應的轉換邏輯。這代表新代理的支援速度取決於專案維護者的更新頻率，而代理本身的版本更新也可能破壞相容性。README 沒有列出每個代理的支援成熟度，例如 Cursor 與 Codex 是否支援 Engram 的所有功能，這需要實測或查閱 Wiki。
授權、維護節奏與升級風險
授權是 MIT，這代表你可以自由修改、商用、甚至整合到自己的工具鏈，不必擔心 copyleft 限制。儲存庫的主要語言是 Go，版本號已到 v2.7.0，最後一次推送是 2026 年 9 月，顯示專案仍在積極開發。值得注意的是 v2.6.0 的版本名稱是「The Runtime Asks First」，這暗示代理的行為有重大改變，可能是要求代理在執行前先詢問使用者。這類變更對既有設定可能造成影響，升級前必須閱讀 release notes。v2.7.0 在 v2.6.0 之後四天就釋出，更新頻率很高，對想穩定使用的團隊來說，代表你需要追蹤變更，否則設定檔可能因為格式調整而失效。文件沒有提供向後相容性的保證，這是採用前必須向維護者確認的事項。
替代方案與真正的差異：手寫設定檔 vs. 生態系設定器
最直接的替代方案是不要用任何設定器，自己為每個代理撰寫設定檔、記憶提示詞與技能目錄。例如在 Claude Code 的設定中手動加入 CLAUDE.md，在 Cursor 的 rules 檔案中寫入專案慣例。這個做法的差異在於，你完全掌控一切，但必須為每個代理重複維護，且無法獲得 Engram 這類跨會話記憶的結構化儲存。另一個替代方案是使用各代理原生的記憶功能，例如 Claude Code 的 CLAUDE.md 本身就有某種記憶效果，但它是靜態文件，不會自動記錄每次決策。Gentle-AI 的差異在於它把記憶、技能、流程、權限整合成一個可重複安裝的套件，並提供互動式選擇與 doctor 驗證。對單一代理的使用者來說，手寫設定可能更輕量；但對多代理或多機器環境，Gentle-AI 的集中設定價值才顯現。
編輯結論
Gentle-AI 適合已經每天使用 Claude Code、Cursor、OpenCode 或 Codex，且受夠代理每次從零開始、無法記住專案慣例的開發者。它也適合想在不同代理與機器間取得一致行為的團隊。不適合從未安裝任何代理的人，因為它明確拒絕替你安裝代理，選了偵測不到的代理會直接印出指令要你手動執行。也不適合只想快速寫程式、不願建立規劃或審查流程的人，因為 SDD 與 bounded review 都是選擇性但會改變工作節奏的元件。採用前應先確認你的代理版本是否在支援清單內，並用 gentle-ai doctor 驗證安裝結果。授權為 MIT，可自由修改與商用，但 Engram 的記憶格式與技能庫綁定此專案的更新節奏，升級前應閱讀 release notes，因為 v2.6.0 開始的「Runtime Asks First」行為可能影響自動化流程。
社群筆記