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 驱动的编码助手直接带入开发者的终端，为快速修改和大型、正式规范的变更提供结构化且灵活的工作流。