SuperAPI AI 工具集

breaking-changes-management

编程与开发

查看项目

更新于 10-16 03:47

技能介绍

用途:当行为、接口、配置或兼容性契约发生可能破坏使用者的变更时使用本技能,覆盖发布主版本、重命名或移除公开 API、修改请求或响应结构、替换配置键、环境变量、CLI 参数或文件格式,以及撰写迁移说明、弃用通知与升级清单等场景。

主要能力:以“症状→动作”触发;先定位使用者可见的具体破坏点,说明受影响对象及起始版本,给出替代路径或缓解方案,补充变更前后示例,并更新 CHANGELOG.md 及相关安装、使用文档。要求产出带明确 BREAKING 标记的变更日志条目、包含旧用法、新用法与升级步骤的迁移指南、延迟移除时的弃用时间线,以及对改动示例或脚本的验证说明。

使用方式:技能可跨 GitHub Copilot、Claude Code 与 Codex 使用。Copilot 需将目录置于其可见的技能路径,或在不支持目录发现时写入项目说明;Claude Code 置于本地技能目录或兼容插件源;Codex 需同步到 $CODEX_HOME/skills/breaking-changes-management,并在重大改动后重启。无需 MCP 服务器;回退提示为:“Use the Breaking Changes Management skill without MCP. Rely on its local instructions, bundled resources, standard shell or editor tools, and direct verification. Show the evidence used before concluding.” 宿主未提供 MCP 时不得声称使用了 MCP 操作,应以本地文件、测试、渲染输出、日志或截图作为证据。

限制与注意:需避免在成功标准不明确时开工、把验证当作可选的收尾、把规划、实现与发布混为一跳。声称应用成功前须通过验证协议:从明确的成功标准、约束与停止条件出发,先收集必要证据再作完成或就绪声明,按既定顺序推进且不跳过审查与验证步骤。资料另提及迁移指南脚手架脚本与弃用流程文档,但未给出具体命令内容,暂未提供。