进阶玩法与 FAQ

改规则定制自己的版本、把同一份 skill 搬去其他客户端，以及「装了没反应」的第一排查。

1模型发送前的自检

SKILL.md 给模型配了一张 Pre-send check 清单——理解它，就明白为什么输出总是那个形状。

发送前删掉五样东西：

1. 宣告式开头——「让我来……」这类宣布自己要干嘛的句子。

2. 客套式结尾——「还需要别的吗？」或复述刚做过什么。

3. 「顺便说一句」插曲——by the way 带出来的跑题。

4. 无信息量的模糊词——perhaps / might / possibly；真有不确定性的保留。

5. 习语——「circle back」换成字面动作「稍后再处理」。

终检标准只有一条：只读第一行和最后一行，也能知道「下一步做什么」和「刚发生了什么」——达到了才准发送。

2自定义你的规则

觉得「列表≤5」太狠？想加一条中文项目专属规矩？直接改本地的 SKILL.md。

# 全局副本在这里，改完新会话即生效
vim ~/.cursor/skills/i-have-adhd/SKILL.md

仓库的 Tune it 章节给的是 Claude Code 的 fork + marketplace 路线；Cursor 用户没必要绕那一圈——本地文件改了就能用。但注意两点：

1. 重装会覆盖：更新到新版时 npx skills add 会盖掉你的修改。

2. 想长期维护就 fork：把仓库 fork 到自己账号、改 skills/i-have-adhd/SKILL.md，之后用 npx skills add 你的用户名/i-have-adhd -a cursor -y 安装自己的版本。

规则文本的唯一事实源是 skills/i-have-adhd/SKILL.md，别去改 INSTALL.md 里那份 always-on 片段——那是给各客户端的精简引用，改了不会同步回去。

3搬到其他客户端

一份 SKILL.md 通吃主流 AI 编程 CLI，只是安装命令和调用符略有差别。

客户端	安装	会话内调用
Cursor	`npx skills add ayghri/i-have-adhd -a cursor -y`	`/i-have-adhd`
Claude Code	`claude plugin marketplace add ayghri/i-have-adhd` + `claude plugin install i-have-adhd@i-have-adhd`	`/i-have-adhd`；常驻：`touch ~/.claude/.i-have-adhd-always`
Codex	`codex plugin marketplace add ayghri/i-have-adhd --ref main` + `codex plugin add i-have-adhd@i-have-adhd`	`$i-have-adhd`（不会自动激活）
Gemini CLI	`gemini extensions install https://github.com/ayghri/i-have-adhd`	extension 即 always-on
Zed	clone 后拷到 `~/.agents/skills/`	`/i-have-adhd`
OpenCode	clone 到 `~/.config/opencode/vendor/`，opencode.json 注册插件	`/i-have-adhd`；常驻：`touch ~/.config/opencode/.i-have-adhd-always`

通用目录 ~/.agents/skills/ 被 Zed / OpenCode / Copilot 等多个客户端原生扫描——想一套装多处，先拷这里。

4FAQ

装完第一晚最常见的五个问题。

装完了，输入 /i-have-adhd 没反应？

按顺序查三处：① 确认文件存在：ls ~/.cursor/skills/i-have-adhd/SKILL.md；② 重开会话——skills 目录是会话启动时扫描的；③ 用 npx skills list 确认装到了 Cursor 而不是别的客户端。另外记住 frontmatter 里有 disable-model-invocation: true：模型永远不会自己启用它，on-demand 模式下必须你手动输命令。

中文对话也生效吗？

生效。规则约束的是「输出的形状」——先给动作、步骤编号、列表封顶 5 条——与回答用什么语言无关。你用中文提问，回答就是中文的 ADHD 友好格式。

会不会让回答变短、丢内容？

不会。规则 9 写得很明确：封顶只限制「展示」的分组大小，不限制分析、搜索和保留的信息量，完整度重要时一条都不能省。真想看完整展开，直接说 explain——这是第 3 章例外清单的第一条。

它和 CLAUDE.md / AGENTS.md / Cursor Rules 是什么关系？

都是「给模型注入指令」的通道，i-have-adhd 的差异点在于：现成、经过社区打磨（214 commits）、可开可关、按会话生效。第 2 章的 always-on 片段，本质就是把「自己手写 Cursor Rules」变成「粘贴一段现成文本」。

每次重开会话都要重新输一遍？

on-demand 模式是的——这是刻意设计（不污染不需要它的会话）。想要免输就用第 2 章的 always-on：User Rules 全局常驻，或项目里放一个 alwaysApply: true 的规则文件。

收尾

教程到此结束。去终端输一句 /i-have-adhd，把手头最烦的那个大任务丢给它试试。