AI工具 开源项目

34590星的反ADHD技能：别让AI把答案埋在第十段，这个指令直接治好

GitHub 34590星的 i-have-adhd 项目深度拆解：10条规则让 Coding Agent 的输出从「长篇大论」变成「一针见血」。附 Before/After 对比、Claude Code 内置 Concise 模式差异分析、Cursor/国内 Agent 适配方案。

你问 AI 一个简单问题，它先铺垫三段背景知识，再分析五种可能方案，最后在第八段才给出你要的命令。

这不只是 ADHD 患者的困扰——所有开发者都被这种"废话连篇"折磨过。

GitHub 上有个项目专门治这个：i-have-adhd，34590 星，2027 fork。它是一个给 Coding Agent 装的 Skill，通过 10 条规则，让 AI 输出变成"直接能用"的格式。

它是什么

一句话定位：给 Claude Code、Cursor 等 Coding Agent 装的"输出格式约束器"。

不是让 AI 变短，而是让它变结构化+可行动。区别很大——短但没重点的回复同样废，有结构的回复哪怕长一点也能快速定位。

支持的 Agent 很广：Claude Code（原生 plugin）、Cursor（.cursor/rules）、Codex、OpenCode、Gemini，甚至 Kimi 和 Qwen 都有适配文件。

10 条规则拆解

我从 SKILL.md 原文逐条读完，挑 4 条最实用的展开讲，其余简要带过。

规则 1：Lead with the next action（第一行就是动作）

Before：

Great question! Let me think about this. Your auth flow has a few moving pieces…

After：

Run npm install jsonwebtoken@latest, then edit src/auth.ts:42.

核心逻辑：如果答案是命令、路径或代码片段，它必须是第一行。上下文放在后面，甚至可以不放。

SKILL.md 原文写得很清楚：“The first line is something the reader can do. Not context. Not a plan. The action.”

规则 2：Number multi-step tasks（多步骤必须编号）

Before：

First open the file, find the function, swap it out, then run the tests.

After：

  1. Open src/auth.ts
  2. Replace verifyToken (lines 42–58) with the snippet below
  3. Run npm test -- auth.spec.ts

每步一个动作，不含"然后"。用最少步骤完成，能合并的合并——“短路径做完胜过长路径放弃”。

规则 3：End with one concrete next step（结尾给下一步）

Before：

Hope that helps. Let me know if you want to dig deeper.

After：

Next: run npm test and paste the first failing line.

结尾永远留一个 2 分钟内能做的下一步。“Open the file” 都算。不能是"有问题随时问"——那是废话。

规则 10：No preamble. No recap. No closers（三不原则）

禁止的开头：Great question / Let me… / Sure! / Looking at your…

禁止的结尾：Let me know if you need anything else / Hope this helps / Feel free to ask

禁止的中间：By the way…（岔开话题的旁白）

SKILL.md 有一条 Pre-send check：发之前删掉第一句（如果你在宣布"我要做什么"）、删掉最后一句（如果你在问"还需要什么"）、删掉所有旁白。然后验证：只读第一行和最后一行，能不能知道该做什么和发生了什么？

其余 6 条简要概括：

规则一句话
4. Suppress tangents发现第二个问题，先完成第一个再提
5. Restate state every turn每轮重申"我们在第3步/共5步"
6. Specific time estimates给具体分钟数，不说"一会儿"
7. Make wins visible让进展可见，不要埋没成果
8. Matter-of-fact errors出错直说原因和修复，不铺垫不道歉
9. Cap lists at 5列表最多 5 项，超出分"现在做"和"以后做"

实测：同一个问题，Before vs After

我在 Claude Code 里测试了一个真实场景：问"我的 React 组件渲染了两次，怎么回事？"

没装 i-have-adhd 时的回复：

Great question! Double rendering in React is a common issue that many developers encounter, especially with React 18’s Strict Mode. Let me walk you through what’s happening. Your component might be re-rendering due to several reasons: state changes, parent re-renders, context changes, or the useEffect dependency array. Looking at your code, I can see that…

八段之后才给出排查步骤。

装了之后的回复：

  1. 打开 src/components/UserList.tsx:23
  2. 在 useEffect 里加 console.log('render') 确认触发次数
  3. 检查父组件是否在 onClick 里 setState 导致子组件重渲染

Next: 加完 log 后跑 npm start，贴控制台输出。

差距一目了然。前者你读完需要 30 秒，还得自己提炼行动项；后者你读完 5 秒就能开始操作。

SKILL.md 里的心理学

这个项目的 Credits 写着：基于 The Adult ADHD Tool Kit（J. Russell Ramsay 和 Anthony L. Rostain 合著）改编。

SKILL.md 开头有一段"Why ADHD changes about reading"，列了 5 个事实驱动所有规则：

  1. 工作记忆很小——屏幕外的东西会被遗忘，别让读者"记住 X"
  2. 知道答案不等于做完——“懂了"和"做了"之间的摩擦是工作死亡的地方
  3. 开始是最难的——第一步必须明显、小、现在就能做
  4. 时间估算感觉一样——“一点功夫"和"几小时"在 ADHD 大脑里注册相同，模糊估算无效
  5. 多巴胺稀缺——可见的进展很重要，被埋没的成就不会被感知

这不是拍脑袋写的规则，是有临床依据的输出设计。

什么时候可以打破规则

SKILL.md 还列了 6 种可以覆盖默认规则的场景：

  • 用户明确要求"解释"或"带我过一遍”——可以展开讲，但仍不加寒暄
  • 危险操作（rm -rf、force push、删表）——安全优先于简洁
  • 连续三轮调试都没修好——停下来，问一个诊断性问题
  • 请求有真正的歧义——一个短澄清问题好过猜测后重写
  • 规则和任务本身冲突——任务优先，格式保持
  • 规则和 Agent 框架冲突——系统提示优先级更高

安装方式

一行命令：

1

Install the i-have-adhd skill/plugin from https://github.com/ayghri/i-have-adhd, refer to the repo's AGENTS.md for instructions.

Claude Code 用户也可以直接 plugin install。Cursor 用户把规则文件放到 .cursor/rules 目录即可。

和 Claude Code 内置 Concise 模式有什么区别

Claude Code v2.1.237（2026-08-20）内置了 “Concise” output style，不少人问：有了内置的还需要这个吗？

答案是需要，因为两者管的东西不一样：

维度Claude Code Concisei-have-adhd
长度控制✅ 只管短✅ 管结构
动作前置❌✅ 第一行必须是动作
步骤编号❌✅ 多步骤必须编号
状态重申❌✅ 每轮重申当前进度
时间估算❌✅ 给具体分钟数
下一步提示❌✅ 结尾必须有下一步

Concise 模式解决的是"太长不看”，i-have-adhd 解决的是"看完不知道干嘛"。两个可以叠加使用——先用 Concise 控制长度，再用 i-have-adhd 控制结构。

国内 Agent 怎么用

通义灵码、豆包 MarsCode 等国内 Coding Agent 也支持自定义规则/提示词。核心思路一样：把 10 条规则翻译成中文，写进 Agent 的系统提示或规则文件。

不依赖 Skill 也能用——直接在对话开头贴这段 prompt：

1
2
3
4
5
6

从现在起，你的每条回复遵守以下规则：
1. 第一行直接给可执行的动作（命令/代码/路径）
2. 多步骤任务用编号列表，每步一个动作
3. 结尾留一个2分钟内能做的下一步
4. 不要开头寒暄，不要结尾总结，不要"Hope this helps"
5. 列表最多5项

效果不差，但比原版少了状态重申、时间估算、可见进展这几条——这些需要 Agent 在多轮对话中持续遵守，靠单次 prompt 不够稳定。

为什么这个项目火了

HN 526 分、362 条评论。社区反馈的一个共识是：这不是 ADHD 专属需求，而是所有开发者的需求。

AI 的"废话病"本质上是两个问题：输出太长（Concise 能治），输出没有行动力（i-have-adhd 能治）。前者是格式问题，后者是结构问题。大部分开发者真正被折磨的是后者——你看完一段 AI 回复，知道它说了什么，但不知道自己该做什么。

这个项目的价值就在这里：它不是让 AI 变安静，而是让 AI 变有用。

项目地址：github.com/ayghri/i-have-adhd （MIT 协议，⭐34590）

行动建议：现在就装上试试，或者把上面那段 prompt 贴进你的 Agent 规则文件，5 分钟见效。

— varkm