GitHub 热榜第一的 i-have-adhd：10 条规则让 AI 少说废话、直接给解法

这周打开 GitHub Trending，第一名又是个熟面孔——i-have-adhd。

说它熟，是因为这个项目从 7 月下旬开始就一直在热榜上挂着，中间基本没下来过。9 月 10 号、11 号那两天直接冲到 Python 日榜第一，一天涨三四千个 Star。我写稿前又去看了一眼，已经 4.3 万 Star 了。

按理说这么火的开源项目，应该藏着不少硬核东西。但点进仓库一看，里面没有模型，也没有框架，核心就是一个 Markdown 文件，写了 10 条规则。

我研究了两天，这篇给大家拆解一下。

先说这个名字

i-have-adhd，直译过来是“我有 ADHD（注意力缺陷多动障碍）”。光看名字，容易把它当成健康类项目，其实跟看病没什么关系。

作者在 README 里写得很直白：ADHD-friendly outputs. No ADHD diagnosis needed! 意思是输出对 ADHD 人群友好，但你不需要任何诊断。

项目的规则参考了一本叫《The Adult ADHD Tool Kit》的书。作者把书里“帮人减少信息负担、方便立刻行动”的思路，反过来用在了 AI 身上。

说白了，这就是一套给 AI 立的说话规矩，谁都能装，装了也不代表你本人有任何问题，只是不想再看 AI 绕弯子了。

它解决的是什么问题

用 AI 写代码时间长了，大家多半都遇到过同一个烦恼：AI 的回复废话太多，真正有用的可能就藏在里面一小部分。

比如你问一个报错怎么修，它先夸你“这个问题问得好”，然后从中间件讲到 Token 验证再讲到 Cookie，背景分析了一大段，最后才提一嘴 src/auth.ts 里有个函数可能要改。结尾还要贴心地补一句，建议你检查一下其他依赖，Hope this helps。

项目 README 里放了一组前后对比，我看完觉得光这个对比就基本能说明问题了：

装上之前，AI 的回答就是上面那种：五句话里前两句是客套，结尾两句是“贴心提示”，真正要干的活埋在中间，你得自己找。

装上之后，同样的问题，回答变成这样：

运行 npm install jsonwebtoken@latest，然后编辑 src/auth.ts 第 42 行。

1. 打开 src/auth.ts
2. 把 verifyToken 函数（42 到 58 行）替换成下面这段
3. 跑 npm test -- auth.spec.ts
   下一步：如果有测试挂了，把第一行报错贴过来。

第一句话就是要干什么，下面步骤编着号，最后还告诉你接下来做什么。两种回答放在一起，差别挺直观的。

大多数时候我们问 AI 问题，并不是要跟它从头学习，而是需要它条理清晰地给出解决办法。这个 Skill 的目的就是干掉废话，单刀直入告诉你详细的解决步骤。

10 条规则，挑几条说说

完整的 10 条规则在仓库的 SKILL.md 里，我不一条条抄了，挑几条我觉得比较实用的说。

第一条，先说下一步行动。 AI 默认的回答习惯是先铺垫再给结论，因为它学的大部分人写文章就是这个路子。但干活的时候没人想先看铺垫，这条规则就是把顺序反过来：要运行什么命令、改哪个文件，第一句就告诉你。

第五条，每轮对话都重述当前状态。 调试的时候步骤一多，中间被打断一次，回来经常想不起来干到哪了。装了它以后，AI 每轮都会说一句类似“5 步里的第 3 步已完成，依赖装好了，配置也更新了”，不用往回翻聊天记录。

第六条，预估时间要说具体的。 比如“三分钟”，而不是“一会儿”。说实话，“一会儿”这个词确实没什么信息量。

第十条，不写开场白，不写回顾，不写结束语。 “好的，我来帮你看看”“总结一下”“希望对你有帮助”，这三类话整个被禁掉了。

剩下的几条也都不花哨：多步骤任务必须编号、列表最多 5 项、跑题的内容等当前问题解决完再提、报错了就事论事。

另外这些规则不是死的。文档里写了例外情况：你主动要求详细解释的时候，它可以展开讲；要执行删库、强推这种破坏性操作之前，它必须先跟你确认；同一个问题连续三次修不好，它会停下来，告诉你可能是哪个假设搞错了。

安装和用起来

仓库里没有要编译的代码，它本身就是一份写好的提示词，通过各家工具的技能机制装进去。

我自己是顺手在 Kimi Code 里装的，几下就完成了：开一个会话，输入 /plugin-builder，把仓库地址 https://github.com/ayghri/i-have-adhd 粘进去，发送后 Kimi 自动就把这个打包成插件了。

想用的时候输入 /skill:i-have-adhd 就能激活。

我们来试试效果，拿一个问题演示：“如何解决数据库主从同步不一致”。

先看看不使用 i-have-adhd 时，Kimi 是怎么回复的：

给了长篇大论，截图没全，大概需要五张截图才放得下。定位原因、常见问题分类、修复场景、如何预防复发，全都铺开了。如果我是想学习这方面知识，这个回答很不错，像一篇知识点文章。但如果我只想快速拿到解决办法，这个回答 80% 是废话。

再来看看使用 i-have-adhd 后，Kimi 是怎么回复的：

给出的回答都用不了两张截图。看结果不用多说，简单明确，就是告诉你这个问题怎么解决，全是解决方法，没有那些“贴心话”。

这里只是简单用 Kimi 演示一下，其他用 Qwen Code、GitHub Copilot 的朋友也有现成的装法。官方的中文安装文档写得很全，Copilot 那边一行命令：

npx skills add ayghri/i-have-adhd -a github-copilot

至于 Claude Code 和 Codex，官方文档同样给了对应的装法，走各自的插件市场就行，这里不展开了。基本你手头用什么工具，翻一下仓库里的安装页都能找到对应段落，连更新和卸载都写好了。

激活以后，这个会话里的所有回复都会按那 10 条规则来。想恢复正常风格，直接说一句 stop adhd mode 或者 normal mode 就行。想每次都自动生效，文档里也有办法，这里就不多写了。

最后说两句

指望它让 AI 变聪明是不可能的，它没动模型，改的只是回答的顺序和详略。原来答不上来的问题，装了它照样答不上来。

但是对于 AI 回答的内容，它做了约束，能帮我们过滤掉很多不必要的信息，直接看结论或者解决办法。装上这个 Skill 后，AI 每次回答都更有条理，这一点对大部分人来说确实有帮助。

或许正是这个原因，让一个简单的 Markdown 文件类项目火到了这个程度。类似这种开源项目的后续拆解，云栈社区也会持续跟进。

开源地址

https://github.com/ayghri/i-have-adhd