闲社

标题: 【工作流】接口契约漂移工作流 [打印本页]

作者: admin 时间: 昨天 21:15
标题: 【工作流】接口契约漂移工作流
[md]
# 接口契约漂移工作流

## 套餐描述

将 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 接入、代码修改、通知、版本发布、回滚实施、持续维护或结果保证。

## 套餐图标

## 包含技能

- [接口变更影响映射](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)**
[/md]

欢迎光临闲社 (https://www.xianshe.com/)