这份详细的部署教程将指引您安装和使用 i-have-adhd——一个为编程助手（如Claude Code、Codex等）设计的技能（Skill），旨在让AI的回答更直接、清晰、可操作，尤其适合注意力不易集中的用户。

它的核心是改变AI的回复方式：它会强制AI以**“行动优先”**、步骤编号、简洁直接的方式回答，去掉客套话和无关信息，让您能快速抓住重点并执行下一步。

🚀 快速安装指南

安装方式取决于您使用的AI编程助手。i-have-adhd 支持多种主流工具。

Claude Code (推荐)

这是最推荐的安装方式，通过插件市场安装。

1
2
3
# 在 Claude Code 会话中依次执行
/plugin marketplace add ayghri/i-have-adhd
/plugin install i-have-adhd@i-have-adhd

安装后，技能会自动激活。您无需额外指令，AI的输出风格会立即改变。

Codex, Cursor, Copilot, Gemini CLI 等 (通用)

对于其他支持Agent Skills的50多种工具，可以使用统一的 npx skills 命令。

1
2
# 全局安装（推荐，所有项目可用）
npx skills add ayghri/i-have-adhd -g

如需指定安装到特定工具（如仅安装到Codex）：

1
npx skills add ayghri/i-have-adhd -g -a codex

更新：

1
npx skills update i-have-adhd -g

其他工具与手动安装

  • OpenCode: 项目提供了 opencode.json 插件配置，可将技能作为服务器插件使用。
  • Cursor/Gemini/Kimi/Qwen: 项目在 .cursor/、gemini-extension.json、kimi.plugin.json、qwen-extension.json 中提供了相应的插件或扩展配置，您可以根据其文档手动配置。
  • 手动 (开发者): 克隆仓库，将 skills/i-have-adhd 目录链接或复制到您AI工具的技能目录下（如 ~/.claude/skills/）。

🧠 核心规则与效果

安装此技能后，您的AI助手将遵循以下核心规则，从根本上改变其回复方式。

主要变化（示例）：

  • 之前 (冗长模糊)：

    Great question! Let me think about this. Your auth flow has a few moving pieces… Hope this helps! Let me know if you want to dig deeper.

  • 之后 (行动清晰)：

    Run npm install jsonwebtoken@latest, then edit src/auth.ts:42.

    1. Open src/auth.ts
    2. Replace verifyToken (lines 42–58) with the snippet below
    3. Run npm test -- auth.spec.ts
      Next: paste the first failing line if any test fails.

10条核心规则 (详细内容见 SKILL.md)：

  1. 以下一步行动开头。
  2. 多步骤任务必须编号。
  3. 以一个具体的下一步结尾。
  4. 抑制题外话。
  5. 每轮都重述当前状态。
  6. 给出具体时间估算（以“分钟”为单位）。
  7. 明确展示“胜利”（成果）。
  8. 错误报告要就事论事。
  9. 列表最多5项。
  10. 无开场白、无总结、无客套话。

🔧 自定义与调优

您可以自由调整这个技能，让它更符合您的个人偏好。

  1. Fork仓库：在GitHub上Fork此项目。

  2. 编辑规则：在您Fork的仓库中，修改 skills/i-have-adhd/SKILL.md 文件，调整或增删规则。

  3. 安装您的定制版：

    1
    2
    3
    4
    5
    6
    # 首先在Claude Code中卸载原版
    claude plugin uninstall i-have-adhd
    claude plugin marketplace remove i-have-adhd
    # 然后添加您自己的仓库市场并安装
    claude plugin marketplace add <您的GitHub用户名>/i-have-adhd
    claude plugin install i-have-adhd@i-have-adhd

    重启Claude Code即可生效。

❓ 常见问题

  • 技能不生效：确保您已正确安装。在Claude Code中，可尝试重新加载插件（/reload-plugins）或重启应用。
  • 安装脚本失败：确认您的网络能正常访问GitHub，并检查AI工具是否支持该安装方式。
  • 想临时禁用：由于它是“自动生效”的，如果您需要一次普通回复，可以明确告诉AI：“请关闭i-have-adhd风格，用常规方式回答我。”

📚 了解更多

  • 完整规则：查看仓库根目录的 AGENTS.md 文件，了解详细的上下文和贡献指南。
  • 问题反馈：访问 GitHub Issues 页面。