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；未推断任何额外功能。