ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

i-have-adhd 的 Gemini CLI 接入指南:GEMINI.md 上下文文件与 ADHD 友好输出规则全解析

2026/9/30 18:34:50 拓冰建站 浏览量
i-have-adhd 的 Gemini CLI 接入指南:GEMINI.md 上下文文件与 ADHD 友好输出规则全解析 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点击查看免费下载本篇技术指南以 GEMINI.md 为主体讲解 i-have-adhd 项目如何通过 Gemini CLI 的扩展机制contextFileName把一个仅 5 行的上下文文件变成整套 ADHD 友好输出规则的入口并完整解析它所导入的 10 条响应规则、例外情形与发送前自检清单。读完你将掌握GEMINI.md 在仓库中的定位与加载原理、按需命令与常开扩展两条 Gemini CLI 安装路线、以及如何结合 skills/i-have-adhd/SKILL.md 调优规则集让你的编码助手做到行动优先、步骤编号、无寒暄收尾。GEMINI.md 是什么Gemini CLI 扩展的上下文入口在 i-have-adhd 仓库中GEMINI.md 位于仓库根目录全文只有 5 行。它本身不承载规则正文而是扮演入口指针的角色为 Gemini CLI 提供一个极简上下文文件再由该文件把完整规则集导入进来。这一机制由 gemini-extension.json 声明其完整内容为{ name: i-have-adhd, version: 0.3.0, description: Shape Gemini CLI output for an ADHD reader: lead with the next action, number steps, suppress tangents, restate state, make wins visible., contextFileName: GEMINI.md }关键字段是contextFileName它告诉 Gemini CLI 扩展加载时把GEMINI.md作为上下文文件注入对话。AGENTS.md 的仓库地图也把GEMINI.md归入Qwen、Kimi、Gemini运行时元数据一类并明确标注GEMINI.md for Gemini behavior——即它是 Gemini 行为定义的权威文档而gemini-extension.json的version: 0.3.0与 package.json 中的版本号保持一致符合仓库共享元数据版本对齐的运行时契约原则。GEMINI.md 全文解读一行指令 一个导入GEMINI.md 的完整内容如下原样引用# i-have-adhd Shape every response for a reader with ADHD. Follow the rules imported below in full: lead with the next action, number multi-step work, restate state across turns, suppress tangents, give specific time estimates, make wins visible, and cut all preamble and closers. ./skills/i-have-adhd/SKILL.md它由两部分构成一句话行为指令要求模型把每次回复塑造成 ADHD 读者能直接行动的形式并点出规则的核心要素——行动优先、多步工作编号、跨轮次复述状态、抑制离题、给出具体时间估计、让进展可见、删除一切开场白与结束语。这 7 个要点正是 skills/i-have-adhd/SKILL.md 中 10 条规则的浓缩版摘要。./skills/i-have-adhd/SKILL.md导入指令这是本文件的核心机制。它把位于skills/i-have-adhd/下的规范规则集整体导入使 GEMINI.md 自身保持极小体积同时保证行为规则只有 skills/i-have-adhd/SKILL.md 一个权威来源AGENTS.md 的 source-of-truth 规则明确要求修改技能行为时先改 SKILL.md再同步.cursor镜像。注意这里的./是相对 GEMINI.md 自身位置仓库根目录的导入路径在 Gemini CLI 加载该上下文文件时解析到skills/i-have-adhd/SKILL.md。规则本体SKILL.md 中的完整响应规则集GEMINI.md 导入的 skills/i-have-adhd/SKILL.md 才是真正的规则引擎。其 YAML frontmatter 声明了技能元数据name: i-have-adhd、disable-model-invocation: true关闭模型自动调用需用户显式触发、license: MIT、category: productivity。持久性规则贯穿整个会话SKILL.md 开篇即定义持久性这些规则适用于本次会话的每一次回复不会在几轮之后过期也不会因话题切换而失效若你不确定规则是否仍生效答案就是仍然生效。关闭方式只有两种显式口令——读者说出stop adhd mode或normal mode助手用一行确认后回到默认风格。ADHD 改变阅读方式的五个事实每条规则都建立在五个阅读事实之上这是理解整个规则集的设计基石工作记忆很小不在屏幕上的东西就会被忘记不要要求读者记住 X。知道答案 ≠ 动手做明白了到做完了之间的摩擦正是任务夭折的地方。开始是最难的一步第一个动作必须显而易见、足够小、当下就能做。时间估计趋于一致一点小活和几个小时在大脑中登记为同一回事模糊估计必然失效。多巴胺稀缺可见的进度才有价值被埋没的成果不会被感知。10 条核心规则含正反例规则 1先用行动开场。第一行必须是读者能执行的东西——命令、路径或代码片段而不是上下文或计划。差Lets think about this. Your auth flow has a few moving pieces...好Runnpm install jsonwebtoken, then editsrc/auth.ts:42.规则 2多步任务编号。超过一步的工作写成编号列表每步是一个有边界的动作没有哪一步包含两个然后。步骤越少越好可折叠的琐碎步骤并入前一步——走完的短路径胜过放弃的完整路径。差First open the file, find the function, swap it out, then run the tests.好1. Open src/auth.ts 2. Replace verifyToken (lines 42 to 58) with the snippet below 3. Run npm test -- auth.spec.ts规则 3以一个具体下一步收尾。若还有未尽事项只点名一件事且两分钟内可完成打开文件也算。差Hope that helps. Let me know if you want to dig deeper.好Next: runnpm testand paste the first failing line.规则 4抑制离题。如果存在第二个问题先完成第一个再把第二个作为单独的问题提出。工作中冒出且你能自己回答的问题不算离题自行解答并融入结果仍需读者参与的问题只在末尾出现一次。差Heres the fix. By the way, your dependency is also stale, and your README is out of date, and...好Heres the fix. Separately: there is also a stale dependency. Want me to handle that next?规则 5每轮复述状态。读者无法在消息之间记住我们在 5 步中的第 3 步必须复述。若 harness 有任务/计划工具用它承载多步工作每步一项、同一时刻只有一项进行中让清单替你做复述不要再用散文重复整个计划。差Done. Ready for the next part?好Step 3 of 5 done: schema updated. Next: backfill the new column. Run the script?规则 6给出具体时间估计。用具体单位给出大致的量级禁止这需要一些功夫。差This will take some work.好About 15 minutes if tests already cover this. An afternoon if not.规则 7让完成的工作可见。用具体语言展示现在什么已经可用了不要把事情埋进总结里。差Ive made some changes to the auth flow. Among other things...好Login now works with magic links. Try:npm run dev, open/login.规则 8错误要就事论事。禁用Uh ohOh noThere seems to be a problem直接陈述原因与修复。差Uh oh, the test is failing. There seems to be an issue...好Test fails atauth.spec.ts:42: expected 200, got 401. Cause: missing auth header. Fix: addAuthorization: Bearer ${token}to the request.规则 9列表上限 5 项。最终回复中的长列表要分组、按相关度排序可见工作集保持在每小组不超过 5 项更多相关项在内部保留不丢弃只在读者询问或轮到它们时展示。绝不因展示规则而省略必要信息——这条只塑造呈现方式不限制分析、搜索、工具结果与候选生成。规则 10无开场白、无总结、无寒暄。禁用开场Great question,Let me...,Ill...,Sure!,Looking at your...,To answer your question...禁用任务完成后的复述Ive now done X, Y, and Z, which means...禁用收尾Let me know if you need anything else,Hope this helps,Happy to clarify,Feel free to ask.。以答案开始以答案结束。何时打破规则6 种例外规则集明确列出了覆盖默认行为的例外安全性永远优先于简洁读者要求解释或带我过一遍完整展开正文长度以主题需要为准但仍无开场白、无收尾并加标题便于回扫。前方有破坏性操作rm -rf、force push、schema 迁移、删表先确认再行动安全胜过简洁。调试螺旋连续三轮还是不行时停止改代码点名可能出错的假设问一个诊断性问题。请求存在真实歧义用一句简短澄清问题胜过猜测后重写。规则与任务冲突当规则会删掉答案本身时任务胜出、外形保留。例如我有哪些选择应给出 24 个带一行取舍的排序选项、推荐在前而不是单一路径——选项本身就是答案。规则与 harness 冲突Agent 内部系统提示的优先级高于本技能——harness 要求时先声明工具调用、直接干活而不是问要不要我、时间估计指向实际执行者。与第 5 条同理约束胜出、外形保留。发送前自检清单发送前必须删除① 宣布我要做什么的第一句② 问还有别的事吗或复述刚才发生之事 的末句③ 任何顺带一提的旁白④ 不携带信息的 hedging 副词perhapsmightcould possibly保留承载真实不确定性的措辞删掉它等于制造虚假信心⑤ 任何习语或比喻circle backget the ball rollingon the same page换成字面动作。最后验证如果读者只读第一行和最后一行能否知道 (a) 下一步做什么、(b) 刚才发生了什么能就发送。在 Gemini CLI 中启用命令按需与扩展常开两条路线Gemini CLI 没有插件市场因此 INSTALL.md 提供了两条原生路线它们与技能默认姿态对应自定义命令opt-in不调用就不生效和扩展安装即常开。默认推荐命令路线除非你希望每条会话都套用规则。路线一自定义命令按需启用将仓库中的skills/i-have-adhd/agents/gemini.toml复制到 Gemini 的命令目录mkdir -p ~/.gemini/commands # 将仓库 skills/i-have-adhd/agents/gemini.toml 的内容保存为 ~/.gemini/commands/i-have-adhd.toml新开会话后输入/i-have-adhd规则在该会话内保持生效。验证方式ls ~/.gemini/commands # 确认 i-have-adhd.toml 存在或在会话中输入/确认i-have-adhd出现在命令列表。更新该路线只需重新拉取最新的gemini.toml覆盖旧文件。该 TOML 文件自包含、可在任意目录作为全局命令使用其prompt字段完整内嵌了 10 条规则与例外说明并在末尾留有{{args}}占位符以接收调用参数——这意味着即使不借助 SKILL.md 的导入机制这条命令也能独立生效。路线二扩展常开gemini extensions install 仓库地址扩展会加载GEMINI.md而 GEMINI.md 导入完整技能因此从第一条消息起规则即生效该方式要求本机已安装git。验证gemini extensions list更新与卸载gemini extensions update i-have-adhd # 更新扩展路线 gemini extensions uninstall i-have-adhd # 卸载扩展路线常开可选写入 ~/.gemini/GEMINI.md不装扩展也能常开把下面的 Output style 代码块追加到~/.gemini/GEMINI.mdGemini CLI 会在每次会话开始时读取## Output style The reader has ADHD. Shape every response so it can be acted on: 1. Lead with the answer or next action: command, path, or snippet first. 2. Number multi-step work; one bounded action per step. 3. End with one next action doable in under two minutes. 4. Finish the current issue before raising a new one. 5. Restate progress each turn (step 3 of 5 done). 6. Give time estimates in concrete units, never a bit. 7. After a change, show what now works. 8. Errors: state location, cause, and fix. No drama. 9. Cap lists to 5 items. 10. No preamble, no recaps, no closers. Exceptions: explain fully when asked to explain. Confirm before destructive actions. After three failed fixes, stop and name the doubtful assumption. If the request is ambiguous, ask one short question.这与 INSTALL.md 中针对 Gemini CLI 的官方建议一致也是 Grok、Codex、Hermes 等 harness 通用的常开写法——规则主体相同只是注入位置不同。三条路线的取舍路线生效时机适用场景自定义命令/i-have-adhd手动调用后本会话与技能默认关闭姿态一致按需启用扩展gemini extensions install安装后每条消息想要规则在每次会话无感常开~/.gemini/GEMINI.md常开代码块每次会话开头不装扩展、最小改动常开注意无论哪条路线stop adhd mode / normal mode 都仍是关闭规则的话术。自定义与调优规则的措辞决定了模型服从度。README.md 的 Tune it 一节给出了标准流程fork 仓库 → 编辑skills/i-have-adhd/SKILL.md→ 用你自己的副本替换上游claude plugin uninstall i-have-adhd # 先移除上游副本 claude plugin marketplace remove i-have-adhd # fork 与上游同名需先移除 claude plugin marketplace add your-username/i-have-adhd claude plugin install i-have-adhdi-have-adhd重启编码助手后再调用/i-have-adhd。若安装后回复仍有开场白INSTALL.md 的排障建议是新开会话若仍漂移则收紧 skills/i-have-adhd/SKILL.md 中的措辞。对于 Gemini CLI 的命令路线也可以直接编辑~/.gemini/commands/i-have-adhd.toml中的prompt内容实现本地定制无需 fork 整个仓库。设计要点为什么用导入而不是复制GEMINI.md 刻意保持极薄把全部规则下沉到 skills/i-have-adhd/SKILL.md这一设计有明确收益单一事实来源AGENTS.md 规定修改技能行为时先改 SKILL.md再同步.cursor镜像并明确保持共享元数据含版本跨清单文件对齐跨运行时一致同一套规则正文被 Gemini经 GEMINI.md 导入、Claude Code经hooks/hooks.json的 SessionStart 钩子与hooks/always-on.mjs、OpenCode经opencode.json与.opencode/plugins/i-have-adhd.mjs等运行时复用各运行时只提供何时注入的载体不重复维护规则内容行为可预期无论经哪条 Gemini 路线启用最终注入的规则都与 skills/i-have-adhd/SKILL.md 完全一致不存在扩展版与命令版规则漂移。从源码结构看GEMINI.md是这条跨运行时规则链上最短的一环一句话概括意图一个 import 指向权威正文剩下的全部交给 SKILL.md 与各平台的加载机制。对想为 Gemini CLI 接入该技能的开发者这份文件既是入口也是理解整个 i-have-adhd 行为体系的钥匙。赞分享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点击查看免费下载相关推荐Gemini CLI 项目上下文文件 GEMINI.md 解析构建、测试与开发规范全景指南Gemini CLI 项目上下文文件 GEMINI.md 解析构建、测试与开发规范全景指南 本文以 Gemini CLI 仓库根目录的 GEMINI.md 为人工智能AI Agent交互助手CLIMCP ClientsSuperpowers 中文版接入 Gemini CLI 完整指南安装、GEMINI.md 配置与 Skill 加载机制解析Superpowers 中文版接入 Gemini CLI 完整指南安装、GEMINI.md 配置与 Skill 加载机制解析 本指南基于仓库中的 docs/RAI 技能AI 插件人工智能开发工具如何第一次运行ADHD用Claude Code的/adhd命令设计限流器完整实战指南如何第一次运行ADHD用Claude Code的/adhd命令设计限流器完整实战指南 第一次运行 ADHD 只需要一条命令在 Claude Code 里输入创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考