i-have-adhd 怎么安装:让 Codex 和 Claude Code 先给行动再解释

介绍 i-have-adhd 输出风格插件的工作方式,以及在 Codex、Claude Code 和其他 Agent 中安装、启用、更新与自定义的方法。

当 AI 编程助手给出一大段背景说明,却把真正要执行的命令藏在最后,问题通常不在模型能力,而在输出结构。i-have-adhd 是一个面向编码 Agent 的输出风格技能:要求助手先给下一步行动,再补充必要解释,并用编号步骤保持任务状态清晰。

它不是 ADHD 诊断或治疗工具,也不提供医疗建议。项目名称描述的是一种偏好的信息呈现方式;即使没有 ADHD,也可以使用它来减少冗长回答带来的阅读负担。

快速答案

在 Claude Code 中安装:

1
2
claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

安装后输入 /i-have-adhd,即可在当前会话启用。

在 Codex 中安装:

1
2
codex plugin marketplace add ayghri/i-have-adhd --ref main
codex plugin add i-have-adhd@i-have-adhd

安装后输入 $i-have-adhd 启用。这个技能默认不会自动介入所有回答;只有明确调用后才会改变当前会话的输出风格。

i-have-adhd 改变了什么

这个技能不负责写代码、运行命令或修改项目,它主要约束 Agent 如何组织回答。官方规则可以归纳为以下几类:

规则 实际效果
行动优先 第一行直接说明现在要做什么
步骤编号 多步骤任务按执行顺序列出,不把动作埋在段落中
每轮重述状态 对话变长后仍能看出当前做到哪里、下一步是什么
控制支线 非必要背景和延伸建议暂不展开
列表限长 一次最多突出五项,减少同时处理的信息
明确收尾 结尾只留下一个具体的下一步,而不是客套话

它还要求对时间估计更具体、把已完成的小进展明确标出来,并用平实语气报告错误。核心不是简单地“少说话”,而是把信息重新排序:行动、状态和阻塞项在前,解释在后。

在 Claude Code 中安装和管理

先添加官方仓库提供的插件市场,再安装插件:

1
2
claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

检查安装结果:

1
claude plugin list

需要更新时执行:

1
claude plugin marketplace update i-have-adhd

如果只想暂时停用,而不是删除插件:

1
claude plugin disable i-have-adhd

彻底卸载则执行:

1
2
claude plugin uninstall i-have-adhd
claude plugin marketplace remove i-have-adhd

安装完成后,在需要这种输出方式的会话里输入 /i-have-adhd。如果命令没有出现在自动补全列表中,先重启 Claude Code,因为插件索引通常在启动时读取。

在 Codex 中安装和管理

Codex 的安装命令与 Claude Code 略有不同:

1
2
codex plugin marketplace add ayghri/i-have-adhd --ref main
codex plugin add i-have-adhd@i-have-adhd

检查是否已经安装:

1
codex plugin list

需要获取新版时,可以更新市场索引,再重新安装插件:

1
2
3
codex plugin marketplace upgrade i-have-adhd
codex plugin remove i-have-adhd
codex plugin add i-have-adhd@i-have-adhd

卸载命令如下:

1
2
codex plugin remove i-have-adhd
codex plugin marketplace remove i-have-adhd

在对话中输入 $i-have-adhd 才会启用这个技能。想恢复普通输出时,可以直接告诉 Agent stop adhd modenormal mode。如果切换后仍沿用旧风格,新建一个会话通常比反复纠正当前上下文更可靠。

如何设为默认输出风格

如果每次会话都需要手动启用,可以把持续性规则写入全局指令文件。

Claude Code 使用 ~/.claude/CLAUDE.md,Codex 使用 ~/.codex/AGENTS.md。加入以下内容:

1
2
3
## Output style

Always follow the rules in the `i-have-adhd` skill: action-first, numbered steps, no preamble, no closers, state restated each turn.

全局启用会影响所有项目。更稳妥的做法是先在几个会话中手动调用,确认这种节奏适合自己的工作方式,再决定是否写入全局配置。对于需要教学式讲解、设计讨论或长篇推理的任务,也可以临时要求助手完整解释。

安装到其他 Agent 工具

支持 Agent Skills 生态的工具可以通过 npx skills 安装:

1
npx skills add ayghri/i-have-adhd

全局安装:

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

也可以指定目标工具并跳过交互确认,例如:

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

使用以下命令检查本地或全局技能:

1
2
npx skills list
npx skills ls -g

Antigravity 用户可以直接从 GitHub 仓库安装:

1
2
agy plugin install https://github.com/ayghri/i-have-adhd
agy plugin list

卸载时执行:

1
agy plugin uninstall i-have-adhd

一次回答会怎样变化

假设构建失败,普通回答可能先解释依赖解析原理、列出几个潜在原因,最后才给检查命令。启用 i-have-adhd 后,回答会更接近下面的结构:

  1. 先运行一条只读命令,取得完整错误信息。
  2. 明确当前状态,例如“构建尚未通过,正在确认缺失依赖”。
  3. 根据输出只选择一个最可能的修复方向。
  4. 修复后立即运行验证命令。

最后只保留一个下一步,例如“现在把第一条命令的输出发来”。这样做尤其适合安装依赖、处理 Git 冲突、排查部署问题,以及需要在多个短步骤之间来回确认的任务。

简洁不等于跳过安全检查

官方技能为几类场景保留了例外:

  1. 用户明确要求解释或完整演练时,仍应充分说明。
  2. 删除数据、覆盖文件等破坏性操作必须先确认,不能为了简短而绕过安全步骤。
  3. 连续多轮调试没有进展时,应暂停并质疑原有假设,而不是继续堆叠命令。
  4. 条件确实不明确时,应先问一个简短问题,避免凭空猜测。

因此,这个技能更像信息优先级规则,而不是强制压缩一切内容。涉及医疗、法律、财务或系统安全的任务时,必要的风险说明和确认仍然要保留。

自定义自己的版本

如果默认规则过于激进,可以 Fork 仓库并编辑 skills/i-have-adhd/SKILL.md。比较实用的调整包括:

  • 把列表上限从五项改为适合自己的数量;
  • 允许在代码评审中保留更完整的原因说明;
  • 规定只在执行型任务中使用行动优先结构;
  • 为团队加入固定的“当前状态、风险、下一步”模板。

修改前建议先阅读完整技能文件,确认规则和例外是否符合自己的工作环境。安装第三方插件时也应检查仓库内容、许可证和后续更新,而不是只依据项目名称直接启用。

与 caveman 有什么区别

i-have-adhd 主要解决“先说什么、每轮如何保持任务状态”的问题;caveman 更强调压缩 Agent 输出、减少废话和 token 消耗。两者目标相近,但关注点不同:前者偏向行动顺序和注意力负担,后者偏向表达压缩。

如果只是嫌回答太长,先尝试 caveman;如果常常找不到下一步、对话一长就丢失任务状态,i-have-adhd 的结构化规则更有针对性。不要同时叠加过多风格约束,否则模型可能为了满足格式而省略必要信息。

常见问题

安装后为什么没有变化?

插件默认不会自动启用。Claude Code 需要输入 /i-have-adhd,Codex 需要输入 $i-have-adhd。如果希望每个会话都生效,再把输出规则写入对应的全局指令文件。

为什么找不到斜杠命令或技能?

先重启 Agent,再运行插件或技能列表命令确认安装位置。使用本地路径添加市场时,路径应指向仓库根目录;使用 GitHub 时则使用 owner/repo 形式。

它能帮助诊断或治疗 ADHD 吗?

不能。它只调整大语言模型的输出方式,不评估症状、不管理药物,也不能替代医生或其他专业支持。如果你关心自身健康状况,应咨询合格的医疗专业人员。

项目可以商用或修改吗?

仓库采用 MIT License。实际使用或再分发前,仍建议查看仓库中的最新许可证文本和文件内容。

总结

i-have-adhd 的价值不在于让 Agent 永远只回答几句话,而在于稳定回答顺序:先行动,再解释;每轮说明状态;结束时只留下一个明确的下一步。对于经常被长篇前言、过多支线和模糊收尾打断的开发流程,这是一套可以直接安装,也可以 Fork 后自行调整的输出规范。

项目地址:ayghri/i-have-adhd