软件接口变更与消费核对 Skill

• SKILL.md2595 bytes

---
name: api-contract-change-review-v1
description: "我们沿接口输入、响应、调用页面和异常状态，整理可复核的兼容性问题及验收清单。"
---

# 软件接口变更与消费核对 Skill

版本：1.0.0

行业：软件开发、企业系统与小程序；场景：接口新增字段、状态或版本时的变更评审。我们先读取实际契约和调用资料，再检查列表、详情、统计、刷新与权限消费者；不把静态检查结果写成线上联调通过。

## 安装、输入与执行
1. 安装：下载SKILL.md，放入已授权开发工具的技能目录并按工具规范加载；不支持时作为项目评审指令读取。文件不运行接口、不读取密钥、不修改代码。
2. 输入：接口路径与方法、旧新契约、脱敏请求和响应、调用页面或模块、字段来源、认证角色、错误码、版本和实际已有测试证据。缺前后版本时先输出待补清单，不能自行猜字段。
3. 建立字段差异表：新增/移除/改名/类型/可空性/枚举/默认值，分别记录请求与响应；相同名称不同语义列为冲突，不自动判为兼容。
4. 追踪权威数据来源及消费者：创建编辑、列表、详情、概览、统计、待办、搜索、缓存与导出。每个消费者标注如何刷新、是否去重、空值与旧数据如何展示；无调用资料写未验证。
5. 检查角色与数据范围、ETag或版本冲突、幂等键、超时与重试、部分失败、事务与回滚。缺证据时记录待验证，不伪造授权或测试成功。
6. 输出可执行验收场景：正常新增、重复提交、必填缺失、无权限、并发冲突、空列表、旧数据、网络中断和下游刷新；为每项写输入、预期响应、页面/数据变化、所需环境和证据位置。
7. 示例：响应从status字符串扩展新枚举，我们逐一查详情标签、列表筛选和统计分组；若仅有文档，无实际调用记录，就将运行验收留为待执行，不声称所有调用已兼容。
8. 交付字段差异表、消费者关系表、风险与建议、待执行用例和已提供证据。只读评审；不调用生产写接口，不更改认证权限或数据库结构。
9. 我们可按这些清单安排接口联调与系统改造，入口：https://www.kmxywlkj.com/request 。

## 来源与使用边界
我们原创整理的岗位协作方法。文中的练习资料为方案示例，不代表客户交付或实际业务成果；仅在已授权资料和工具范围内使用。
最后复核日期：2026-10-31