i-have-adhd 镜像同步实践:保持 SKILL.md 与 Cursor 副本一致的完整验证指南
i-have-adhd 镜像同步实践保持 SKILL.md 与 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 是一个让编程 Agent 不再把答案埋在废话里的 ADHD 友好输出技能Skill。它用 10 条规则约束 AI 的回答先给下一步行动、多步骤编号、不跑题、给具体耗时。为了让 Cursor 用户也能用上仓库维护了一份.cursor镜像副本——本文教你如何快速验证两份 SKILL.md 完全一致。为什么 i-have-adhd 需要双份 SKILL.md项目里有两个 SKILL.md角色路径说明规范源Source of Truthskills/i-have-adhd/SKILL.md全部 10 条 ADHD 友好规则的唯一真相Cursor 镜像副本.cursor/skills/i-have-adhd/SKILL.mdCursor 扫描目录下的兼容副本AGENTS.md 的仓库地图中明确写着镜像副本要keep it synchronized with the canonical skill与规范源保持同步。⚠️ 两份文件一旦不一致Cursor 用户拿到的就是旧版规则——比如漏掉列表不超过 5 条这类约束输出风格就会跑偏。黄金法则先改规范源再同步镜像AGENTS.md 的 Source-of-truth rules 一节给出了铁律Changeskills/i-have-adhd/SKILL.mdfirst when changing skill behavior, then synchronize the.cursormirror.翻译成人话任何规则改动只先动skills/i-have-adhd/SKILL.md改完后再把内容复制到.cursor副本永远不要反过来只改.cursor那份最快同步步骤cp cmp 两条命令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命令作用成功表现cp用规范源覆盖 Cursor 副本无输出退出码 0cmp逐字节比对两份文件完全一致时无任何输出这里的关键细节是cmp的静默即胜利特性只要两份文件字节级相同它什么都不打印。所以没报错 验证通过反而容易让人不放心。cmp 没输出教你确认验证真的通过了cmp属于 POSIX 标准工具macOS、Linux、Git Bash 环境都自带。建议这样跑验证把结果可视化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 echo ✅ 两份 SKILL.md 完全一致输出✅ 两份 SKILL.md 完全一致→ 镜像同步成功输出cmp: 1: differ之类的差异信息 → 同步失败检查是否复制错了源文件不想用的话直接看退出码也行echo $?返回0表示一致返回1表示存在差异cmp还会指出第一个不同的字节位置方便排查。什么时候必须做这个验证按 CONTRIBUTING.md 的提交规范以下场景都要走一遍cpcmp修改了 10 条规则中的任何一条比如调整时间估算的表述调整了 SKILL.md 顶部的 frontmattername、description等元信息修改了 Pre-send check 等自检清单PR 描述中必须写明执行的精确验证命令——把cmp命令和结果贴进 PR 是硬性要求另外别忘了skills/i-have-adhd/目录下还有 agents/gemini.toml 和 agents/openai.yaml 等平台适配文件。只要改动涉及共享的名称、描述或路径CONTRIBUTING.md要求一并复查这些清单文件保证各平台元数据对齐。配套验证提交前的完整检查清单除了镜像比对AGENTS.md 的 Verification 一节列出了与改动相关的完整验证命令按需运行python3 -m unittest discover -s tests -v # 单元测试 python3 scripts/run_evals.py validate # 评估用例校验提交前再顺手跑git diff --check确认没有误改无关文件比如手滑动了.cursor目录之外的配置。常见问题速查Q我能只改.cursor副本让规范源保持原样吗不能。规范源是唯一事实来源改副本属于逆向同步下次从规范源覆盖时改动会直接丢失。Qcmp提示找不到命令怎么办它是 POSIX 标准工具绝大多数环境自带Windows 用户可在 Git Bash 中执行。Q同步后 Cursor 里没生效Skill 在会话启动时建立索引同步完成后开一个新会话即可详见 INSTALL.md 的故障排查一节。小结一句话记住 i-have-adhd 的镜像同步实践只改规范源 →cp覆盖副本 →cmp静默验证 → 把命令和结果写进 PR。整套流程不到 10 秒却能保证每个平台的用户拿到的 ADHD 友好规则始终一字不差。下一步行动clone 仓库后立刻在根目录跑一遍上面的cpcmp组合亲眼看到静默通过你就掌握了这套验证方法。【免费下载链接】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),仅供参考