Gentle-AI Skill：把你的AI编程助手变成配置完整的工程环境

Skill超级捕获手 技术创作者 2026-09-08 14 阅读

Gentle-AI 让你的现有 AI 编程助手升级为一个配置完整的工程环境。它不是一个新的 Agent runtime，而是一个生态配置层——对接你已在使用的 Claude Code、Cursor、OpenCode、Codex、Pi 等，在不替换原有 Agent 的前提下，为其叠加持久化记忆、Spec-Driven Development 工作流、技能库、MCP 工具服务器、多模型路由和可选的证据核查机制。2026 年 9 月 8 日当天活跃更新，在 GitHub Trending 今日热榜上位列 AI 编程助手类目，累计 6,414 颗星、729 个 fork。开发团队 Gentleman-Programming 同时维护着 Engram（持久化记忆协议）、gentle-pi（Pi Agent 专用 harness）和 Gentleman Guardian Angel（AI Provider 切换工具），整个工具链互相咬合。

功能与原则

Gentle-AI 的核心设计哲学是「不替换你的 Agent，只配置它」——所有配置都写入目标 Agent 自身的原生配置目录，Gentle-AI 本身不提供 AI 能力，而是激活 Agent 已有的内置机制。

核心组件（可自由组合）：

  • Engram：持久化记忆跨 session 保留，决策、上下文、bug 修复记录在重启后依然可用
  • Skills：精选技能库，当任务类型匹配时自动加载（如 gentle-sdd-* 系列命令对应 SDD 工作流）
  • Persona：可选的教学风格人格（Gentleman 或 neutral），或自定义角色设定
  • SDD（Spec-Driven Development）：面向重要功能的计划工作流——先探索代码库、形成提案、经你审批后、再实施验证
  • RDD（Receipt-Driven Development）：证据驱动开发，要求 Agent 为每个变更产出可核查的证据记录
  • Context7：MCP 服务器，实时拉取框架/库的最新文档，避免 Agent 输出过时 API 信息
  • Permissions：安全护栏，~/.ssh、.env 和凭证文件写入操作需显式授权
  • GGA（Gentleman Guardian Angel）：AI Provider 切换器，支持在不同模型间路由

认可度

  • GitHub Star：6,414 颗（截至 2026-09-08）
  • Forks：729 个
  • License：MIT
  • GitHub 趋势：2026-09-08 当日热榜，AI 编程助手类目
  • 更新时间：2026-09-08（当天活跃推送）
  • 维护团队：Gentleman-Programming，同时维护 Engram、gentle-pi、agent-teams-lite（已归档）等多个知名 Agent 工具
  • 安装量：通过 Homebrew、Scoop、Go install 多渠道分发，文档完善

链接

GitHub 仓库：https://github.com/Gentleman-Programming/gentle-ai

原作者

Gentleman-Programming（GitHub Organization），专注于 AI 编程助手生态工具链的开发团队。代表作包括 Engram（Agent 持久化记忆协议）、gentle-pi（Pi Agent 专用 harness）、gentle-guardian-angel（代码审查工具）和 agent-teams-lite（已归档，被 Gentle-AI 替代）。

介绍

Gentle-AI 起源于一个常见痛点：安装了 AI 编程助手，但它每个 session 都从零开始，不记得项目决策、不知道团队规范、无法核查它到底做了什么。传统的解法是换更强悍的模型或换 Agent 平台，但这并没有解决根本问题——没有记忆机制、没有结构化工作流、没有验证手段。

Gentle-AI 的答案是：不要换 Agent，配置你的现有 Agent。它支持 Claude Code、Cursor、OpenCode、Codex、Pi、Kilo Code、Gemini CLI、Antigravity、Kiro IDE、Qwen Code、Hermes、Windsurf、OpenClaw、Trae 等 15+ 种 Agent，覆盖了主流和新兴平台。每个 Agent 的配置方式各不相同——Claude Code 用 Task 工具实现子 Agent 委托，OpenCode 用多模式 overlay 实现分阶段模型路由，Pi 则通过 gentle-pi harness 接管其人格和记忆布线。Gentle-AI 会在配置前自动备份原有配置，防止覆盖。

整个工具链的设计亮点在于「有机路由」：Agent 根据任务规模自主选择最小执行路径，1-3 文件理解或简单机械变更直接执行，无需 SDD 流程；只有当任务存在实质性歧义、用户主动要求或 Agent 主动提议时，才会启动 Spec-Driven Development 工作流。这避免了为小任务引入过度工程化。

特点

  • Agent 无关：配置层，不替换你的 Agent，所有能力通过目标 Agent 原生接口实现
  • 15+ Agent 支持：覆盖 Claude Code、Cursor、OpenCode、Codex、Pi、Gemini CLI、Hermes 等主流与新兴平台
  • 持久化记忆（Engram）：跨 session 记住决策、上下文、bug 修复记录
  • 有机路由决策：Agent 根据任务规模自动选择最小路径，不会为小任务启动重型流程
  • SDD 工作流：面向复杂功能的提案→审批→实施→验证完整闭环
  • 证据驱动开发（RDD）：每个变更产出可核查证据，不只是信任 Agent 的总结
  • Context7 MCP：实时拉取框架/库文档，减少 Agent 输出过时 API 的概率
  • 安全护栏：可选权限控制，凭证文件和 ssh 目录写入需显式授权
  • 零锁定：配置写入选定 Agent 的原生目录，随时可卸载还原

使用方法

安装依赖：Node.js 18+、npm、Git 2.38+（所有平台）；Windows 额外需要 Go 1.25.10+。

macOS / Linux 安装：

curl -fsSL https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.sh | bash

Windows 安装（Go from source）：

go install github.com/gentleman-programming/gentle-ai/v2/cmd/gentle-ai@latest

启动交互式 TUI：

gentle-ai

在 TUI 中选择目标 Agent（如 Claude Code）、选择组件（可选 Preset：Dev Stack + Polish full-gentleman / Dev Stack ecosystem-only / Memory Only / Custom），或自定义组件组合。

健康检查：

gentle-ai doctor

输出只读诊断报告，检查工具二进制文件、Engram 可达性和磁盘空间，不做任何修改。

安装到特定 Agent：

gentle-ai --agent claude-code
gentle-ai --agent cursor
gentle-ai --agent pi   # 触发 gentle-pi harness 安装

基本使用（以 Claude Code 为例）：

安装后直接使用 Claude Code，无需额外操作。Gentle-AI 在后台注入系统提示和技能库——当你的指令触发 SDD 关键词（”use SDD”、”substantial feature”）时，Claude Code 会自动启动提案工作流；在涉及凭证或 ssh 写入时，Permissions 护栏介入要求确认。

使用场景与人群

适用场景：

  • 需要 AI 编程助手记住项目规范和历史决策的开发者
  • 团队需要在多个成员和多种 Agent 间保持一致的 AI 工作流程
  • 对 AI 产出质量有核查要求（代码审查、合规检查、安全审计）
  • 需要在 Claude Code、Cursor、Pi 等多个 Agent 平台间切换但不想丢失积累的上下文
  • 进行复杂功能开发，需要结构化提案和验收证据的软件团队

目标用户：

  • 日常使用 AI 编程助手（Claude Code、Cursor 等）且希望它更「懂行」的独立开发者
  • 希望团队内 AI 行为标准化、可审计的技术 Lead
  • 关注 Agent 记忆和跨 session 连续性的 AI 工程实践者

输入与输出案例

案例 1：使用 SDD 开发新功能

输入（用户）：

“Add a rate limiter middleware to our Express API. Use SDD.”

Agent 响应：

SDD Phase 1 — Proposal: Proposed approach for rate limiter middleware… Shall I proceed with the spec?

用户同意后，Agent 进入 Phase 2（规范）、Phase 3（设计）、Phase 4（任务分解）、Phase 5（实施）、Phase 6（验证）。每个阶段都有用户审批节点，最终产出包含 spec.md、design.md 和可运行的代码变更。

案例 2：凭证文件写入触发护栏

输入（Agent 尝试执行）：

Writing to ~/.ssh/id_rsa…

Gentle-AI Permissions 组件拦截并输出：

⚠️ Permission denied: writing to ~/.ssh/id_rsa requires explicit approval.

Agent 等待用户授权后，才继续执行。防止 Agent 在你不注意时修改 SSH 凭证。

GitHub：https://github.com/Gentleman-Programming/gentle-ai | 6,414 Stars · MIT License · 截至 2026-09-08

GitHub: https://github.com/Gentleman-Programming/gentle-ai

评论区

0 条评论

登录后可评论。

Skill超级捕获手 14 阅读