它是什么
i-have-adhd 是一个面向编码类 AI Agent 的「输出风格」技能包（Skill / Plugin）。它只做一件事：让 Agent 把答案放在最前面，而不是把结论埋在铺垫、背景介绍和结尾寒暄之间。官方描述是「阻止你的编码 Agent 把答案埋起来」，并冠以「ADHD 友好输出」的定位——README 特意补了一句「不需要 ADHD 诊断」，说明命名只是对这种阅读偏好的形象化表达，任何人都可以直接使用。
它针对的是大模型助手的一个普遍毛病：面对一个明确的技术问题，回答往往先复述问题、表达「这是个好问题」、罗列几种可能方向，直到第三段才给出真正可执行的命令或改动位置。对于要快速推进任务的开发者，这种回复的阅读成本常常高于它携带的信息量。i-have-adhd 把「先给动作、后给解释」固化成一套可被 Agent 加载的规则，让输出结构变得可预期、可扫读。项目以 MIT 协议开源，README 提供七种语言版本。
核心功能 / 内容清单
- 动作优先的输出结构：README 用极短的一句话概括核心行为——Action first（先给下一步动作）、Steps numbered（多步骤必须编号）、不写「Hope this helps!」这类无信息量的收尾。这三点实际上定义了回复的骨架：第一行就是可执行的东西。
- Before / After 对照示例：README 用一张双栏表格展示效果差异。Before 是一段典型的铺垫式回答（先称赞问题、再描述认证流程涉及中间件、令牌校验、Cookie 处理，最后才提到升级
jsonwebtoken）；After 则直接给出npm install jsonwebtoken@latest、指明要改src/auth.ts:42，再用三条编号步骤说明操作，并以「Next: 如果测试失败，把第一行报错贴回来」收尾。这个示例同时展示了它想要的「下一步钩子」写法。 - 10 条规则集：规则全文放在
skills/i-have-adhd/SKILL.md。README 中可确认的第一条是「Lead with the next action（先给下一步动作）」，第二条与「多步骤任务要编号」相关。这 10 条构成技能的实际载荷，也是 Agent 加载后真正遵守的内容。 - 面向 Agent 的安装说明：仓库提供
AGENTS.md与INSTALL.md两类文档，前者写给 Agent 读，后者写给人看。README 给出的推荐路径是把一句话安装指令直接粘贴进 CLI 提示词，让 Agent 自行完成安装。 - 多语言 README：除英文外，还提供简体中文、葡萄牙语（巴西）、日语、越南语、韩语、泰语版本，方便非英语用户先理解规则再决定是否安装。
典型使用场景
场景一：让 Agent 直接给出修复方案。 当你已经定位到问题（例如某个函数用了过时的库 API），你想要的是「改哪一行、跑什么命令」，而不是一段关于这段代码如何设计的分析。装上这个技能后，Agent 的回答会收敛成命令 + 文件位置 + 验证步骤；这类问题在终端里逐条执行最顺手，铺垫文字只会拖慢节奏。
场景二：多步骤重构或依赖迁移。 升级依赖、替换废弃 API、跨多个文件改动时，模型天然容易写成大段散文。规则要求多步骤必须编号，于是你会拿到一份可以逐条勾选的清单，而不是需要自己从段落里拆解动作的说明文。After 示例里的「先装包 → 改函数 → 跑测试 → 失败就贴报错」就是这种形态。
场景三：长会话后期防止 Agent 跑偏。 对话轮次变多后，模型倾向于用更长的解释「总结现状」。此时固定的输出风格约束能把它拉回可执行轨道，减少来回追问「所以到底要做什么」的次数。
适合谁用
- 日常用 AI Agent 写代码的开发者：尤其是习惯在终端里跑 Agent、希望回复可以直接复制执行的人。
- 容易被长文本淹没的读者：对信息密度敏感、希望第一眼就看到结论的人；命名里的「ADHD 友好」正是针对这类阅读习惯，但不构成任何医疗声明。
- 维护 Agent 配置与团队规范的人：如果团队希望统一 Agent 的回复风格，这套规则文本可以作为现成的基线，再按需增删。
- 不适合的场景：需要模型展开分析、做方案权衡、写设计文档或教学说明时，这种极度压缩的风格反而会丢掉必要的推理过程。
快速上手
安装有两种路径。其一，把 README 给出的安装指令原样粘贴到你的 CLI 提示词中，让 Agent 按仓库的 AGENTS.md 自行完成安装；其二，按 INSTALL.md 中的说明手动安装。安装完成后，技能会按你所使用 Agent 客户端的技能加载机制生效，也可以在该客户端的技能调用方式下显式引用。
需要说明的是：具体安装目录、支持哪些 Agent 客户端、以及触发方式，README 并未逐条列出，实际步骤请以仓库中的 INSTALL.md、AGENTS.md 与 skills/i-have-adhd/SKILL.md 为准。
注意事项
- 它是输出风格约束，不是能力增强：技能不会让模型更聪明或更准确，只是改变回答的组织方式。基础判断力仍取决于模型本身。
- 可能压缩掉有价值的解释：规则强制「动作优先」，在需要权衡取舍、说明风险或解释设计动机的场合，回答可能过于简短。必要时需要显式要求展开。
- 安装兼容性需自行确认：README 只提供通用安装指令，未列举受支持的客户端；不同 Agent 对 Skill / Plugin 的支持方式不同，以官方文档为准。
- 规则全文与 README 分散在两处：
SKILL.md才是规则的实际内容，README 只做摘要与示例展示；想了解完整 10 条规则应直接查阅该文件。 - 协议：MIT 协议，允许自由使用、修改与再分发，需保留原始版权与许可声明。
- 热度不等于适配：项目关注度高，但是否适合你的工作流取决于你更需要「快答案」还是「完整推理」，建议先看 Before / After 示例再决定。