跳到正文

i-have-adhd

一个给编码 agent 用的十条规则技能:先说下一步动作、多步任务编号、列表不超过五条,且每次回复都以一个具体的下一步收尾。

这是 ayghri 的 GitHub 头像,不是项目自己的 logo。取自 github.com,2026-10-02。

Screenshot of i-have-adhd
编辑截图, 2 Oct 2026i-have-adhd ↗

这是什么

这个技能改的不是编码 agent 能做什么,而是它汇报回来的方式。十条规则:先说下一步动作、多步任务编号、以一个具体的下一步收尾、抑制题外话、每轮重述当前状态、时间估计用分钟、让进展看得见、错误平实陈述、列表最多五条、开头不要铺垫。它以 Claude Code 插件的形式从市场安装,README 写明规则改编自《The Adult ADHD Tool Kit》。

谁做的仓库的 245 次提交来自约五十人。维护者以两个署名占最大份额——Ayoub Ghriss 73 次、Ayoub G. 53 次——其后是 ayghri 15 次、thejesh23 15 次、Lynn! 8 次,其余多为一到三次。仓库带十种语言的 README 译文。

它是怎么搭起来的

组成 · 3

一个 Markdown 文件就是产品。仓库里其余的东西——译文、测试、维护者自己的说明——都是为了分发或校验那个文件而存在。规则围绕一个承诺排序,而不是一种风格偏好:读者不该为了知道下一步该做什么而滚动页面,所以动作在最前面、步骤编号、回复以一个下一步收尾而不是一段总结。

skills/i-have-adhd/SKILL.md
技能本体:十条规则及其完整条文。README 只列规则名并指向这个文件,于是两者不可能漂成两本不同的规则书。
插件打包
通过宿主助手的市场安装,而不是拷贝:加市场、装插件、重启、重新调用。README 说明 fork 与上游同名,所以必须先把上游那份卸掉。
tests/ 与 .github/install/
八个测试文件和一个八文件的 install 目录,共 215 KB——在一个产品是 73 个散文与配置文件、体量并不大的仓库里,校验部分占了相当大的比例。

取舍,以及它替代了什么

  • 改写一套人类组织方法,而不是自创一套文风 替代 新写一张格式规则清单

    致谢一节明确写出出处与改写方向:来自《The Adult ADHD Tool Kit》,把「一个人该怎么安排一天」改成「一个模型该怎么回答」。

  • 规则只写在技能文件里,README 只列规则名 替代 把十条规则在文档里完整重述一遍

    README 列出标题并注明完整条文在 SKILL.md。一本存在两份的规则书,在第一次只改了一份的时候就会自相矛盾。

依据ayghri/i-have-adhd 的 README、INSTALL.md 与仓库文件树,2026-10-02 读取。

制作过程

4 个阶段
  1. 01

    一本以插件形式发布的文风规则,而不是一段提示词

    仓库创建于 2026-05-13,共 73 个文件:技能本体、十份 README 译文、八个测试文件和一份 install 目录。产品是 skills/i-have-adhd/ 下的一个 SKILL.md,README 把它整个说清楚——十条规则,从「先说下一步动作」到「不要铺垫、不要复述、不要收尾语」——完整条文留在那个文件里,而不是在文档里再抄一遍。安装走宿主自己的插件系统而不是拷贝:加市场、装插件、重启助手、重新调用技能。

  2. 02

    前后对照就是它的论证

    README 的主体是一张两列表格:左边是典型的助手回复——开头一段铺垫、把修复埋在中间;右边是同一件事在这套技能下的样子——文件、行号区间、代码片段、要跑的命令,最后一行说明失败时该贴回什么。致谢一节写明规则来自 J. Russell Ramsay 与 Anthony L. Rostain 的《The Adult ADHD Tool Kit》,并把「一个人该怎么安排一天」改写成「一个模型该怎么回答」。

  3. 03

    245 次提交,多数来自别人

    提交历史从 2026-05 到 2026-09,集中在七月(110 次)、八月(67 次)与九月(59 次)。提交署名约五十个,维护者的两个署名占了 245 次里的 126 次,其余分散得很开——一位贡献者 15 次、另一位 8 次,以及一长串一到三次的贡献。这份分布而不是星标数,才是 README 那十份译文所反映的东西:这些语言是由作者之外的人维护的。

  4. 04

    共同作者尾注说明了它是怎么写出来的

    245 次提交里有 12 次带共同作者尾注,其中 11 次署名 AI:Claude Opus 5(1M 上下文)四次、Claude Opus 4.8(1M 上下文)三次、Claude Opus 5 两次、Claude Fable 5 一次,以及「Copilot Autofix powered by AI」一次;剩下一次署名一个人。相对于贡献者数量,这个比例很小——而这正是对这个仓库诚实的读法:它是一个社区项目,其中一部分发布与自动修复是用模型写的,而不是一个由模型写成的项目。

相关档案

全部档案 →