Gentleman-Programming/gentle-ai

Gentle-AI 是一个 Go 二进制工具，用来配置你已经在用的 AI 编程代理——Claude Code、Cursor、Codex、OpenCode、Pi 等 17 种集成——为它们加上一套共享工作流，而不是替换代理或模型。它面向的是被「每次新会话都要重新解释项目」和「改完无法验证」困扰的开发者。两个最核心的补充是 Engram 项目记忆，以及按理解程度、风险和可恢复性（而不是文件数量）决定工作量的 Organic Driven Development（ODD）README。

一次会话里改变了什么

Engram 让代理边做边记，并在新会话或上下文压缩后先查记忆再找你，避免重复阅读仓库或重复询问 Engram 文档。ODD 让已理解的小改动直接内联完成、不写任务文档；较大的已授权工作则生成一份可恢复的 feature 文档，原样保存你的规格，交接时指向该文档而不是转述 ODD 文档。

委派同样有门槛：只有能说出理由时才启动子代理，例如探索超过约 3 次调用和 10k tokens、多个互不依赖的并行写入者、长会话的上下文接力，或针对高风险改动的独立验证者；没有理由就由主代理内联完成 路由规则。

评审与确定性

Receipt-Driven Development（RDD）默认开启，可用 gentle-ai review mode disable 关闭。评审前会冻结候选改动，证据只针对这个确切版本；评审深度由风险评估决定，从结构性回读到完整 4R 透镜，最多允许一次有限修正。评审结果仅供参考，提交、推送和发布仍由你决定 评审文档。gentle-ai 二进制从磁盘读取变更状态并给出唯一有效的下一步，而不是由模型投票决定 README。

README 引用的是另一个项目 Gentle Shell 的基准结果：一个 3 行 bug 从 335 秒 / 56 轮 / $0.339 降到 77 秒 / 10 轮 / $0.105；一份 73 行规格加 26 项隐藏检查从失败变为通过。这些是本地基准上的单次运行（n=1），成本按 API 等价计算，且属于不同软件包，不代表每个代理集成都能得到同样结果 README。

前提与限制

支持 macOS、Linux 和 Windows；macOS 有 Homebrew，macOS/Linux 有 curl 脚本，Windows PowerShell 路径是源码安装，需要 Go 1.25.10+，且不会自动修改 PATH README。Gentle-AI 明确不替你安装代理，只配置已有的代理，因此各代理功能会因原生能力不同而不同 README。每次写入配置前都会备份，安全拒绝列表会拦截 ~/.ssh、.env 等路径，gentle-ai doctor 提供只读健康检查。Gentle Shell 是单独的 Pi 软件包，安装本二进制并不代表获得它的运行时行为 README。代码采用 MIT 许可证；Gentle AI 与 Engram 名称和标识是商标，许可证不允许暗示背书 README。