关于 breaking-changes
breaking-changes 是面向 Claude Code 插件维护者的技能，用于比对 API 变化与插件用法，并按严重程度报告受影响的位置。
主要功能
- 01比对 Claude Code API 与参考清单
- 02检查插件中的 API 使用
- 03标出影响文件及行号
- 04按严重程度分类变更
适用场景
- 01检查插件与 Claude Code 更新的兼容性
- 02定位受已移除或变更 API 影响的代码
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/breaking-changes确认已加载。
附带文件references/api-surface.mdreferences/templates/migration-guide.md
详细介绍
通过将当前 API 表面（钩子类型及其匹配器、Agent frontmatter 字段、插件清单架构、SKILL.md 格式、脚本 CLI 标志，记录在 `references/api-surface.md` 中）与官方变更日志进行比对，检测 Claude Code 更新中的破坏性变更。针对每项变更 API 搜索我们的插件，并报告其影响对应的具体文件:行号位置，同时按严重程度分类（BREAKING / DEPRECATED / NEW）。
破坏性变更检测技能
概述
将 Claude Code API 变更与我们的插件生态系统进行比对，以检测兼容性问题。
API 表面文件
api-surface.md 参考文件包含我们当前已知的 API：
- 钩子类型及其匹配器
- Agent frontmatter 字段
- 插件清单架构
- 技能 SKILL.md 格式
- 使用到的脚本 CLI 标志
检测工作流
- 加载当前 api-surface.md
- 获取最新的 Claude Code API 文档
- 比对新增、更改或移除的 API
- 搜索我们的插件中是否使用了每项变更 API
- 报告影响及对应的文件:行号位置
影响评估
| 变更类型 | 严重程度 | 示例 |
|---|---|---|
| 移除 API | BREAKING | 钩子类型被删除 |
| 架构变更 | BREAKING | Frontmatter 字段重命名 |
| 新增必填字段 | BREAKING | 新增必填参数 |
| 弃用 API | DEPRECATED | 旧钩子仍可使用 |
| 新增可选 API | NEW | 新增钩子类型 |
参考
评论
支持 Markdown