|
# 接口契约漂移工作流
## 套餐描述
将 API 契约快照、破坏性差异、调用方影响和人工发布门禁串成可运行的四步工作流。
## 详细介绍
# 接口契约漂移工作流
**4个可下载技能 · 4步自动化工作流 · 每个技能可单独运行**
把 API 规范或响应结构的版本变化转成可审阅的发布门禁：先生成稳定快照，再分类破坏性差异，接着映射受影响调用方和验证任务，最后形成负责人可批准或回滚的人工门禁包。套餐只读本地脱敏契约，不拉取远程 API、不合并代码、不发布版本。
## 4步自动化工作流
### 1 接口契约快照整理
**对应技能：** `api-contract-snapshot-normalizer`
**解决什么：** 统一 API 版本、操作标识、方法、路径、必填参数和响应字段。
**你会得到：** READY/REVIEW 快照、操作清单和 `snapshot_hash`。
**流转到下一步：** 基线和修订快照进入模式差异分类。
### 2 接口模式差异分类
**对应技能：** `api-schema-diff-classifier`
**解决什么：** 区分新增操作、字段新增、操作删除、响应字段删除、类型改变和必填参数新增。
**你会得到：** PASS/REVIEW/BLOCKED、breaking_changes、non_breaking_changes 和 `diff_hash`。
**流转到下一步：** 差异分类进入调用方影响映射。
### 3 接口变更影响映射
**对应技能：** `api-change-impact-mapper`
**解决什么：** 把破坏性差异映射到调用方、负责人、发布时间窗和兼容性测试引用。
**你会得到：** READY/REVIEW、affected_consumers、unmapped_changes 和人工问题。
**流转到下一步：** 影响清单进入发布人工门禁。
### 4 接口发布人工门禁
**对应技能：** `api-release-gate-handoff`
**解决什么：** 汇总契约快照、差异、调用方、验证任务和回滚引用。
**你会得到：** READY_FOR_HUMAN_RELEASE/REVIEW、`decision=PENDING` 和 `executed=false` 的门禁包。
**流转到下一步：** 由负责人决定测试、批准、延期或回滚。
## 实际示例
示例使用 `[SPEC_A]`、`[SHOP_APP]` 和 `[SPEC_V2_SNAPSHOT]` 等脱敏引用；修订版本删除了 getOrder 的 total 响应字段，脚本会把删除标为破坏性变化并生成待人工决定的发布门禁。该结果是测试示例，不代表真实 API 已发布或调用方已验证。
## 适合谁
维护 OpenAPI、REST、GraphQL 或内部 API 的开发团队、平台工程师、SDK 维护者、集成负责人和发布审批人。
## 买家只需提供
- 已脱敏的基线和修订契约、版本、路径、方法、参数和响应字段
- 调用方、使用的 operation、负责人、发布时间窗和兼容性测试引用
- 发布政策、回滚快照引用和人工验收要求
## 使用方式
1. 使用 Python 3.10 或更高版本，删除 token、客户数据、内部域名和私有仓库信息。
2. 依次运行契约快照整理、模式差异分类、影响映射和发布人工门禁。
3. 用字段删除、类型变化、必填参数新增、可选字段新增和未登记调用方样例验收，再执行真实兼容性测试。
## 交付与验收
- 四个独立技能目录，均包含 `_meta.json`、`SKILL.md`、`agents/openai.yaml`、README、Python 执行器、文档和脱敏样例。
- 四步可重复运行；版本缺失、操作删除、响应字段删除、类型改变、必填参数新增和未登记调用方均有明确分支。
- 输出保留 snapshot_hash、diff_hash、影响清单、人工建议、PENDING 决策和 executed=false，不合并 PR、不发布规范、不调用远程 API。
## 服务说明
脚本只读买家有权使用且已脱敏的契约和依赖清单，不连接 API、Git、CI、调用方仓库或发布平台。差异分类不是完整的行业兼容性证明；负责人仍需用真实 schema、生成 SDK、回归测试和供应商版本政策确认影响。套餐不包含 OpenAPI 生成、CI 接入、代码修改、通知、版本发布、回滚实施、持续维护或结果保证。
## 套餐图标
<img id="aimg_R8rch" onclick="zoom(this, this.src, 0, 0, 0)" class="zoom" src="https://www.xianshe.com/data/attachment/hl_skillhub/images/bundle_icon_1_1787318125.png" onmouseover="img_onmouseoverfunc(this)" lazyloadthumb="1" border="0" alt="" />
## 包含技能
- [接口变更影响映射](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=skill-1787318140)
- [接口契约快照整理](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=skill-1787318140-2)
- [接口发布人工门禁](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=skill-1787318140-3)
- [接口模式差异分类](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=skill-1787318140-4)
## 安装方式
此套餐为**付费套餐**，购买后可一键下载全部技能。
🛒 [点击购买并下载 接口契约漂移工作流](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=buy&bundle_id=461)
## 收费方式
💴 **现金购买** - 需要支付 ¥178.00
## 前往安装
**[👉 点击前往套餐安装页面](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=bundle&ac=detail&slug=api-contract-snapshot-normalizer-04fc44030cb3)**
| 
喧嚣卡
千斤顶
