用 Claude Code 写代码的人,多半都干过同一件蠢事:把「提交信息用中文、别加 AI 署名、改完必须跑测试」这几条规矩,一遍遍贴进每个新项目。换台电脑要重贴,换个工具还要再贴一遍,写成什么样全凭当天心情。
gentle-ai 想一次解决这件事。它不造新的 AI 助手,而是给你已经在用的那个「装规矩」:把记忆、工作流、技能库、代码审查这一套,一次写进 18 种不同编码助手的配置文件里。项目 8,987 星,MIT 许可,Go 写成,最近一次提交就在今天。
我把它装进一个隔离的空账户里跑了一遍。结论先说:它确实一次配好了,代价是往你电脑里塞进近一千二百个文件,还把一份用不上的 43MB 仓库副本一起带了进来。
它到底替你做了什么
「支持 18 个助手」这句宣传,我先去代码里数了一遍。决定「选哪个助手、走哪套适配」的那个文件里,正好 18 个分支,对应的都是主流编码助手,从 Claude Code、Cursor 到 Codex、OpenCode,再到 Gemini CLI 这一档。
通俗讲,它是一把万能转换插头:你手里是哪个牌子的充电器,它就换出哪个牌子的插孔,插座本身不用动。
装的时候你不用一件件挑,它按一个叫「预设」的清单一次性铺开:
| 装了什么 | 干的什么活 | 落到你电脑的哪儿 |
|---|---|---|
| 人设与规则 | 一段几万字的开发规矩,写进助手的全局指令文件 | ~/.claude/CLAUDE.md |
| 技能库 | 8 个可复用技能,比如「一个提交只做一件事」 | ~/.claude/skills/ |
| 记忆 | 一个叫 Engram 的独立程序,跨会话记住项目决策 | ~/.local/bin/engram |
| 提交前审查 | 一个叫 GGA 的脚本,commit 前让 AI 看一眼改动 | ~/.local/bin/gga |
| 审查引擎 | 项目自己的一套代码审查流程,可开关 | 写进助手的钩子系统 |
我装了一遍,三个数字值得记
装的过程很顺。我把「家目录」指向一个空文件夹,等于给它在沙漠里盖了间房,装完对真机零影响。全程两百多秒,最后一步打印「25 项自检通过,0 失败」。
但清点成果时,有三个数字值得记下来。
第一个:1,188 个文件。 这是它在你账户下新建的文件总数,其中 1,171 个都在 .claude 这一个目录里。真正有内容的是几百个,剩下的是那份记忆程序仓库的完整副本。
第二个:43MB。 这是 .claude 目录里那块「插件市场」缓存的大小,其中 15MB 是版本历史。为了让你多一个记忆功能,它在配置目录里留了一整个项目的源码。对 20G 硬盘不算什么,但对「只想配个规矩」的人来说,这个体积来得莫名其妙。
第三个:8 个技能,索引里只登记 7 个。 装完的技能目录里有 8 份说明书,但项目自带的技能索引只列出 7 条。少掉的不是出错,是它主动跳过了一个共享文件夹,和「管理索引的那个技能」本身。这个逻辑说得通,只是你按「9 个」去数会对不上。
32 万行测试守着 20 万行实现
对一个「配置文件生成器」来说,这个仓库的体量是反常的。
去掉测试,它的 Go 代码有 19.7 万行;测试代码 32.5 万行,比实现还多 65%,相当于每写 1 行逻辑就有 1.65 行测试盯着。测试函数 7,602 个,分在 95 个包里。我随手跑了其中四组(代理适配、技能索引、数据模型、遥测),二十多个子包全部通过,最慢的一组用了 7 秒。
这个比例意味着什么?意味着作者把「配置写错一个字符就可能弄坏别人电脑」当成了头号风险。它也解释了另一个数字:仓库里有 60 份 JSON 格式的接口契约,合计近 1.1 万行,专门规定审查流程的每一步该传什么、返回什么。这是「先定合同再写代码」的写法。
我自己也跑了一遍它最核心的审查功能。拿一个假的 Git 仓库,改一行 Go 代码,它判断风险为「中」,要求跑 1 项检查;改成只动 Markdown 文档,它直接判定低风险、无需审查。这个分寸是对的,不是一律拦下,也不是一律放行。
三个坑,写在这儿免得你自己踩
坑一:遥测默认开着。 装完我第一件事就是查状态,显示「已启用(默认)」,还带一个安装编号。安装日志写明了发送什么:版本号、操作系统、装了哪些助手、各类计数;某些集成下还包括用的是什么模型、消耗多少 token、耗时、错误类别。它给了关闭命令,也没藏着掖着,但默认开着这件事,介意的人得自己动手。
坑二:仓库根目录那份基准成绩,是事故留下的。 仓库里有个文件记着自动化测试的成绩,打开一看只有 1 条记录,状态还是「失败」,失败原因写着「不是一个 Git 仓库」。更奇怪的是里面记的可执行文件路径,指向一个临时目录。
我去翻了项目自己的复盘文档,找到了答案:这份文件是从开发机的工作目录里被顺手 git add 扫进去的,作者把它列进「工具层面的意外」。真正完整的那份在另一个目录,64 条记录全部完成。这条不影响你使用,但它说明一件事:连这个项目自己,也会被「顺手一把梭」坑到。
坑三:被拦下时,近六成不告诉你下一步。 仓库自带一份衡量「AI 助手操作体验」的基准测试,64 个场景里共有 69 次拦截。其中 29 次给出了可直接复制的下一步命令,另外 39 次只说「不行」,不告诉你该敲什么。项目自己的说法是,这 39 次里有些确实给不出命令(比如「你得自己去改代码」),属设计如此,但比例仍然偏高。
谁该装,谁别急
和它同一赛道的东西大致三类。一类是各家助手自己的规矩文件,最省事,但换工具就得重写;一类是技能包合集,管「装什么能力」不管「写代码的规矩」;第三类就是它这种总配置器,一次覆盖多个助手。
如果你同时在用两种以上编码助手,或者经常换机器,它的价值是实的:一次配置,十八个工具通用。如果你只用其中一家、且已经有自己的规矩文件,装它是拿 43MB 磁盘和一整套新概念去换一点便利,不划算。
还有一点要有心理准备:它不是一个装完就忘的工具。审查流程会插进你每次提交的动作里,第一周大概率会被它拦几次。要不要留,取决于你愿不愿意为「提交前有个机器看一眼」多花那几十秒。
我的判断是:放进观察清单,用它解决「多工具配置漂移」这个真问题;装之前先把遥测关掉,并且别指望它小。它是个认真过头的工程品,不是一片创可贴。
关注 AI商业快讯,每天一篇 AI 热点深度解读。