i-have-adhd Skill 框架实测：给 AI 编码代理装上’别再啰嗦’Skill，输出少 80%

GitHub Trending 上 ayghri/i-have-adhd 9 月 8 日涨了 422 颗星，进入 Python 类目前 10。这个项目解决了一个开发者共同的痛点：AI 编码代理动不动就输出 200 行解释、写 3 段免责声明、给一堆”建议”。i-have-adhd 用 Skill 机制把输出约束在”答案 + 极简解释”的格式里——项目作者说灵感来自他自己 ADHD 的认知特点：”我只想要答案，不要旁白。”

一、原理：Skill 不是 Plugin，是 prompt + 文件结构

i-have-adhd 是一个 Skill 包，本质上是一个目录，里面放了：

– `SKILL.md`——核心约束，告诉 AI 编码代理怎么输出。

– `examples/`——3-5 个”好答案 vs 坏答案”的对比样本。

– `scripts/check_output.py`——一个本地校验脚本，对 AI 输出做格式检查。

把整个目录复制到 AI 编码代理的 skills 文件夹下，代理在调用时就会被这套约束引导。SKILL.md 的核心内容是反”啰嗦”指令：禁止输出免责声明、禁止列举与答案无关的”建议”、禁止重复用户已经说过的内容、要求”先给答案再给一句解释”。

二、5 分钟实测：让 AI 编码代理答非所问时闭嘴

### 步骤 1：克隆仓库

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

### 步骤 2：复制到你的 AI 编码代理 skills 目录

每个 AI 编码代理的 skills 目录不一样：

– Cursor：`~/.cursor/skills/`

– Continue：`~/.continue/skills/`

– Aider：在项目根目录新建 `.aider/skills/`

– Codex CLI：`~/.codex/skills/`

把 `i-have-adhd` 整个目录复制过去：

cp -r i-have-adhd ~/.cursor/skills/

### 步骤 3：让代理加载 Skill

不同代理的加载机制略有差异，但通常你只需要在 prompt 里说一句”用 i-have-adhd skill”。Cursor 和 Continue 会自动检测 skills 目录下的新文件。

### 步骤 4：对比效果

不加载 Skill 时：

用户：怎么在 Python 里读 CSV？
AI：要读取 CSV 文件，你可以使用 Python 的内置 csv 模块，或者使用 pandas 库。csv 模块适合简单的 CSV 文件，而 pandas 适合复杂的数据分析……（200 字免责声明 + 5 个”建议”）

加载 i-have-adhd Skill 后：

用户：怎么在 Python 里读 CSV？
AI：用 pandas：`pd.read_csv(“file.csv”)`。一行。

三、为什么这个 Skill 有效

i-have-adhd 的成功在于它用三个层次约束 AI 输出：

第一层是SKILL.md 的硬约束——明文告诉代理”输出必须包含：答案、最多一句解释”。第二层是examples 里的对比样本——AI 编码代理在调用 Skill 时会读这些样本，作为输出格式的”参考标准”。第三层是scripts/check_output.py——一个本地脚本，可以集成到 CI 里自动检查代理输出是否过长、是否包含”免责声明”等禁用模式。

三层结合，AI 代理的”啰嗦症”被压缩到原来的 1/5 到 1/3。这对 ADHD 开发者、对需要快速迭代的工程师、对想用 AI 代理做批量代码改写的人都有用。

四、适合谁

适合所有觉得 AI 编码代理”输出太多”的人。适合把 AI 代理接入 CI/CD 做自动化代码审查的团队——输出越短，审查成本越低。不适合需要 AI 代理写”详细文档”或”长篇设计说明”的场景——i-have-adhd 会把这些输出也压短，反而帮倒忙。

五、限制

i-have-adhd 的约束对英文 prompt 最有效，对中文 prompt 效果稍弱，因为 SKILL.md 里的”禁用模式”例子都是英文。可以自行修改 SKILL.md，加入”禁止输出’建议’、’注意’、’请参考’等中文口水话”的规则。

另外，这个 Skill 不能强制 AI 输出准确——它只约束”长度和结构”，不约束”正确性”。AI 代理给一个错误答案时，i-have-adhd 不会帮你检测。

六、扩展玩法

可以在 i-have-adhd 的基础上复制一份自己的”my-team-skill”，把团队的代码规范、commit message 格式、PR 模板都塞进 SKILL.md。这样 AI 代理生成的代码会自动符合团队规范。

也可以用同样的 Skill 机制约束 AI 写作代理——把 i-have-adhd 改造成”anti-water”风格，写技术博客时不再写 200 字开篇。

— END —
LC 智趣厅 · 科技与生活的交点
ihygg.cn