Gentleman-Programming/gentle-ai

Gentle‑AI™ – 现有 AI 编码助手的生态系统配置工具

功能说明

• Gentle‑AI 本身不提供 AI 模型。相反，它将您已安装的编码助手（Claude Code、Cursor、OpenCode 等）与一系列可选组件连接，赋予其记忆、规划、技能库、安全防护墙和审查工作流。
• 该工具以小型 Go 二进制文件（gentle-ai）运行。完成一次安装后，启动交互式终端 UI，选择您使用的助手，选择预设或单个组件，程序将把相应的配置文件写入助手的原生配置目录。

核心组件

组件	目的
Engram™	持久化记忆，重启后仍保留，使助手能记住过往的决策、修复和上下文。
Skills	经筛选的编码“技能”库，当任务匹配时助手会自动加载。
Persona	可选的指导型语音（如 Gentleman 或中性），可自定义。
Spec‑Driven Development (SDD)	大功能的规划工作流：探索 → 提议 → 规格 → 设计 → 任务列表 → 实现 → 验证。
Context7	一个 MCP（以元数据为中心的代理）服务器，在会话期间获取实时框架和库文档。
Permissions	安全防护墙，拒绝访问敏感路径如 ~/.ssh 或 .env。
GGA (Gentleman Guardian Angel)	AI 提供商切换器，可将请求路由到不同后端。
Theme	支持的助手（Claude Code、OpenCode）的可选视觉主题。

预设将这些组件打包，实现快速部署：

• full‑gentleman – 全部功能（记忆、SDD、所有技能等）
• ecosystem‑only – 核心组件，不含可选扩展
• minimal – 仅 Engram 和 SDD
• custom – 自由组合任意组件。

支持的助手 Gentle‑AI 与众多现有编码助手兼容，从支持子助手的 Claude Code 和 OpenCode，到单体助手工具 Windsurf。它为每个助手生成原生配置格式（如 Codex 使用 TOML，Cursor 使用 ~/.cursor/agents/ 下的文件），并尊重助手自身的委派模型。

安装与使用

1. 前置条件 – Node 18+、npm、Git 2.38+，以及 Go 1.25.10+（仅 Windows 或从源码构建时需要）。您选择的 AI 助手必须已在 PATH 中。
2. 安装二进制文件 – macOS/Linux 使用单行命令 curl … | bash，Windows 使用 go install …。
3. 运行 TUI – 执行 gentle-ai 可选择助手、组件和人格。在覆盖现有配置前会自动备份。
4. 验证 – gentle-ai doctor 生成只读健康报告（二进制存在性、Engram 可达性、磁盘空间、损坏符号链接等）。

决策机制 Gentle‑AI 添加了路由层，为给定请求选择最小可行工作流：

• 小规模、范围明确的变更 → 直接内联执行。
• 中等规模变更（≥4 个文件，需广泛调研）→ 由委派的子助手处理，无需额外产物。
• 模糊、大型功能 → 助手 提供 可选的 SDD 工作流；仅在您接受提案后才继续。 路由决策与后续审查步骤无关。

Spec‑Driven Development (SDD)

• 通过说 “使用 SDD” 或接受助手的提案触发。
• 生成持久化产物（提案、规格、设计、任务列表），可存储于 Engram、版本控制文件（OpenSpec）或两者。
• 包含可选的 Research lane，用于记录可审计的外部证据。
• 启用严格 TDD 时仍保持独立，与后续的 Receipt‑Driven Development (RDD) 审查分离。

Receipt‑Driven Development (RDD)（可选）

• 实现后提供基于证据的审查。
• 定义 候选（变更的精确字节）、冻结（起始快照）和一组 透镜（风险、韧性、可读性、可靠性）。
• 审查工作量基于声明的风险等级，而非文件数量。
• 生成 结果（信息性证据）和 确认（助手已记录审查结果）。

文档与社区

• 完整文档位于仓库的 docs/ 文件夹和公共 Wiki 中。
• 提供“doctor”命令用于故障排查。
• 项目采用 MIT 许可证，支持 macOS、Linux 和 Windows。

总结 Gentle‑AI 是一个 配置层，将独立的 AI 编码助手转变为更严谨的开发伙伴，无需安装新模型即可添加记忆、规划、技能选择和可选的证据驱动审查。