Go Gentle-AI 给现有AI编程智能体套上工程纪律的配置器

智能体写代码快，但每次新会话都是一张白纸：昨天刚定下的技术选型，今天它又来问你；三行代码的小 Bug，它兴师动众开一堆子智能体，烧钱又耗时；做完的改动对不对，只能靠你自己逐行读。工具换了一圈，这些毛病一个没少，因为你缺的不是更强的模型，而是一套确定性的工程纪律。

Gentle-AI 是一个用 Go 写的配置工具，定位很克制：它不替你装任何智能体，而是把你已经在用的 Claude Code、Codex、Cursor、OpenCode、Gemini CLI 等 17 种智能体配置成有记忆、有工作流、有证据的工程环境。改配置前自动快照，随时可回滚。

项目基本信息

一、项目介绍

Gentle-AI 自称「给你已有智能体的确定性工程环境」。它的核心由几块组成：Engram 记忆系统让智能体把学到的东西边干边记，下次先查记忆再问你，项目上下文跨会话累积而不是归零；ODD（有机驱动开发）流程按理解程度、风险和可恢复性给任务分级，小事内联快办，大事留一份可恢复的功能文档，会话之间不断档；委派规则明确到「没有理由就不开子智能体」，探索、并行写作、上下文兜底、独立验证四种理由之外，一律主智能体自己干。

效果有实测数据支撑：一个单函数三行小 Bug，从 335 秒 56 轮 0.339 美元优化到 77 秒 10 轮 0.105 美元；高风险的数据迁移任务靠独立验证者一次通过，省掉了返工轮次。

整个安装器覆盖 Pi、OpenCode、Claude Code、Codex、Cursor、VS Code Copilot、Gemini CLI、Kimi Code、Kiro、Qwen Code、Trae 等主流工具，共 17 个集成点，都走原生配置通道。

二、核心优势

第一，不绑定生态。你不用换智能体，它只是给现有工具配置行为，订阅、API Key、登录态全部保留。

第二，确定性优先。每一步下一个合法动作是可预期的，配置写入前有快照，状态文件坏了有 doctor 命令诊断修复。

第三，省钱。路由规则按任务复杂度分流，避免小任务被大流程放大，官方基准显示小改动成本降到原来的三分之一。

第四，测试先行。每条你要求的规则都会配验证手段，改动是否达标有证据可查，不用逐行人肉审。

三、适用场景

第一类是多智能体重度用户：同时开着 Claude Code 和 Codex 的开发者，装完后两者的行为标准、记忆和流程统一管理，不用分别调教。

第二类是成本敏感的个人项目：路由规则和委派约束直接压低 token 消耗，对按量付费的用户是实打实的账单差异。

第三类是小团队规范统一：把工程纪律做成配置分发，新成员的智能体第一天就按团队标准干活。

四、安装教程

macOS 用 Homebrew：

brew install gentleman-programming/tap/gentle-ai

macOS 和 Linux 也可以用脚本安装：

curl -fsSL https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.sh | bash

Windows 用 PowerShell 走源码安装，需要 Go 1.25.10 以上：

go install github.com/gentleman-programming/gentle-ai/v4/cmd/gentle-ai@v4.1.1

注意 go install 不会自动改 PATH，装完若提示找不到命令，把 $(go env GOBIN)（默认 ~/go/bin）加进 PATH 再开新终端。安装脚本会自动处理 PATH，它会往你的 shell 启动文件里加一行标记注释，检测到符号链接或不可写文件时不会乱改，而是打印需要你手动添加的内容。

装好后运行 gentle-ai 进入交互界面，选智能体、组件和人格；首次配置完跑一次 gentle-ai doctor 验证状态文件正常。

五、使用示例

安装完成后正常使用你的智能体即可。以修一个 Bug 为例：你照常描述问题，智能体先判断这是内联小任务，直接读文件、改代码、跑测试，全程不开子智能体，几分钟收工。换成一次跨模块的数据迁移，它会先写一份功能文档把需求原文锁进去，实施时请一个独立验证者把关，完成后文档里留下完整的决策记录——下次接着迭代时，上下文从文档恢复，不用你重新讲一遍。

想换配置随时重跑 gentle-ai，写入前的快照保证出问题可以整体回滚。

六、常见问题

会覆盖我的智能体配置吗？每次写入前自动快照，且它从不安装或卸载智能体本身，只做配置。

doctor 报状态文件损坏怎么办？按提示检查文件权限或恢复备份的 JSON，doctor 本身不修改任何内容。

必须配合 Pi 使用吗？不是。Gentle Shell 是独立的 Pi 集成包，Gentle-AI 本身服务 17 种智能体，Pi 只是其中之一。

七、总结

Gentle-AI 走了一条聪明的中间路线：不造智能体，不抢生态，只把散落各处的工程纪律配置到位。记忆让它不健忘，ODD 让它不乱花钱，证据链让它可审计。如果你已经在几个智能体之间反复横跳，这个配置器值得试一次。