用途
该技能旨在帮助开发者平台在已知的变更日期（如版本日落、SDK 生命周期结束、凭证过期、负载版本退役等）之前，找出那些目前仍能工作但届时将失效的第三方集成，并推动每个集成的负责人优先迁移。其核心交付物包括：一份列出所有面临风险的集成及其可修复负责人的普查清单、一个能触达这些负责人的通知循环，以及一个表明何时可以安全关闭旧接口的门控机制。
主要能力
- 构建风险日期目录：将每个前瞻性风险记录为一行，包括受影响的接口、失效日期、替代方案以及识别仍依赖该接口的信号的标识。
- 归因流量到集成和所有者：基于平台颁发的凭证（如 API 密钥 ID、OAuth 客户端 ID、应用 ID）在网关处记录每个请求的集成身份，并附加客户端指纹作为提示。同时测量未归因流量的比例。
- 构建漂移普查：为每个集成与每个目录中风险的组合生成一行记录，记录实际提供的版本（而非账户默认版本），并根据最长业务周期设置回溯窗口。
- 按紧急程度和影响范围排序：优先按距失效天数分桶，再按受影响的终端客户数量排序，并考虑商业权重（如合同条款、惩罚、战略账户）。
- 关闭新入口，发送并验证通知：在通知日停止新集成使用旧接口（仅限制新的集成身份，而非凭证），并向所有已知联系人发送通知，同时验证联系信息。
- 运行通知阶梯：根据集成个体（而非公告）逐级升级通知，包括定向邮件、响应内警告、客户管理员通知、命名外联和灰度停服（brownout）等。
- 烧尽并门控日落：跟踪旧接口的调用量和仍在使用旧接口的集成数量两条曲线，直到失效日期，并设置门控条件以确保安全关闭旧接口。
使用方式
该技能通过一系列步骤执行：首先进行访谈以收集关键信息（如哪些变更何时发生、流量归因覆盖率、集成类型、联系方式、最长业务周期、替代方案稳定性、截止日期与资源等）；然后依次执行构建风险日期目录、归因流量、构建漂移普查、排序、关闭新入口并发送验证通知、运行通知阶梯、烧尽并门控日落等七个步骤。每一步都有详细的操作指导和参考文件（如 references/signal-catalog.md 和 references/notification-templates.md）。
适用场景
适用于开发者平台、API 提供商、SaaS 平台等需要管理大量第三方集成的场景，特别是在计划进行 API 版本升级、SDK 退役、凭证轮换或接口变更时，用于确保所有集成都能及时迁移，避免业务中断。
限制
该技能不处理当前正在失败的集成（属于 integration-error-observability），也不制定弃用政策本身（属于 api-versioning-policy）。它假设平台已有一定的流量归因能力和联系人管理基础。对于未归因的公共接口流量，只能通过响应内警告和灰度停服来触达，无法直接通知。联系方式的验证可能需要额外流程，且通知窗口受政策约束。