Gentleman-Programming/gentle-ai

Gentle‑AI™ – 面向 AI 代码代理的确定性工程环境

它是什么 – Gentle‑AI 是一个命令行工具，位于您已使用的代码生成代理（例如 Pi、Claude‑Code、Codex、VS Code Copilot、Gemini CLI 等）之上。它添加了一个轻量级、确定性的工作流，为代理提供记忆、结构化委派和可验证的审查证据，从而使代理的输出可以被信任和重现。

关键概念

• Engram™ – 一个持久的项目级记忆，记录代理在会话期间做出的决策。下一次会话可以查询 Engram，而无需重新解释相同的上下文。
• 有机驱动开发（ODD） – 一种基于规则的方法，保持小改动内联，仅为更大、更高风险的工作生成子代理。系统决定为什么委派（探索、并行编写者、上下文后备、独立验证者），而不是按文件数量委派。
• 收据驱动开发（RDD） – 自动、风险感知的审查，在任何只读检查运行之前冻结确切的候选更改。对于高风险更改，执行完整的 4R 审查（风险、韧性、可读性、可靠性）；低风险更改获得轻量级的结构回读。
• 确定性状态机 – gentle‑ai 二进制读取磁盘上的状态，并始终返回四种公共状态之一（工作、检查、就绪、需要您的决策），从工作流中消除模型驱动的非确定性。
• Gentle Shell – 为 Pi 代理捆绑的工作区，包含相同的工作流、技能库、实时文档（Context7 MCP）、只读符号图（CodeGraph）和安全功能（凭据拒绝列表、配置快照、健康检查医生）。

支持的代理 – 17 个集成（Pi、OpenCode、Claude‑Code、Codex、Cursor、VS Code Copilot、Gemini CLI、Kilo Code、Kimi Code、Kiro IDE、Qwen Code、Hermes、Antigravity、Windsurf、OpenClaw、Trae、Conductor）。每个集成使用底层模型的原生能力，同时添加 Gentle‑AI 的工作流。

主要组件

组件	作用
技能库	当任务匹配已知技能时自动加载。
Context7 MCP	可选的实时框架/库文档。
CodeGraph	代码库的只读符号图。
安全拒绝列表	阻止意外暴露 SSH 密钥、.env 等。
配置备份	每次写操作前进行快照。
医生	gentle‑ai doctor – 只读健康报告。
角色	可选的导师式指导（例如“Gentleman”）。
主题	CLI 的视觉主题。
模型分配	选择哪个代理模型处理生成与审查。

典型工作流

1. 安装二进制（Homebrew、curl 脚本或 go install）。
2. 运行 gentle‑ai 选择您偏好的代理、组件和可选角色。
3. 像往常一样使用您的代理；Gentle‑AI 拦截每次写入、快照配置并更新 Engram。
4. 对于更大的任务，编排器可能根据 ODD 触发规则生成子代理。
5. 当更改准备好时，RDD 自动运行基于风险的审查，并产生与确切候选版本绑定的证据。
6. 确定性状态机告诉您更改是工作、检查、就绪，还是需要您手动决策。

安装

# macOS (Homebrew)
brew install gentleman-programming/tap/gentle-ai

# macOS / Linux (curl 脚本)
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

安装后，运行 gentle-ai 进行配置，运行 gentle-ai doctor 验证设置。

为什么重要 – 现代代码生成代理功能强大但无状态；它们忘记项目上下文且不提供审计跟踪。Gentle‑AI 将它们转变为确定性助手，记住决策、强制测试优先开发，并产生可验证的审查工件，使 AI 驱动的编码对生产代码库更安全。

许可证 – MIT（根据仓库徽章）。

---

以上所有信息均直接取自仓库的 README；未推断任何额外功能。