i-have-adhd破坏性变更指南Issue、迁移路径、兼容性计划三件套完整解析【免费下载链接】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 停止废话轰炸的 Skill 插件输出 ADHD 友好格式的代码答案。这个项目的破坏性变更Breaking Change流程堪称开源协作范本先开 issue 讨论 → 给出迁移路径 → 附兼容性计划三件套缺一不可。本文带你用 5 分钟看懂它如何保护每一位老用户。什么算破坏性变更对 i-have-adhd 这类多平台 Skill 插件来说以下改动都可能伤到现有用户来源CONTRIBUTING.md破坏性变更类型举例说明移动规范 Skill 文件把SKILL.md挪到新目录改变调用或 Hook 语义/i-have-adhd命令行为变了改变 Manifest 或安装命令平台清单字段改名移除受支持的平台不再支持某个 CLI 环境项目明确要求除非破坏性变更被明确接受必须保留现有安装方式、调用名称、文件位置、opt-in 行为和支持的集成。三件套之一Issue 先行大行为变更、新集成、新 Hook、潜在破坏性改动必须先在 issue 里讨论CONTRIBUTING.md 第 38 行。这样做的好处️ 用户和贡献者能提前表达顾虑而不是上线后才骂街 迁移路径在写代码之前就被设计好️ issue 打上规范标签Target:组如Target:Integrations、Author:组、Workflow:组如bug、enhancement见 CONTRIBUTING.md 的标签规范三件套之二迁移路径一个合格的破坏性变更 PR必须写清楚用户怎么无痛升级。例如项目内置的迁移步骤示例README.md Tune it 章节卸载上游副本claude plugin uninstall i-have-adhd移除市场源claude plugin marketplace remove i-have-adhd添加你的源claude plugin marketplace add your-username/i-have-adhd重新安装claude plugin install i-have-adhdi-have-adhd迁移路径要满足两个条件可执行命令能直接复制运行和可回滚PR 模板中的 Migration or rollback notes 专门留了位置。三件套之三兼容性计划官方态度很明确优先采用增量式、分阶段变更Prefer additive, staged changes能分两步上线就别一刀切。兼容性计划还包含这些硬性要求同步规范镜像skills/i-have-adhd/SKILL.md是唯一事实源改它必须同步 Cursor 副本CONTRIBUTING.md审查平台 Manifest共享名称、描述、路径或行为变化时检查opencode.json、plugin.json、qwen-extension.json、kimi.plugin.json、gemini-extension.json等清单文件更新文档INSTALL.md 及 AGENTS.md 中的多语言文档都要保持准确PR 模板里的兼容性检查清单每个 PR 都要在 pull_request_template.md 中勾选兼容性声明核心是这两道互斥题这不是破坏性变更这是破坏性变更已讨论且迁移/弃用文档附在下方另外两项规范与镜像 Skill 文件已同步相关平台 Manifest 与安装文档已审查勾错任何一项维护者有权直接关闭 PR——模板末尾的 Final accountability 部分要求提交者对完整 diff 负责。兼容性如何验证i-have-adhd 用一套评测 门禁机制兜底运行最小相关检查python3 -m unittest discover -s tests -v、python3 scripts/run_evals.py validateAGENTS.md行为变更跑评测按 evals/rubric.md 的评分标准对比基线与候选版本正确性和安全性必须与基线持平加权分必须更高才允许发布隔离验证加载Hook 或插件变更要在隔离配置目录里验证加载行为一张表看懂完整流程步骤动作产出物1️⃣ 立项开 issue 讨论变更理由与影响面带标签的 issue2️⃣ 设计写出迁移路径 兼容性/弃用计划方案写入 issue3️⃣ 实现优先增量式、分阶段改动PR 勾选兼容性清单4️⃣ 验证跑测试、评测、隔离加载检查命令与结果写进 PR5️⃣ 发布同步文档、Manifest、镜像用户按迁移步骤升级结语i-have-adhd 的破坏性变更流程给所有开源项目上了一课破坏性变更不可怕没有预警的破坏性变更才可怕。Issue、迁移路径、兼容性计划三件套加上 PR 模板的强制检查项让老用户始终知道会发生什么、怎么升级、如何回滚。这套机制值得一并借鉴到你的项目中。【免费下载链接】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），仅供参考