用途:验证 API 提供方与消费方在 schema、语义、兼容性和演进策略上的契约一致性,并对现有方案、结果或证据做风险评审,形成可执行改进项。输入不完整时,先给出带假设和信息缺口的可用初版。
主要能力:覆盖字段与类型、必填与可空、枚举、状态码、错误体、兼容性、版本演进和消费者影响;按风险与证据强度排序,区分已确认事实、合理假设和待确认问题;破坏性变更必须给出迁移路径。
使用方式:先阅读并遵循 prompts/api-contract-testing.md 的输入、执行规则、最低覆盖清单和输出顺序;补充影响判断的范围、环境、版本、限制、证据和成功标准;先做输入审计,再产出可直接执行、评审或验证的结果。默认输出 Markdown,用户要求表格、CSV、JSON 或工单格式时保留同样的风险、证据、优先级和边界字段;若输出进入自动化流程,先确认字段 schema、枚举值和必填项。评测或回归时读取 evals/eval.yaml 与匹配的 evals/cases/ 用例;仅在目录实际存在且任务需要时读取 references/、examples/、scripts/ 或 output-formats.md。
适用场景:API 契约测试、消费者期望验证、schema 变更风险评估、发布前兼容性评审。
限制:契约不仅是 schema,还包括语义和错误行为;不凭样例推断完整契约;不编造输入中不存在的系统行为、字段、数据、指标或根因;关键结论必须关联证据,证据不足时标记为假设并给出验证方法;不执行未经授权的生产写操作或破坏性动作。具体安装命令、价格与平台支持暂未提供。