用途:在 API 变更发布前,判断该变更属于向后兼容、条件兼容还是破坏性变更,并让这一状态在交付前显式化。
主要能力:对比旧契约与新契约的结构;识别被删除或行为发生变化的字段;评估已知消费者的受影响程度;输出兼容性评估(compatible / breaking / unsafe)、明确的破坏性变更清单,以及建议(proceed、version、block)。检查项包括枚举所有删除与类型变更,并保证结论明确且有依据。
使用方式:输入旧契约、新契约,以及已知消费者(如有)。工作流为:比较新旧契约形态,识别删除或行为变更字段,评估消费者影响,输出清晰的兼容性结论。遥测记录 skill: api/compatibility-check、verdict、affected_consumers、outcome。
适用场景:API 版本升级、契约变更评审、发布前兼容性把关。
限制:不修改契约、不更新客户端、不实现迁移。缺少基线契约时会阻断并要求提供;变更含义不明确时建议改用 meta/spec-sculptor。具体安装命令与平台支持暂未提供。