i-have-adhd仓库结构导览唯一事实源在哪、.cursor镜像如何同步【免费下载链接】i-have-adhdA skill to stop your coding agent from burying the answer. ADHD-friendly output.项目地址: https://gitcode.com/GitHub_Trending/ih/i-have-adhdi-have-adhd 是一个给编程助手coding agent装上的ADHD 友好输出技能它让 AI 不再用好问题让我想想……把答案埋在长篇大论里而是行动优先、步骤编号、直接给下一步。这篇文章带你完整导览 i-have-adhd 仓库结构先搞懂 10 条规则的唯一事实源source of truth在哪里再弄清.cursor目录下的镜像副本是如何与正源保持同步的——对想二次开发或提交 PR 的新手尤其有用。 项目定位30 秒看懂它做什么这个仓库本质上是一个可跨平台安装的 AI 输出风格技能。核心行为全部来自 SKILL.md 中的 10 条规则例如第一行必须是可执行的下一步命令、路径或代码片段多步骤任务必须编号每步只含一个动作列表最多 5 条禁止开头寒暄、禁止结尾希望对你有帮助效果对比摘自 README.md安装前 AI 会铺垫半天安装后直接输出Run npm install ...然后编辑 src/auth.ts:42 编号步骤。️ 仓库结构全景图根目录文件不多但按职责分成四块。下面这张表汇总自 AGENTS.md 的 Repository map区域位置职责唯一事实源skills/i-have-adhd/SKILL.md10 条 ADHD 友好输出规则的权威定义技能镜像.cursor/skills/i-have-adhd/SKILL.md供 Cursor 使用的同步副本各平台元数据.claude-plugin/、.codex-plugin/、.agents/plugins/Claude / Codex 插件清单与市场信息共享 hookshooks/hooks.json、hooks/always-on.mjs跨平台常开行为声明运行时扩展package.json、extensions/Pi / OMP 的原生扩展入口其他运行时opencode.json、qwen-extension.json、kimi.plugin.json、gemini-extension.json、plugin.json、GEMINI.mdOpenCode、Qwen、Kimi、Gemini、Antigravity 的入口文档README.md、INSTALL.md、.github/readme/用户文档及多语言版本验证工具tests/、scripts/、evals/单元测试、兼容性检查、评估用例 记忆技巧行为只有一份skills/其余全是接线板——各平台 manifest 只是把自家 AI 接到这份行为上。️ 唯一事实源在哪三个关键位置1. 规则本体skills/i-have-adhd/SKILL.mdSKILL.md 全仓仅此一份定义了输出长什么样。它带 frontmatter 元数据名称、描述、/i-have-adhd调用方式正文分持久性ADHD 阅读特点10 条规则何时可以破例发送前自检五段。改行为 改这一个文件。2. 事实源规则AGENTS.md 的 Source-of-truth rulesAGENTS.md 是面向 agent 的导航地图其中明确写下维护铁律修改技能行为时先改skills/i-have-adhd/SKILL.md再同步.cursor镜像各平台 manifest 与 hook 声明视为运行时契约版本号等共享元数据必须跨文件对齐README.md/INSTALL.md中的安装与行为描述必须保持准确3. 各运行时入口如何指向正源不同平台用不同方式引用这唯一一份行为AGENTS.md 的 Runtime entry points 表 列出了调试每个集成时该先读哪个文件运行时先看这些入口Claude Code.claude-plugin/plugin.json hooks/hooks.json hooks/always-on.mjsCodex.codex-plugin/plugin.json .agents/plugins/marketplace.jsonPi / OMPpackage.json 中的pi/omp字段 extensions/i-have-adhd.tsOpenCodeopencode.json .opencode/plugins/i-have-adhd.mjsGeminigemini-extension.json GEMINI.md一个值得注意的细节GEMINI.md 用./skills/i-have-adhd/SKILL.md以import 引用的方式接入正源天然不会漂移而 Cursor 无法这样引用所以采用了下一节的镜像方案。 .cursor 镜像如何同步手工两步 CI 双保险为什么需要镜像.cursor/skills/i-have-adhd/SKILL.md 是skills/正源的完整拷贝。CI 注释cursor-skill-sync.yml解释了原因它必须是一个真实文件而不是符号链接这样 Windows 克隆和 GitHub ZIP 下载issue #55都能正常拿到内容。手工同步方法贡献者流程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.mdcmp静默通过即表示两份内容完全一致有差异会打印首个不同字节的位置。CI 自动守卫cursor-skill-sync.yml光靠手工容易漏仓库用 cursor-skill-sync.yml 加了自动闸门触发条件PR 中任何触及skills/i-have-adhd/SKILL.md、.cursor/skills/**或 workflow 自身的改动以及推送到main分支校验逻辑在 ubuntu-latest 上对两份文件执行cmp第 20-25 行失败反馈一旦漂移PR 直接变红并提示修复命令.cursor copy is out of sync. Run: cp skills/i-have-adhd/SKILL.md .cursor/skills/i-have-adhd/SKILL.md也就是说改了正源忘了同步镜像PR 根本合不进去。这套权威源 真实文件镜像 CI 字节比对的组合是跨平台技能分发里防止副本漂移的实用范式。✅ 变更后的验证清单改完文件和镜像后按 AGENTS.md Verification 一节 跑最小相关检查命令作用python3 -m unittest discover -s tests -v跑 tests/ 下全部单元测试python3 scripts/run_evals.py validate校验 evals/cases.jsonl 评估用例与 evals/rubric.md 评分契约bun scripts/check_context_compat.ts检查 extensions/context-compat.ts 的运行时上下文兼容逻辑claude plugin validate .校验 Claude 插件清单合法性行为类改动还需跑成对的基线/候选评估并记录运行时、模型、用例、轮次与评分标准。 结语一句话记住 i-have-adhd 的仓库结构行为只有一个家skills/i-have-adhd/SKILL.mdCursor 有一份受 CI 盯梢的镜像其余文件都是各平台接线板。想改规则先改正源、cp同步镜像、cmp验证再跑测试——CI 会替你把关最后一步。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考