用途：帮助团队在不破坏现有客户端的前提下安全演进 API，规划版本化、弃用时间线、客户端迁移与兼容方案。
主要能力：版本化策略对比，包括 URL 版本（/api/v1/users、/api/v2/users，清晰易路由但 URL 易被版本污染）、Header 版本（Accept: application/vnd.api.v1+json，URL 干净但更难测试与可见）、查询参数版本（/api/users?version=1，易实现但不够 RESTful 且易遗漏）。提供弃用时间线模板（约 6 个月：公告、迁移期、最后警告、下线），弃用响应头示例（Deprecation、Sunset、Link、Warning），并明确 410 Gone 的返回方式。区分非破坏性变更（新增端点、可选参数、响应字段、状态码、必填改可选）与破坏性变更（删除端点/参数/响应字段、改字段类型、必填化、改认证）。提供迁移指南模板（认证、响应格式、分页等变更及逐步替换示例）、向后兼容策略（并行版本、适配器模式、功能开关）、客户端沟通邮件模板、迁移进度监控指标与回滚计划，附输出检查清单。
使用方式：按该技能的检查清单选定版本化策略、撰写弃用时间线与迁移指南、准备沟通与监控、配置回滚。示例测试命令保持原样：curl -H "Authorization: Bearer xxx" https://dev-api.example.com/v2/users。
适用场景：已有公开或内部 API 需要发布新版本、下线旧版本、统一客户端迁移节奏的团队。
限制：资料未说明该技能的具体运行环境、安装命令、收费与支持平台，暂未提供；是否可直接执行需以实际环境为准。