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