gentle-shell

让 AI 代理按架构师规范写代码，测试审查全留痕

开源 🏷️定价信息待确认 ✅ 目前可打开编程开发 🍴 复刻 248 🐛 待处理 407 👀 关注 2

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1521

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

gentle-shell 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类编程开发

开发团队Gentleman-Programming

官网地址https://gentle-ai.gentlemanprogramming.com

GitHubhttps://github.com/Gentleman-Programming/gentle-shell

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent-harness,agent-skills,ai-agents,ai-coding,ai-coding-agent,code-review,coding-agents,developer-tools,gentle-ai,llm,mcp,openspec,pi,pi-coding-agent,rdd,sdd,spec-driven-development,subagents,tdd

GitHub 星标★ 1521

上线时间2026-05-10 00:00:00

代码更新2026-11-01

仓库体积69.3 MB

本站数据更新2026-11-02

维护状态活跃

收录时间2026-09-16

浏览次数2

项目介绍

gentle-shell 是一个面向 AI 编码代理的开发框架（harness），目标是把通用大模型变成有资深架构师素养的编程助手。它围绕规范驱动开发（SDD/OpenSpec）组织工作流，让代理先写清需求与设计再动手编码，并通过子代理（subagents）拆分任务、并行推进。项目强调严格的 TDD 证据链，要求每次改动都有可验证的测试支撑，避免代理凭空生成代码。同时内置代码审查护栏（review guardrails），在提交前自动检查质量与风险，还提供技能发现（skill discovery）机制，让代理按需调用可复用的技能模块。整体用 TypeScript 实现，可作为命令行工具接入现有开发流程，适合希望把 AI 编码从玩具级提升到工程级、对流程规范和可审计性有要求的团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-16 · 当前星标 ★ 1521

技术标签

agent-harness agent-skills ai-agents ai-coding ai-coding-agent

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 10 分钟部署方式：命令行工具 4 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Node.js 与 npm 环境（项目以 npm 包 gentle-pi 发布）
一个可用的 Pi 环境（gentle-shell 启动后需要重启 Pi 生效）
独立的 home 目录（gentle-shell 使用自己的 home，不改动已有 Pi 安装）
能够访问 npm 源的网络环境

安装与启动步骤

1准备 Node 环境

gentle-shell 用 TypeScript 实现并以 npm 包 gentle-pi 发布，需先安装 Node.js 与 npm。README 节选未列出具体安装命令。
2首次启动

在某个 home 中第一次启动 gentle-shell 时，会自动执行 provisioning（配套包安装）流程，无需额外操作。
```
gentle-shell
```
3手动重跑初始化

想查看完整安装输出或修复环境时手动重跑：它会在当前 home 安装配套包，并移除与 gentle-pi 冲突的包。
```
gentle-shell setup
```
4重启并同步

先重启 Pi，再执行 sync，让 provision 的配套包在 Pi 中生效。
```
gentle-ai sync
```

关键配置

配置项	必填	说明	示例
`GENTLE_SHELL_NO_AUTO_SETUP`	否	设为 1 可关闭首次启动时自动执行的 setup	`1`

如何确认成功

手动执行 gentle-shell setup 能看到完整安装输出，且没有与 ask_user_question 工具相关的冲突包报错，即说明初始化正常。

常见问题

Q：gentle-shell 会污染我已有的 Pi 安装吗？

A：不会。它使用自己的独立 home，README 明确说明“never touches your pi install”，配套包装在这个 home 内。

Q：gentle-shell setup 到底做了什么？

A：把 gentle-ai 在普通 Pi 中提供的同一批配套包装进当前 home，然后移除与 gentle-pi 自带 ask_user_question 工具冲突的那一个包。

Q：如何关闭首次启动的自动 setup？

A：设置环境变量 GENTLE_SHELL_NO_AUTO_SETUP=1 即可跳过自动 provisioning，之后需要时再手动运行 gentle-shell setup。

Q：gentle-ai sync 什么时候执行？

A：在重启 Pi 之后运行，用于把已 provision 的内容同步到 Pi 环境中。

注意事项

README 节选未给出完整的安装命令，正式安装方式请以官网 gentle-ai.gentlemanprogramming.com 与 docs/readme-reference.md 为准。
gentle-shell 使用独立 home，不会改动你原有的 Pi 安装。
setup 会主动移除与 gentle-pi 自带 ask_user_question 工具冲突的那个包（该项目已知问题），属预期行为。