关于 breaking-changes
用于检查 Claude Code 更新对插件 API 兼容性影响的技能。它将跟踪的 API 范围与官方变更进行比对，并按严重程度标出受影响的插件位置。
主要功能
- 01跟踪 Claude Code API 范围
- 02比对官方 API 更新
- 03搜索插件中的受影响 API
- 04报告文件和行号影响
- 05按严重程度分类变更
适用场景
- 01Claude Code 更新后检查插件
- 02定位已删除或变更的 API 用法
- 03审查已弃用和新增的 API
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/breaking-changes确认已加载。
详细介绍
通过将当前 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