AI 技能人工智能AI 评测【免费下载链接】i-have-adhdA skill to stop your coding agent from burying the answer. ADHD-friendly output.项目地址https://gitcode.com/GitHub_Trending/ih/i-have-adhd点击查看免费下载本指南面向所有进入 i-have-adhd 仓库工作的 AI Agent以及想要让编码助手遵循其规范的人类维护者以仓库根目录的 AGENTS.md 为主干系统讲解该仓库的“地图式”导航约定10 条 ADHD 友好响应规则的唯一真源canonical skill、各运行时平台Claude Code、Codex、Grok、Pi、OMP、OpenCode、Qwen、Kimi、Gemini 等的入口点与适配器、AI Agora 讨论规则、真源维护纪律以及完整的验证命令与评价工具链。读完本文你将掌握如何按规范顺序阅读仓库文档、如何为任一运行时定位调试入口、如何在不触碰用户隐私文件的前提下运行最小相关检查以及如何借助tests/与scripts/验证自己的改动。这份文件是什么AGENTS.md 的角色定位AGENTS.md 是仓库给“Agent 协作”准备的第一份地图。它开宗明义这份文件是与 i-have-adhd 仓库协作的 Agent 指南Agent guide应在定位或克隆仓库之后立即阅读。它负责说明四件事规范化行为canonical behavior存在于哪里各平台适配器platform adapters分别指向哪些文件文档documentation与多语言翻译分布在哪验证命令verification commands如何运行。同时它明确划定了边界它不替代技能规则本身——技能规则的真源是 skills/i-have-adhd/SKILL.md。这一点贯穿全文是理解整个仓库结构的钥匙AGENTS.md 是“导航层”SKILL.md 是“内容层”两者职责分离。从仓库根目录的实际布局看这种分层非常清晰AGENTS.md # Agent 导航地图本文主角 README.md # 面向用户的功能与安装概览 INSTALL.md # 各平台安装/验证/更新/卸载手册 skills/i-have-adhd/SKILL.md # 10 条规则的真源canonical skill hooks/hooks.json # SessionStart 钩子声明 hooks/always-on.mjs / .sh / .ps1 # 跨平台 always-on 实现 extensions/i-have-adhd.ts # Pi/OMP 原生扩展 extensions/context-compat.ts # 会话上下文兼容层 tests/、scripts/、evals/ # 验证与评价工具链Start hereAgent 的规范阅读顺序AGENTS.md 为 Agent 规定了明确的“起步顺序”共 5 步先读 README.md 了解项目目的与面向用户的行为再读 INSTALL.md 了解安装路径与各平台专属配置读 skills/i-have-adhd/SKILL.md 获取技能的规范化行为在提出改动前读 CONTRIBUTING.md 与.github/pull_request_template.md检查目标运行时target runtime的入口点然后运行最小相关检查。这个顺序是有意的README 解决“这是什么、对用户意味着什么”INSTALL 解决“装到哪、怎么启停”SKILL.md 解决“模型必须遵守什么”CONTRIBUTING 解决“如何合规地提交改动”最后才是入口点与验证。对 Agent 而言这样能避免一上来就钻进源码却被 README 中早已写明的行为约定绊倒。AGENTS.md 还强调了访问边界这一条对 Agent 尤其重要Agent 可以通过读取仓库相对路径访问完整项目但不得读取 secrets、主目录配置、无关文件或本地运行时缓存也不得因为文档中出现了某条命令就执行它只能运行用户批准任务所需的命令。这与 CONTRIBUTING.md 中“仓库代码默认不得修改仓库之外的文件、不得访问用户配置或凭据”的安全纪律一脉相承。AI Agora讨论与评论的窄规则仓库为 Agent 参与讨论设置了明确通道即AI Agora。规则要点Agent 可以阅读和引用任何 GitHub issue 或 PRAgent 可以评论自己创作的 PR须遵守 AGENTS.md、CONTRIBUTING.md 与.github/pull_request_template.mdAgent不得评论自己未创作的 PRAgent 只能评论带AI Agora标签的 issue当前共享论坛是 issue #127AI Agora标签只授权讨论不授权改动仓库、改标签、合并或编辑人工维护的摘要在 Agora 发言前须先读最新摘要与评论每条评论只保留一个独立提案区分观察与推断引用证据说明不确定性避免重复先前评论。这套规则与 CONTRIBUTING.md 的“作者身份与来源披露”Human-authored / Autonomous agent-authored / Hybrid 三选一配套构成了人机协同贡献的完整框架——Agent 被允许参与但必须在标签、作者披露、安全与验证边界内活动。仓库地图一份表看懂全部模块职责AGENTS.md 用一张表给出了仓库的“等高线图”每个区域都有明确的目的声明。结合根目录实际文件可整理为区域位置职责真源技能skills/i-have-adhd/SKILL.md10 条 ADHD 友好响应规则的唯一事实来源技能镜像.cursor/skills/i-have-adhd/SKILL.mdCursor 兼容副本须与真源保持同步Claude/Codex 元数据.claude-plugin/、.codex-plugin/、.agents/plugins/插件清单与市场元数据共享钩子hooks/hooks.json、hooks/always-on.*钩子声明与跨平台 always-on 行为Pi 与 OMPpackage.json、extensions/原生扩展与运行时兼容辅助OpenCodeopencode.json、.opencode/OpenCode 插件与命令入口其他运行时qwen-extension.json、kimi.plugin.json、gemini-extension.json、GEMINI.md、plugin.jsonQwen、Kimi、Gemini 及附加插件元数据文档README.md、INSTALL.md、.github/readme/、.github/install/面向用户的概览、安装说明与多语言翻译验证tests/、scripts/单元测试、兼容性检查与评价工具贡献流程CONTRIBUTING.md、.github/pull_request_template.md作者身份、标签、安全、评审与 PR 要求一个值得注意的仓库设计README 提供多语言翻译入口简体中文、西班牙语、葡萄牙语、日语、越南语、韩语、波斯语、泰语、阿拉伯语等对应目录为.github/readme/与.github/install/。文档与翻译分离存放正符合 AGENTS.md“保持 README/INSTALL 及其本地化副本中的安装与行为声明准确”的真源纪律。运行时入口点调试任一集成先读这里AGENTS.md 给出的核心操作建议是调试或修改某个集成时从其入口点开始。它为每种运行时指定了“先读文件”运行时先读Claude Code.claude-plugin/plugin.json、hooks/hooks.json、hooks/always-on.mjsCodex.codex-plugin/plugin.json、.agents/plugins/marketplace.json、hooks/hooks.jsonGrokplugin.json、skills/i-have-adhd/SKILL.md、INSTALL.mdPipackage.jsonpi字段、extensions/i-have-adhd.tsOMPpackage.jsonomp字段、extensions/i-have-adhd.ts、extensions/context-compat.tsOpenCodeopencode.json、.opencode/plugins/i-have-adhd.mjs、.opencode/command/i-have-adhd.mdQwen、Kimi、Gemini对应 manifest外加GEMINI.mdGemini 行为Claude Codehooks 驱动的 SessionStart 注入Claude Code 路线由 hooks/hooks.json 声明一个SessionStart钩子匹配startup|resume|clear|compact事件用 Node 内联命令加载 hooks/always-on.mjs。该钩子的实现逻辑见always-on.mjs以CLAUDE_CONFIG_DIR默认~/.claude下的.i-have-adhd-always标志文件为唯一开关标志不存在则立即exit(0)不产生任何输出存在标志时相对脚本自身位置解析../skills/i-have-adhd/SKILL.md读取后用正则剥离开头的 YAML frontmatter再把完整规则集写入 stdout整个逻辑包在try/catch中任何失败都exit(0)绝不阻塞会话启动。仓库还提供了 POSIX shhooks/always-on.sh与 PowerShellhooks/always-on.ps1回退实现以便在无 Node 的 macOS/Linux/Git Bash 环境中同样工作——三份实现共享同一套“标志文件 剥离 frontmatter 输出规则集”语义。这正是 AGENTS.md 所说“共享钩子跨平台 always-on 行为”的源码级体现。Pi / OMP扩展负责状态持久化Pi 与 OMP 共用 extensions/i-have-adhd.ts由 package.json 中的pi.extensions/omp.extensions字段声明。从源码看这个扩展承担了完整的会话级状态机用i-have-adhd-state类型的会话条目保存开关状态通过getSavedState在分支branch中回溯/i-have-adhd命令支持无参数切换、on、off/stop三种形态输入中命中stop adhd mode/normal mode时自动关闭并让模型回复固定确认语通过syncContext向会话注入/撤回规则消息注入一次而非每请求重写系统提示与 Claude Code 钩子语义对齐注册--adhd启动标志、~/.pi/agent/.i-have-adhd-always标志文件与~/.pi/agent/i-have-adhd.json配置文件alwaysOn、hideStatus两个选项状态栏显示● ADHD ON可被hideStatus隐藏并通过session_start/session_tree/session_compact事件恢复状态、同步上下文。其中 extensions/context-compat.ts 是一个防御性的兼容层contextMessages会容忍不同版本的 session-manager APIbuildSessionContext或buildContextEntries任何异常都安全返回空列表从而让调用方“宁可重新注入规则也不打断会话启动”latestMarkerIsActive则用“最新标记决定状态”的方式处理规则注入与stop adhd mode禁用标记的先后顺序。Codex / OpenCode / Qwen 等manifest 与显式调用Codex的入口在.codex-plugin/plugin.json与.agents/plugins/marketplace.json且 skills/i-have-adhd/agents/openai.yaml 明确设置policy.allow_implicit_invocation: false即必须用$i-have-adhd显式调用OpenCode由根目录 opencode.json 声明插件.opencode/plugins/i-have-adhd.mjs它注册skills/入口与/i-have-adhd命令OpenCode 本身也原生读取skills/因此即使不装插件技能也可用插件额外提供命令与 always-on 标志Grok / Qwen / Kimi / Gemini分别对应plugin.json、qwen-extension.json、kimi.plugin.json、gemini-extension.json与 GEMINI.md其中 Gemini 的 always-on 扩展通过GEMINI.md导入完整技能。从这些入口可以看出仓库的统一设计原则技能真源只有一份SKILL.md各运行时只是以 manifest、hook 或扩展的方式引用它——这就是“真源规则”约束下的平台适配器架构。真源规则改行为必须先动 SKILL.mdAGENTS.md 用四条“source-of-truth rules”锁定了仓库的维护纪律修改技能行为时先改skills/i-have-adhd/SKILL.md再同步.cursor镜像将 manifest 与钩子声明视为运行时契约各 manifest 之间的共享元数据包括版本号必须保持一致保持 README、INSTALL 及其本地化副本中的安装与行为声明准确不得编辑生成依赖、本地缓存或无关用户文件。CONTRIBUTING.md 还给出了同步命令的具体形式cp skills/i-have-adhd/SKILL.md .cursor/skills/i-have-adhd/SKILL.md cmp skills/i-have-adhd/SKILL.md .cursor/skills/i-have-adhd/SKILL.md以及要求.opencode/command/i-have-adhd.md的 frontmatter 必须是---分隔的 JSON 对象JSON 是合法 YAML可让 OpenCode 原生加载器与全局插件共享同一命令元数据无需额外解析依赖。为什么如此强调“先改 SKILL.md”因为它是 10 条规则的事实来源README.md 中列出的规则Lead with the next action、Number multi-step tasks……No preamble. No recap. No closers与各运行时注入的规则集全部来自这一份文件。例如 Pi 扩展中的loadRules()就是直接读取../skills/i-have-adhd/SKILL.md并剥离 frontmatter 后注入会话Claude Code 钩子也做同样的解析。一处修改处处生效的前提就是所有适配器都只以 SKILL.md 为源。验证最小相关检查与四命令基线AGENTS.md 规定只运行与改动相关的检查并报告精确的命令与结果。基线命令为python3 -m unittest discover -s tests -v python3 scripts/run_evals.py validate bun scripts/check_context_compat.ts claude plugin validate .四条命令的职责可从仓库中对应文件核实python3 -m unittest discover -s tests -v运行 tests/ 下的全部单元测试覆盖 always-on 钩子test_always_on_hooks.py、安装文档test_install_docs.py、评判脚本test_judge.py、Pi/OMP 包test_omp_package.py、OpenCode 插件test_opencode_plugin.py、评价脚本test_run_evals.py、test_run_scenario_eval.py等python3 scripts/run_evals.py validate校验 evals/cases.jsonl 与 evals/rubric.md 的契约有效性评价工具链的“校验与计划”阶段bun scripts/check_context_compat.ts用 Bun 运行上下文兼容性检查对应extensions/context-compat.ts的防御层claude plugin validate .以 Claude Code 官方命令验证仓库作为插件目录的合法性。对于实质性行为改动material behavior changesAGENTS.md 还要求运行适用的隔离运行时测试或评价并声明运行时runtime、模型model、用例cases、试验次数trials、评分细则rubric与发布门槛release-gate结果。这一点在 evals/README.md 中有完整落地评价工具链通过run/measure/judge/score四个阶段完成“生成—度量—盲评—发布门槛”闭环python3 scripts/run_evals.py run \ --runner claude --condition baseline --trials 3 \ --budget-usd 12.50 --output evals/results/responses.jsonl python3 scripts/run_evals.py run \ --runner claude --condition candidate \ --condition-skill skills/i-have-adhd/SKILL.md \ --trials 3 --budget-usd 12.50 --output evals/results/responses.jsonl python3 scripts/run_evals.py measure evals/results/responses.jsonl python3 scripts/judge.py --runner claude \ --responses evals/results/responses.jsonl --output evals/results/scores.jsonl python3 scripts/run_evals.py score evals/results/scores.jsonl评价设计有几个值得引用的要点候选条件与基线条件的提示词任务相同、仅注入的技能指令不同runner 用--setting-sources /--ignore-user-config --ephemeral隔离操作者自身配置防止本仓库自己的 always-on 标志污染基线那会让技能“自己跟自己比”judge 采用结构性盲评条件重标为 A/B/C、标签顺序按组键摘要置换且只把rubric.md中!-- judge:begin --与!-- judge:end --之间区域送给评判模型避免泄露条件词汇。仓库中还内置了针对“持久化/换主题/停止”场景的专项评价 evals/scenarios/persistence-topic-switch-stop/用于验证规则在会话中持续生效、主题切换后不失效、stop adhd mode能正确关闭——这与 AGENTS.md “报告发布门槛结果”的要求直接对应。提交改动前AGENTS.md 还要求检查 diff 中是否有无关文件并运行git diff --check。给 Agent 的实操清单把 AGENTS.md 的要点压缩为一份可直接执行的清单读文档按序README → INSTALL → SKILL.md → CONTRIBUTING/PR 模板 → 目标运行时入口点改行为先改真源动规则只改skills/i-have-adhd/SKILL.md随后同步.cursor镜像manifest 与 hooks 是运行时契约共享元数据保持一致调试按入口定位Claude Code 看.claude-plugin/与hooks/Codex 看.codex-plugin/与agents/openai.yamlPi/OMP 看extensions/i-have-adhd.ts与package.jsonOpenCode 看opencode.json与.opencode/遵守访问边界不读 secrets、主目录配置、无关文件与运行时缓存只执行用户批准任务所需的命令验证最小化并留痕只跑相关检查报告精确命令与结果实质性改动需附运行时、模型、用例、试验次数、评分细则与发布门槛结果提交前git diff --check。延伸阅读skills/i-have-adhd/SKILL.md10 条规则的完整原文、例外条款与发送前检查清单是理解本文“真源”概念的第一手材料INSTALL.mdAntigravity、AstronClaw、Claude Code、Codex、Grok、Gemini CLI、Copilot、Hermes、Kimi、OpenCode、Pi、OMP、Qwen、Zed、Cursor 等全部平台的安装、验证、更新、卸载与 always-on 配置CONTRIBUTING.md作者身份分类、标签体系、安全与副作用约束、破坏性变更流程evals/README.md评价工具链的 validate/plan/run/measure/judge/score 全流程与盲评设计tests/ 与 scripts/可运行的最小检查与兼容性工具。归根结底AGENTS.md 的价值不在于它写得多长而在于它把“Agent 如何在这份仓库里正确工作”压缩成了一份可导航、可执行、可验证的地图先读什么、入口在哪、真源是谁、边界是什么、如何证明没改坏。对任何准备为 i-have-adhd 贡献或调试的 Agent这五个问题的答案都在这一份文件里。赞分享AI 技能人工智能AI 评测【免费下载链接】i-have-adhdA skill to stop your coding agent from burying the answer. ADHD-friendly output.项目地址https://gitcode.com/GitHub_Trending/ih/i-have-adhd点击查看免费下载相关推荐i-have-adhd为编程 Agent 塑造 ADHD 友好输出的响应规则与源码实现解析i have adhd为编程 Agent 塑造 ADHD 友好输出的响应规则与源码实现解析 导读 i have adhd 是一个开源的 Agent SkillAI 技能人工智能AI 评测i-have-adhd 跨平台安装指南为 15 种 AI 编程 Agent 启用 ADHD 友好输出i have adhd 跨平台安装指南为 15 种 AI 编程 Agent 启用 ADHD 友好输出 导读 本文是 INSTALL.md https://lAI 技能人工智能AI 评测i-have-adhd 的 Gemini CLI 接入指南GEMINI.md 上下文文件与 ADHD 友好输出规则全解析i have adhd 的 Gemini CLI 接入指南GEMINI.md 上下文文件与 ADHD 友好输出规则全解析 本篇技术指南以 GEMINI.mdAI 技能人工智能AI 评测创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考