Gentleman-Programming/gentle-shell

gentle-shell™ – 面向 Pi 開發環境的 AI 驅動型程式碼代理

是什麼 – gentle-shell（以 gentle-pi npm 套件形式分發）是一種基於終端的工作區，允許一個基於大型語言模型（LLM）的 程式碼代理 在您的專案中執行。該代理可探索程式碼庫、提出變更、執行測試，並展示差異，而您則透過顯示目前任務、會話變更與執行時狀態的 UI 保持控制權。

核心理念

• 以工作區為中心 – 此 shell 提供單一面板（/gentle:… 命令）聚合代理的工作、其子代理與待辦事項清單，讓您始終留在終端中。
• 專注型代理 – 父級會話可產生有限的「工作代理」（例如，映射倉儲、實作變更、驗證），並接收簡潔的確認與證據回饋。
• 有機驅動開發（ODD） – 預設工作流程鼓勵輕量級、增量式工作：描述期望結果，讓代理執行，然後審查具體變更。對於較大、分階段的任務，可選的 規格驅動開發（SDD） 週期可供使用。
• 原生審查 – 在任何變更生效前，代理會呈現一個凍結的候選變更差異供您批准、拒絕或要求修正，確保人類始終參與其中。
• 可擴充的「同伴」 – 可選套件（如 gentle-engram、pi-intercom 等）可新增持久記憶、跨會話訊息、網路存取等能力，但非必要。

快速上手

# 安裝最新穩定版（撰寫時為 v2.6.0）
pi install npm:gentle-pi@2.6.0

# 重啟 Pi，然後同步資源
gentle-ai sync

# 在專案中啟動 Pi REPL – gentle-shell UI 將出現
pi

之後，您可以使用內建命令如 /gentle:status、/gentle:doctor 或 /gentle:review-mode enable 來檢查代理狀態、診斷問題或啟用可選的審查模式。

關鍵文件

• 工作區佈局 – docs/gentle-shell.md 解釋了面板、/gentle:changes 視圖以及如何導航 UI。
• ODD 工作流程 – docs/readme-reference.md#organic-driven-development 逐步說明日常的「意圖 → 結果」循環。
• SDD/OpenSpec 流程 – 可選的正式階段在同個參考文件的 SDD/OpenSpec 部分有描述。
• 審查整合 – docs/review-integration.md 詳細說明代理將具體變更差異交由人類審批的邊界。
• 原生權限架構 – docs/native-authority-architecture.md 明確說明破壞性操作的所有權與安全邊界。

社群與支援

• 問題與功能請求： https://github.com/Gentleman-Programming/gentle-pi/issues
• 實時協助的 Discord 聊天： https://discord.com/invite/gentleman-programming-769863833996754944
• 貢獻者名單列在倉儲的貢獻者圖表中，並透過 contrib.rocks 標籤可視化展示。

授權 – MIT（參見 LICENSE）。本專案商標（gentle-shell™、gentle-pi™）歸作者 Alan Buscaglia 所有。

---

gentle-shell 是一款真正的開源工具，將 LLM 驅動的程式碼助手直接帶入開發者的終端，為快速修改與大型、正式規格的變更提供結構化且彈性的工作流程。