1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | adhd |
| 作者/维护者 | Udit Akhouri(GitHub:UditAkhourii) |
| 来源链接 | https://github.com/UditAkhourii/adhd |
| 许可证 | MIT(GitHub API) |
| GitHub Stars | 3,024(GitHub API) |
| Forks | 223(GitHub API) |
| 最新版本 | v0.1.4(GitHub Releases,npm 包名 adhd-agent) |
| 安装方式 | npx skills add UditAkhourii/adhd,或手动复制 SKILL.md 到对应 Agent 的 skills 目录 |
2. 功能介绍与亮点
adhd 是一个面向编码 Agent 的“并行发散思维”技能。它认为传统单线程思维链(无论是 Chain-of-Thought 还是共享上下文的 Tree-of-Thought)都会锚定在模型最先想到的方案上,导致输出趋于“教科书式正确但平庸”。adhd 的做法是:
- 发散阶段:从预设的认知框(监管者、生物学视角、极限玩家、十岁小孩、零预算等)中挑选 5 个,各自派生一个完全隔离上下文的子 Agent,互不干扰地生成方案,避免相互锚定;
- 收敛阶段:单独的评审 Agent 对全部方案打分、聚类、剔除“陷阱选项”,再对幸存方案做深化;
- 前置门禁:技能正文内置三道自检(是否开放式问题、是否高风险决策、用户措辞是否已暗示要直接答案),只有三者都通过才会触发这套较重的流程,避免对简单问题小题大做。
亮点:作者身份可核实(LinkedIn/X 公开,有可验证的技术背景),仓库含完整的评测脚本(EVALS.md、bench 目录,公开基线 vs adhd 的对比 transcript)、安全策略(SECURITY.md)、行为准则与贡献指南,工程规范性突出;仓库创建约两个月,近一天内仍有提交,维护活跃。
3. 适用场景
固定分类:工程效率与代码质量。
adhd 定位为“推理与规划层”,不用于常规编码(写语法、修复已知根因的 bug),而是用于开放性、高风险的工程决策场景:架构选型、模糊调试(无明确根因的疑难问题)、API/SDK 接口设计、产品或模块命名、技术策略比较等“给我几种方案”类型的提问。适合希望减少“第一反应式”平庸方案、愿意为关键决策多花 30–90 秒等待多路探索结果的 Claude Code / Codex 用户,尤其是独立开发者与小团队在缺少资深工程师做方案评审时使用。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持。README 提供
~/.claude/skills全局安装与项目级安装命令,为一级支持对象。 - Codex:✅ 原生支持。文档专设 Codex 小节,说明部分 Codex 版本对技能发现规则更严格时的强制安装参数,以及 SKILL.md 描述字段刻意压缩为单行的原因。
- OpenClaw:❓ 未验证。文档列出约 50 种受支持的 Agent/编辑器(Cursor、Antigravity、Cline、Continue、Aider、Gemini CLI、Windsurf、OpenCode 等),未点名 OpenClaw,不能等同视之。
- Hermes Agent:❓ 未验证。抓取到的材料未提及。
5. 推荐理由
adhd 用“多路并行、上下文隔离”这一架构手段而非单纯提示词技巧,系统性解决了 LLM 输出锚定首个方案的问题,并把“什么时候该用、什么时候不该用”做成了显式前置门禁,避免滥用增加不必要开销。项目工程规范完整(评测、安全策略、CI),近两个月持续获得多篇独立技术媒体报道与讨论,一条命令即可跨数十种 Agent 安装,适合作为工程效率类技能库中的“决策辅助”补充项。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | GitHub 3,024 星、223 Forks,仓库创建约两个月、近一天内仍有提交;The New Stack、note.com(日文技术媒体)、Data Science Collective(Medium/Substack)等至少 3 个独立平台有专门报道与评测 |
| 可用性 | 9 | npx skills add 一条命令即可跨约 50 种 Agent 安装;README、安装指南、评测方法论、贡献指南、安全策略文档齐全;近一天内仍有提交;无需任何付费依赖或 API key |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单: ① Shell 命令/权限:技能正文本身不执行 shell 命令,仅通过宿主 Agent 自身的子任务(Task)机制派生并行子 Agent,权限范围等同于宿主 Agent 本身; ② 联网外发:技能运行时不发起额外的外部网络请求; ③ API key/凭据:不需要任何凭据或密钥; ④ 可疑指令:抓取的 SKILL.md 与文档内容逻辑透明、无隐蔽指令或提示词注入迹象; ⑤ 作者/组织信誉:作者身份可公开核实,仓库含安全策略、行为准则与贡献指南,未见刷星或营销话术操纵迹象; ⑥ License:MIT,明确; ⑦ 维护时间:近一天内仍有提交,属活跃维护。 补充说明:仓库除技能文件外还附带一个可选的 npm CLI 与评测脚本(含可执行 TypeScript 代码),安装并使用技能本身不会触发这部分代码,仅在用户主动运行评测/CLI 命令时才会执行。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 adhd 的差异 |
|---|---|---|
| thedotmack/sequential-thinking-skill(33★) | 复刻 Sequential Thinking MCP 的单线程结构化推理技能,支持分支、修订与跨会话持久状态 | 单线程串行思考、可回溯修订,适合需要保留推理轨迹的场景;不做多分支并行探索,也没有“是否值得触发”的前置门禁 |
| youkchansim/tree-of-thought(32★) | 基于普林斯顿 NLP 研究、面向 Claude Code CLI 的系统化解空间探索框架 | 忠实实现学术版 Tree-of-Thought 的搜索/评估/回溯流程,偏研究复现;未针对“认知框隔离防锚定”和触发门禁做工程化打磨 |
| mattpocock/skills 的 domain-modeling、codebase-design | 给出结构化方法论,引导模型收敛到一个更优的领域模型/代码结构方案 | 目标是“把一个方案做对做深”,属收敛型方法论;adhd 目标是“先看见足够多不同的方案再选”,属发散型工具,两者可互补而非替代 |
8. 用户评价
- The New Stack(独立技术媒体,thenewstack.io):以《Researcher “gave Claude Code ‘ADHD’… and it thinks 2x better now.” Outside experts want more proof.》为题做了报道,认可其早期关注度与创意,但也指出“2 倍更好”的基准测试说法尚缺乏独立验证,建议审慎看待。
- Gao Dalie(高達烈),Data Science Collective 专栏作者(Medium / Substack):评价该技能“在特定场景下确实有价值”,认为其用五个隔离上下文的子 Agent 绕开了大模型输出锚定首个方案的问题;同时提醒使用者注意依赖风险,建议定期“停用”以检验自己对工具的依赖程度,整体评价积极但保持克制。
9. 其他补充
作者在 Reddit r/ClaudeCode 发布了介绍帖,社区反响促成了后续与 The New Stack 等媒体的报道;项目维护有独立 Discord 社区,用于讨论认知框设计、评测题目与集成需求。
10. 安装使用方式
- 通用一条命令:
npx skills add UditAkhourii/adhd(可加-g全局安装,-a codex/-a claude-code指定目标 Agent,--copy改为复制而非软链接)。 - Codex 专用(如自动检测失败):
npx skills add UditAkhourii/adhd -a codex -g,或手动将 SKILL.md 复制到~/.codex/skills/adhd/。 - Claude Code 手动安装:将
skills/adhd/SKILL.md复制到~/.claude/skills/adhd/(全局)或项目内.claude/skills/adhd/(项目级)。 - 安装后需重启对应 Agent 以完成技能发现;技能会在头脑风暴、命名、架构、“给我几种方案”等意图下自动触发,也可用
/adhd "你的问题"显式调用。
11. 注意事项
- 该技能设计上开销较大(约 10 次 Agent 调用、30–90 秒、成本为单次直接回答的 5–10 倍),仅适合高风险、开放式的决策场景,日常语法查询或已知根因的 bug 修复不建议触发;
- “输出质量提升 2 倍”的说法来自作者自评测,尚未见独立第三方基准复现,应理性看待;
- 项目上线约两个月,长期维护节奏与社区规模的持续性仍待观察。