ayghri/i-have-adhd

Coding Agent 输出风格 Skill：把回答重塑成 ADHD 友好格式——先给动作，再给上下文；多步任务强制编号；每轮结尾必须有一个可执行的下一步；禁止寒暄式开头结尾（“Great question!”/“Hope this helps!“）。15.9k stars，MIT 协议，支持 Claude Code/Codex/Cursor 等多个 harness。

“A skill to stop your coding agent from burying the answer. ADHD-friendly output.”

核心价值

普通回答把答案埋在解释里：先讲上下文，再讲方案，最后才落到”你该做什么”。ADHD 阅读模式反过来：

工作记忆有限：不在屏幕上的内容等于不存在，不能要求”记住 X”
“知道”和”做到”之间有摩擦，摩擦点就是任务卡死的地方
开始是最难的一步：第一个动作必须小、具体、马上能做
模糊的时间估计（“一会儿”）不起作用，必须给具体分钟数
进度必须可见，被埋没的进展不会带来完成感

10 条规则

首句是动作，不是上下文（命令/路径/代码片段放最前面）
多步任务必须编号，每步一个有界动作
结尾给一个 2 分钟内能做的具体下一步
抑制话题分支：先完成手头的事，第二个问题单独提出
每轮重述当前状态（第几步/共几步），配合 Task 工具而非纯文本复述
给具体时间估计（“15 分钟”而非”一会儿”）
让完成的工作可见，不要把成果埋进总结里
报错语气客观陈述原因和修复方式，禁止”Uh oh”式开场
列表最多 5 项，超出则拆成”现在做/以后做”
禁止开场白、禁止总结复述、禁止”Let me know if you need anything else”式收尾

破例场景

用户要求”解释”/“walk me through” 时可展开详述；有破坏性操作（rm -rf、force push、schema 迁移）时安全性优先于简洁，必须先确认；连续三轮”还是不行”时停止硬改代码，转而质疑假设并提一个诊断性问题；请求本身有歧义时，一个简短澄清问题优于猜测重写。

安装

# Claude Code
claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd
# 然后输入 /i-have-adhd 激活；"stop adhd mode" 关闭
 
# Codex
codex plugin marketplace add ayghri/i-have-adhd --ref main
codex plugin add i-have-adhd@i-have-adhd
# 然后输入 $i-have-adhd

其他 Agent（Cursor/Gemini 等）安装方式见仓库 INSTALL.md。

常驻模式

disable-model-invocation: true，默认不由模型自主触发，需显式 /i-have-adhd 调用一次后在本次 session 持续生效。

如果想让规则在每个 session 启动时自动注入（不用每次手动 /i-have-adhd），执行：

touch ~/.claude/.i-have-adhd-always

原理：仓库自带 hooks/always-on.sh 挂在 SessionStart 事件（matcher: startup|resume|clear|compact），检测该 flag 文件存在时，剥离 SKILL.md 的 YAML frontmatter 后把规则正文注入 session 上下文；flag 不存在则直接 exit 0，不影响正常启动。

结构

skills/i-have-adhd/SKILL.md   # 规则正文（10 条规则 + 破例场景 + 发送前检查清单）
hooks/always-on.sh            # SessionStart hook，读 flag 文件决定是否常驻注入
hooks/hooks.json              # hook 注册配置
evals/                        # 规则效果评测集（cases.jsonl + rubric）
scripts/run_evals.py          # 评测执行脚本

SKILL.md 末尾有”发送前检查清单”：删掉宣布动作的第一句、删掉问”还有什么需要帮助的吗”的最后一句、删掉任何”顺便”式旁白、删掉不携带信息量的模糊副词（“可能”/“或许”）、替换比喻性短语为直白动作描述。

关联页面

mattpocock-skills — 同类”反 vibe coding”工程纪律 Skill，侧重开发流程而非输出格式
agent-skill-self-update — Claude Code Plugin 自动更新机制，本项目采用同一分发方式

zhaoweiguo 的知识库

目录