i-have-adhd 让 Coding Agent 别把答案埋进废话里

帅次.

625人浏览 · 2026-08-15 08:00:00

帅次. · 2026-08-15 08:00:00 发布

文章目录

先说结论：它改的不是模型，是输出形状
痛点：答案被埋在「希望这能帮到你」里
10 条规则在约束什么
工程细节：为什么是 user-invoked Skill
Cursor 安装与验证（复制即用）
和 ponytail、taste-skill 怎么选
局限、评测与定制
结语
相关推荐

先说结论：它改的不是模型，是输出形状

Cursor、Claude Code 写代码，模型多半「懂」，回复却像小作文：先铺垫、再顺带一提、最后「希望这能帮到你」。真要执行的命令和路径，往往埋在第三段。

i-have-adhd 做的一件事很单纯：给 Agent 一套会话级输出规范——行动优先、多步编号、结尾只留一个可做的下一步。名字里的 ADHD 指的是阅读与执行特征（工作记忆小、启动难、讨厌废话），不是要求用户确诊。

仓库 2026 年 5 月上线，Star 涨得很快——「能干活但太啰嗦」已是普遍痛点。这和换更大模型不是一条路：Skill 层塑形，换模型也不保证少废话。

痛点：答案被埋在「希望这能帮到你」里

官方 README 用升级 jsonwebtoken 举例，对比很直观：

之前（典型 Agent 腔）：

问得好！让我想一想。你的身份验证流程包含几个环节：中间件、令牌验证和 Cookie 处理。查看 src/auth.ts 后，verifyToken 函数（大约第 42–58 行）似乎使用了旧版 API……希望这能帮到你！如果你想进一步研究，请告诉我。

之后（i-have-adhd 塑形后）：

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

打开 src/auth.ts

将 verifyToken（第 42–58 行）替换为下面片段

运行 npm test -- auth.spec.ts

下一步：如果有测试失败，粘贴第一行报错。

差别不在技术深度，在信息顺序：第一行能动手，中间是 bounded steps，结尾是 2 分钟内能做的 next action。天天和 Agent 结对的人，少滚一次屏就少丢一次上下文。

10 条规则在约束什么

完整条文在 skills/i-have-adhd/SKILL.md。下面按「坏 / 好」压缩解读，认知依据写在 SKILL 里：工作记忆小、知道≠做到、启动最难、模糊时间感、需要可见进展。

规则 1：先说下一步行动

坏：「我们先梳理一下，你的 auth 有几个模块……」
好：「运行 npm install jsonwebtoken，改 src/auth.ts:42。」
要点： 答案若是命令、路径、片段，必须顶格出现。

规则 2：多步骤必须编号

坏：「打开文件，找到函数，换掉，再跑测试。」
好： 1 打开 → 2 替换指定行 → 3 跑指定测试文件。
要点： 一步一个动作，能合并的 trivial 步骤要合并，短路径做完比完整路径放弃强。

规则 3：结尾留一个具体下一步

坏：「有需要再叫我。」
好：「下一步：跑 npm test，把第一行失败贴回来。」
要点： 未完成事项只留一条，且 2 分钟内能启动。

规则 4：压制离题

坏：修完 auth 又顺带 README、依赖、目录结构……
好：「修完了。另外依赖也过期，要单独处理吗？」
要点： 当前问题先闭环；新问题变成可选的第二问。

规则 5：每轮重述状态（多步时尤其重要）

跨多轮对话时，读者记不住「做到第几步了」。

坏：「好了，继续吗？」
好：「第 3/5 步完成：schema 已改。下一步：跑回填脚本，要执行吗？」
要点： 有 task/plan 工具时，用清单代替长篇复述。

规则 6：时间估计要具体

坏：「要花一点时间。」
好：「测试已覆盖的话约 15 分钟；没有测试可能要一下午。」

规则 7：让成果可见

坏：「我对 auth 做了一些调整……」
好：「魔法链接登录已可用。npm run dev，打开 /login 试。」

规则 8：错误陈述要干脆

坏：「呃，测试好像挂了，似乎有问题……」
好：「auth.spec.ts:42 期望 200 得 401。缺 Authorization 头。请求里加 Bearer ${token}。」

规则 9：列表不超过 5 项

超过就拆成「现在做」和「稍后做」，或「必须 / 可选」。

规则 10：禁止开场、回顾、客套收尾

禁用开头：「Great question」「让我……」「Sure!」
禁用结尾：「Hope this helps」「随时问我」。

发之前还有 pre-send check：删掉宣布即将做事的第一句、问「还有别的吗」的最后一句、所有「顺便」侧栏。

例外（SKILL 写明）： 用户要求「详细解释」时可写长文，但仍无客套；破坏性操作要先确认；连续三轮修失败要停代码迭代、点名可疑假设。

工程细节：为什么是 user-invoked Skill

SKILL.md frontmatter 关键字段：

name: i-have-adhd
description: 'Shape output for a reader with ADHD: lead with the next action...'
disable-model-invocation: true

disable-model-invocation: true 表示 user-invoked：description 不会每轮占 Agent 上下文（context load 为 0），只有你输入 /i-have-adhd 或等价触发时规则才加载。这和 model-invoked 的 Skill（如生态里的 find-skills）相反——后者靠 description 让 Agent 自动发现，但要付常驻 token。

激活逻辑（INSTALL.md）：

默认不生效——Claude Code / Codex 等会尊重上述开关，没 invoke 就不塑形。
显式开启——/i-have-adhd（Claude Code）或 $i-have-adhd（Codex）；整会话保持，换话题也不自动过期。
显式关闭——stop adhd mode 或 normal mode，Agent 一行确认后恢复默认文风。
Always-on 可选——把 10 条规则贴进 User Rules / AGENTS.md（INSTALL 有完整片段）。

这和 Matt Pocock writing-for-agents 里的分工一致：只有需要人主动切换的「输出模式」，适合 user-invoked；不必让 Agent 自己猜什么时候该少废话。

Cursor 安装与验证（复制即用）

本文命令已在 macOS + Cursor + Skills CLI 环境验证（2026-08-15）。

一键安装（仅 Cursor）：

npx skills add ayghri/i-have-adhd -a cursor -y

所有项目可用：

npx skills add ayghri/i-have-adhd -g -y

确认安装：

npx skills list

应看到 i-have-adhd，来源 ayghri/i-have-adhd。

手动拷贝（无 CLI 时）：

git clone https://github.com/ayghri/i-have-adhd
mkdir -p ~/.cursor/skills
cp -R i-have-adhd/skills/i-have-adhd ~/.cursor/skills/

使用：

新开 Agent 会话（Skill 在会话启动时索引）。
输入 /i-have-adhd。
之后回复应按 10 条规则塑形；说 stop adhd mode 关闭。

更新 / 卸载：

npx skills update i-have-adhd
npx skills remove i-have-adhd

装完仍啰嗦？ 开新会话；仍漂移就 Fork 仓库改 skills/i-have-adhd/SKILL.md 收紧措辞。

和 ponytail、taste-skill 怎么选

Skill / 仓库	核心目标	典型场景
i-have-adhd	输出可执行、少废话、多轮状态清晰	日常结对编程、讨厌长回复
ponytail	像最懒的高级工程师，少写多余代码	控变更范围、反过度工程
taste-skill	输出品味与风格统一	文档、UI 文案、对外材料
writing-for-agents	教你怎么写 Skill 文档	自建 Skill、治理 AGENTS.md
addyosmani/agent-skills	工程实践 Skill 合集	查模板、抄生产级结构

可以叠用，但要注意 context：i-have-adhd 管形状，ponytail 管少写代码，别指望一个 Skill 解决所有问题。

局限、评测与定制

局限：

非 always-on 时必须记得 /i-have-adhd；认知负荷在人这边（和 writing-for-agents 说的 cognitive load 同构）。
塑形不保证技术正确；SKILL 也不替代测试与 Code Review。
医疗边界：致谢里参考 The Adult ADHD Tool Kit，但产品是 LLM 回应格式，不是治疗或诊断建议。

评测： 仓库带 evals/，rubric 权重示例：Correctness 35%、Autonomy 25%、Actionability 20%、Safety 10%、Concision 10%。说明作者用同一套量表对比「塑形前后」，而不只靠体感。

定制：

# Fork 后替换上游插件（Claude Code 示例）
claude plugin uninstall i-have-adhd
claude plugin marketplace add <your-username>/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

改 skills/i-have-adhd/SKILL.md 即可调规则力度（例如列表上限从 5 改成 3）。