GitHub每日热评|拒绝AI输出大段废话:为什么“ADHD友好”的Agent交互规则在GitHub杀疯了?
2026/9/9 2:58:44 网站建设 项目流程

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,但浅克隆其源码仓库后,能清晰看到一套完整的工程化适配网络:

核心规范: skills/i-have-adhd/SKILL.md

Cursor 规范镜像: .cursor/skills/

Claude Code / Codex 插件: .claude-plugin / .codex-plugin

OpenCode 体系: opencode.json / .opencode/

国内模型生态适配: kimi.plugin.json / qwen-extension.json

运行时 Hook 拦截: hooks/always-on.*

自动化双盲评测套件: tests/test_judge.py

1. 核心交互十诫(The Core Invariants)

在项目的规则定义中,作者把传统的“好心提醒”全部转化为不可违背的硬性约束:

  1. 行动优先(Action First):禁止以任何礼貌问候(如“当然!我很乐意帮您……”)开头,首行必须直接是可执行命令或代码。
  2. 拒绝文本墙(Anti-Wall-of-Text):任何单段解释不得超过 3 行,长逻辑强制采用带编号的极简步骤切分。
  3. 单点聚焦(Single Focus):每次只提供当前最优的解决方案,严禁一次性抛出 5 个等价方案让用户陷入选择困难。
  4. 状态与路径显式锚定:涉及文件修改必须提供明确的绝对/相对路径与行号区间。
  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 段关于为什么端口会被占用的原理科普,推荐使用lsofnetstat或重启电脑,解释各参数意义。lsof -i :8080
kill -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-adhd

2. 本地项目级生效(以 Cursor / VS Code 为例)

在项目根目录新建.cursor/rules/adhd.mdc或加入系统的全局 Instructions:

--- description: 极简行动派交互规则,杜绝冗余废话 globs: * --- - 首行直接给出结论或可执行命令。 - 解释单段不超过 3 行,复杂流程使用编号步骤。 - 每次只给 1 个推荐解,不抛出选择题。 - 禁止“希望对您有所帮助”等一切客套结语。

四、技术局限与适用边界

  1. 不适用于探索性架构研讨:当你处于技术选型的前期头脑风暴阶段,需要模型提供发散性灵感、对比多种架构利弊时,过于激进的“单点极简”可能会剪枝掉有价值的边缘信息。
  2. 新手指导场景需审慎:完全剥离原理解释对于经验丰富的工程师是降噪,但对编程初学者而言,可能会产生“知其然不知其所以然”的困惑。
  3. 开源许可与合规:该项目采用宽松的 MIT 许可证,可以放心作为企业内训或私有化开发环境的交互底座。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询