GitHub每日热评|拒绝AI输出大段废话:为什么“ADHD友好”的Agent交互规则在GitHub杀疯了?
评测快照:
ayghri/i-have-adhd@58494af
项目定位:针对注意力碎片化与认知过载的 Agent 交互规则及跨平台 Hook 插件
数据指标:Stars 28,394 | Forks 1,771 | 主语言 Python | 协议 MIT
取材窗口:GitHub Trending Daily (2026-09-08)
作者:Valhalla Matrix治理实验室
不知道你是否也有过这样的经历:在终端或编辑器中向 AI 编程助手提问一个简单的配置问题,AI 却先洋洋洒洒铺陈三段背景介绍,接着给出五六种可能适用的备选方案,并在末尾附带一段长长的注意事项与礼貌客套。当你的大脑本就处于高负荷编码状态时,这堵密不透风的“文本墙(Wall of Text)”会瞬间打断思维连贯性,甚至诱发认知疲惫。
在 2026 年 9 月的 GitHub 今日热榜上,ayghri/i-have-adhd以黑马之姿迅速冲破 2.8 万 Star。它的标语直白而尖锐:“ADHD-friendly outputs. No ADHD diagnosis needed!”(输出对 ADHD 友好,且你根本无需临床诊断)。
本文只探讨一个核心技术命题:为什么将大模型的输出从“礼貌型阐述”重构为“极简行动流”,是智能体从能用到好用的必然演进?
一、架构解析:从提示词到跨平台 Hook 契约
很多初见该项目的开发者会以为这不过是一段随手写写的 Prompt,但浅克隆其源码仓库后,能清晰看到一套完整的工程化适配网络:
1. 核心交互十诫(The Core Invariants)
在项目的规则定义中,作者把传统的“好心提醒”全部转化为不可违背的硬性约束:
- 行动优先(Action First):禁止以任何礼貌问候(如“当然!我很乐意帮您……”)开头,首行必须直接是可执行命令或代码。
- 拒绝文本墙(Anti-Wall-of-Text):任何单段解释不得超过 3 行,长逻辑强制采用带编号的极简步骤切分。
- 单点聚焦(Single Focus):每次只提供当前最优的解决方案,严禁一次性抛出 5 个等价方案让用户陷入选择困难。
- 状态与路径显式锚定:涉及文件修改必须提供明确的绝对/相对路径与行号区间。
- 严禁无用客套:通篇禁用“希望这能帮到你”、“如果还有问题随时问我”等冗余尾注。
2. 双盲评测保障:tests/test_judge.py
在多数 Prompt 项目靠“主观感觉”迭代时,该项目在tests/test_judge.py中内置了一套基于双盲控制的评测脚本:
classLabelAssignmentTest(unittest.TestCase):deftest_labels_are_a_stable_bijection_over_conditions(self):conditions=["baseline","candidate"]first=judge.assign_labels(("direct-answer",1),conditions)second=judge.assign_labels(("direct-answer",1),conditions)self.assertEqual(first,second)self.assertEqual({"A","B"},set(first.values()))它利用随机双盲哈希分配基线(Baseline)与候选(Candidate)输出,由 Judge 模型在不知道哪份规则生效的前提下对回答的“直接性”、“信噪比”进行量化打分,确保规则微调不会导致语义退化。
二、实际改观对比:前后输出的工程级落差
| 场景 | 原生 AI 常见输出风格(高负荷) | 应用 i-have-adhd 规则后的输出(极简流) |
|---|---|---|
| 排查端口冲突 | 包含 4 段关于为什么端口会被占用的原理科普,推荐使用lsof、netstat或重启电脑,解释各参数意义。 | lsof -i :8080kill -9 <PID>1. 第一步查占用进程; 2. 第二步释放。 |
| 报错堆栈分析 | 表达共情,复述报错信息,列出可能导致此错误的 4 种假设,逐步展开讨论。 | 根因:第 42 行缺少空指针防御。 修复:在调用前插入 if (!user) return null;。 |
三、快速接入与实战配置
1. Claude Code / Codex 一键接入
如果你使用符合 Agent Skills 规范的客户端,可直接在提示中执行:
Install the i-have-adhd skill/plugin from https://github.com/ayghri/i-have-adhd2. 本地项目级生效(以 Cursor / VS Code 为例)
在项目根目录新建.cursor/rules/adhd.mdc或加入系统的全局 Instructions:
--- description: 极简行动派交互规则,杜绝冗余废话 globs: * --- - 首行直接给出结论或可执行命令。 - 解释单段不超过 3 行,复杂流程使用编号步骤。 - 每次只给 1 个推荐解,不抛出选择题。 - 禁止“希望对您有所帮助”等一切客套结语。四、技术局限与适用边界
- 不适用于探索性架构研讨:当你处于技术选型的前期头脑风暴阶段,需要模型提供发散性灵感、对比多种架构利弊时,过于激进的“单点极简”可能会剪枝掉有价值的边缘信息。
- 新手指导场景需审慎:完全剥离原理解释对于经验丰富的工程师是降噪,但对编程初学者而言,可能会产生“知其然不知其所以然”的困惑。
- 开源许可与合规:该项目采用宽松的 MIT 许可证,可以放心作为企业内训或私有化开发环境的交互底座。