Gentle-AI：为现有 AI 编程代理提供记忆、流程与审查证据

工具定位

Gentle-AI 是一个 MIT 许可的工具，其 README 表述为「为你已在用的 AI 代理提供确定性工程环境」。它的定位是配置你已有的代理，而非替你安装代理本身。README 明确说明：Gentle-AI 不会安装任何 AI 代理，只配置现有环境；每次写入前会快照配置备份。

主要组件

• Engram：跨会话的项目记忆，让代理在询问用户前先查询已记录的决策。
• ODD（Organic Driven Development）：按「理解程度、风险、可恢复性」而非文件数量给任务分级。小而清晰的任务直接内联执行，不派生子代理、不生成任务文档；跨多会话或需求过长时，才保留一份可恢复的功能文档。
• 子代理委派规则：仅在能说出理由时委派，如探索、并行写入、长会话上下文兜底、独立验证者；不确定时父代理内联完成。
• RDD（Receipt-Driven Development）：默认开启、可关闭（gentle-ai review mode disable）。审查前先冻结候选变更，风险分级决定审查深度（被动/中/高，高风险对应 4R：风险、韧性、可读性、可靠性），结果仅供参考，提交与发布仍由人决定。
• 其他：技能库、可选的 Context7 MCP 文档、只读 CodeGraph 符号图、安全拒绝列表（阻止 ~/.ssh、.env 等凭据文件）、gentle-ai doctor 只读健康检查、可选人设与主题。

安装方式（原文给出）

macOS 可用 Homebrew；macOS/Linux 可用 curl 脚本；Windows 用 PowerShell 源码安装，需 Go 1.25.10+，示例命令指向 v4.1.1。install.sh 在安装目录不在 PATH 时会向 shell 启动文件添加一行；go install 不会修改 PATH，需自行添加。安装后运行 gentle-ai 选择代理、组件与人设，再用 gentle-ai doctor 验证。

限制与注意事项

• 支持 17 种代理集成（徽章写 18 agents，正文写 17 integrations），各集成使用代理原生能力，委派与 RDD 审查等可用功能可能不同。
• Gentle Shell 是独立的 Pi 集成包，安装本二进制不会自动获得 Pi 的行为一致性。
• README 中的基准数据为本地基准、隐藏验收套件、单次运行（n=1）、成本为 API 等价成本，不能当作固定性能承诺；大任务耗时仍约为对比方案的 3 倍，作者称这是待解决项。
• 原文内容被截断，文档链接与完整说明未包含在内。