Gentleman-Programming/gentle-ai

Gentle‑AI™ – 為現有 AI 程式碼助手打造的生態系組態工具

功能說明

• Gentle‑AI 本身不提供 AI 模型。相反，它將您已安裝的程式碼助手（Claude Code、Cursor、OpenCode 等）與一系列可選元件連結，賦予其記憶、規劃、技能庫、安全防護牆與審查工作流程。
• 該工具以小型 Go 二進位檔（gentle-ai）執行。完成一次安裝後，啟動互動式終端 UI，選擇您使用的助手，選擇預設或單一元件，程式將把相應的設定檔寫入助手的原生設定目錄。

核心元件

元件	目的
Engram™	持久化記憶，重啟後仍保留，使助手能記住過往的決策、修復與上下文。
Skills	經篩選的程式碼「技能」庫，當任務匹配時助手會自動載入。
Persona	可選的指導型語音（如 Gentleman 或中性），可自訂。
Spec‑Driven Development (SDD)	大功能的規劃工作流程：探索 → 提議 → 規格 → 設計 → 任務清單 → 實作 → 驗證。
Context7	一個 MCP（以元資料為中心的代理）伺服器，在會話期間取得即時框架與函式庫文件。
Permissions	安全防護牆，拒絕存取敏感路徑如 ~/.ssh 或 .env。
GGA (Gentleman Guardian Angel)	AI 提供者切換器，可將請求路由至不同後端。
Theme	支援的助手（Claude Code、OpenCode）的可選視覺主題。

預設將這些元件打包，實現快速部署：

• full‑gentleman – 所有功能（記憶、SDD、所有技能等）
• ecosystem‑only – 核心元件，不含可選擴充
• minimal – 僅 Engram 與 SDD
• custom – 自由組合任意元件。

支援的助手 Gentle‑AI 與眾多現有程式碼助手相容，從支援子助手的 Claude Code 和 OpenCode，到單體助手工具 Windsurf。它為每個助手產生原生設定格式（如 Codex 使用 TOML，Cursor 使用 ~/.cursor/agents/ 下的檔案），並尊重助手自身的委派模型。

安裝與使用

1. 前置條件 – Node 18+、npm、Git 2.38+，以及 Go 1.25.10+（僅 Windows 或從原始碼建置時需要）。您選擇的 AI 助手必須已在 PATH 中。
2. 安裝二進位檔 – macOS/Linux 使用單行命令 curl … | bash，Windows 使用 go install …。
3. 執行 TUI – 執行 gentle-ai 可選擇助手、元件與人格。在覆蓋現有設定前會自動備份。
4. 驗證 – gentle-ai doctor 產生唯讀健康報告（二進位存在性、Engram 可達性、磁碟空間、損壞符號連結等）。

決策機制 Gentle‑AI 加入路由層，為給定請求選擇最小可行工作流程：

• 小規模、範圍明確的變更 → 直接內嵌執行。
• 中等規模變更（≥4 個檔案，需廣泛調查）→ 由委派的子助手處理，無需額外產物。
• 模糊、大型功能 → 助手 提供 可選的 SDD 工作流程；僅在您接受提案後才繼續。 路由決策與後續審查步驟無關。

Spec‑Driven Development (SDD)

• 透過說 「使用 SDD」 或接受助手的提案觸發。
• 產生持久化產物（提案、規格、設計、任務清單），可儲存於 Engram、版本控制檔案（OpenSpec）或兩者。
• 包含可選的 Research lane，用於記錄可審計的外部證據。
• 啟用嚴格 TDD 時仍保持獨立，與後續的 Receipt‑Driven Development (RDD) 審查分離。

Receipt‑Driven Development (RDD)（可選）

• 實作後提供基於證據的審查。
• 定義 候選（變更的精確位元組）、凍結（起始快照）和一組 透鏡（風險、韌性、可讀性、可靠性）。
• 審查工作量基於宣告的風險等級，而非檔案數量。
• 產生 結果（資訊性證據）和 確認（助手已記錄審查結果）。

文件與社群

• 完整文件位於倉儲的 docs/ 資料夾與公開 Wiki 中。
• 提供「doctor」命令用於故障排除。
• 項目採用 MIT 許可證，支援 macOS、Linux 與 Windows。

總結 Gentle‑AI 是一個 設定層，將獨立的 AI 程式碼助手轉變為更嚴謹的開發夥伴，無需安裝新模型即可添加記憶、規劃、技能選擇與可選的證據驅動審查。