用途:在 Claude Code 更新后,对比其 API 变化与自有插件生态,检测兼容性问题,判断更新是否造成破坏性变更。
主要能力:以 api-surface.md 记录当前已知 API,包括 hook 类型及其 matcher、agent frontmatter 字段、插件 manifest schema、skill 的 SKILL.md 格式、脚本 CLI 标志。检测流程为:加载当前 api-surface.md;获取最新 Claude Code API 文档;对比新增、变更、移除的 API;对每个变更 API 在插件中执行 grep;输出带 file:line 的影响映射报告。
影响评估分级:移除 API 为 BREAKING(如 hook 类型被删除);schema 变更为 BREAKING(如 frontmatter 字段重命名);新增必填字段为 BREAKING(如强制新参数);弃用 API 为 DEPRECATED(旧 hook 仍可用);新增可选 API 为 NEW(如新增 hook 类型)。
使用方式:资料未提供具体安装命令或调用步骤,仅说明按上述检测工作流执行,并参考 API Surface 与 Migration Guide Template。
适用场景:维护 Claude Code 插件、hooks、agent 与 skill 的团队,在升级前评估兼容性风险。
限制:资料未提供价格、平台支持、实际效果或完整命令示例;具体实现细节与运行环境暂未提供。