SuperAPI AI 工具集

breaking-changes

编程与开发

查看项目

更新于 10-26 16:20

技能介绍

用途:用于回答“Claude Code 的一次更新是否会破坏我们的插件生态”这类问题,检测范围包括 hooks、agent frontmatter、插件 manifest schema 和 skill 格式。

主要能力:

  1. API 快照对比:技能内置 api-surface.md 参考文件,记录当前已知的 API 范围,其中包括各类 hook 类型及其 matcher、agent frontmatter 字段、插件 manifest schema、技能 SKILL.md 格式,以及脚本用到的 CLI 参数。
  2. 差异检测:加载当前的 api-surface.md,获取最新的 Claude Code API 文档,对比新增、变更和移除的 API。
  3. 影响定位:针对每一项发生变更的 API,在插件仓库中进行文本检索,并输出带 file:line 的影响映射报告。

使用方式:按资料描述的检测流程执行,即加载 API 快照,获取最新 API 文档,做差异对比,再逐项检索插件代码并生成影响报告。资料未提供具体安装命令与调用参数。

影响评估分级:移除 API 时为 BREAKING,例如 hook 类型被删除;schema 变更时为 BREAKING,例如 frontmatter 字段被重命名;新增必填字段时为 BREAKING,例如新增强制参数;API 被弃用但旧 hook 仍可用时为 DEPRECATED;新增可选 API 时记为 NEW,例如新增 hook 类型。

适用场景:在升级 Claude Code 之前进行兼容性评估、维护插件生态、审查 hooks 与 manifest 变更带来的潜在风险。

限制:资料仅给出分类与工作流框架,未提供实际检测脚本、安装方式、支持平台或效果数据,这些内容暂未提供。