技能提升网供应商公告写明旧版本将在三十天后停用。主服务已经切到新调用方式，移动端后台脚本、数据管道和内部工具里却还散落着不同封装，配置文件也没有统一的版本说明。
本篇以 Claude API 的版本迁移作为可核验案例。AI可以帮助查找调用和对照当前说明，但不能把一次检索结果当作完整资产清单，更不能自动替换密钥或直接切生产。
先把公告变成迁移约束
记录停用对象、最后可用日期、目标版本、SDK最低版本、请求字段变化、响应差异、速率或计费影响以及回退限制。只保存公告链接不够，团队需要一份能用于代码审查和测试的差异表。
检索范围要超出显眼的SDK调用
- 源码中的客户端初始化、模型或版本字符串
- 封装库、共享模块和生成代码
- 环境变量、部署配置与任务调度
- 网关、代理、日志和监控规则
- 示例脚本、数据管道、移动端后台和内部工具
静态搜索找不到动态配置和已部署旧任务。调用日志能补充真实流量，但没有流量也不能证明代码不会在月底或故障时触发。
按依赖和风险分批迁移
| 批次 | 对象 | 验证重点 |
|---|---|---|
| 试点 | 低风险内部工具 | 请求、响应与错误处理 |
| 共享层 | 公共封装和SDK | 下游兼容与回退 |
| 核心调用 | 生产主链路 | 容量、延迟和业务结果 |
| 长尾清理 | 定时任务与备用路径 | 停用旧配置和告警 |
每批都保留调用样本、测试结果、代码评审和生产回读。发现响应结构或错误语义变化时，应阻断扩大，而不是靠兼容层静默吞掉。
先用少量资料把判断链跑通
不要一开始就把整个批次交给模型。挑一组正常项、一组明确异常和一组边界不清的样本，确认字段能对应、规则不会互相覆盖，再扩大范围。小样本的目标不是证明模型聪明，而是发现资料缺口和误判方向。 对本任务，首轮只验证能否可靠支持这一判断：哪些调用受影响、迁移顺序是什么、哪些差异必须阻断上线。
角色：维护外部 API 集成的研发负责人。
触发：供应商宣布旧版本停用，代码、配置和文档中存在分散调用。
资料：停用公告与迁移指南、代码仓库、配置与环境变量、调用日志、测试环境。
判断：哪些调用受影响、迁移顺序是什么、哪些差异必须阻断上线。
交付：受影响调用清单、兼容性差异、迁移批次和验证结果。
要求：逐条列出证据、未知项、规则冲突和需要谁确认，不执行任何高风险写入。
扩大处理范围前先做反向抽查
| 能力步骤 | 接收资料 | 交给下一步 |
|---|---|---|
| 按当前官方接口说明核对模型、SDK 和请求写法 | 停用公告、当前调用和目标版本 | 接口差异与迁移要求 |
| 跨仓库查找调用、配置、Issue 和迁移 PR | 代码仓库与调用关键词 | 受影响位置、任务与验证状态 |
除了核对被标红的项目，还要从模型判定正常的结果中随机抽查。只看异常会漏掉最危险的假阴性。抽查发现同类遗漏时，应回到规则和输入修正，并重跑整个受影响范围。 验收终点应是可以交接的受影响调用清单、兼容性差异、迁移批次和验证结果。
出现这些情况就停止自动处理
- 关键文件缺少版本、时间范围或唯一编号，无法确认是否属于同一任务
- 多个资料来源给出冲突事实，且没有被授权的基准可以裁决
- 结果会触发付款、权限、合同、生产、薪酬或对外承诺等高风险动作
- 可能造成的后果是遗漏隐蔽调用导致停用日生产中断，或误改未受影响模块扩大回归范围
停止自动处理不等于停止工作。保留已经完成的证据整理，标出阻塞位置、责任人和期望回复时间，让人工从明确节点接手并继续完成受影响调用清单、兼容性差异、迁移批次和验证结果。
两个Skill如何形成闭环
Claude API Skill负责按当前官方说明核对Claude API请求、SDK和目标版本要求；Github Skill负责跨仓库查找调用、配置、Issue和迁移PR。两项能力的输出要前后衔接，不能只把同一份材料重复总结。
本题以 Claude API 作为可核验案例，不扩写成所有第三方接口；迁移代码、密钥和生产切换必须经过测试与评审。
