这个提示词用来做什么
依赖的模型或接口发布新版本，变更说明里夹着一批破坏性变更，需要在不影响线上的前提下完成迁移
提示词全文
我要把一个线上服务从 {旧版本} 迁到 {新版本}，官方变更说明里列了一批破坏性变更。请把它拆成可以照着做的迁移清单，不要复述官方文档。
## 输入
变更说明原文：{贴入官方 release note 或变更日志里与破坏性变更相关的段落}
当前用法：{我们实际用到的接口、参数、流式方式、工具调用定义等}
体量与时限：{涉及多少处调用、多少个服务、能接受多长的迁移窗口}
可观测手段：{有没有请求日志、评测集、灰度开关}
## 输出
1）影响面分类：把变更按「必然影响 / 条件影响 / 不受影响」分三类，每条给出判断依据——我们是否真的走到了这条路径，而不是看变更说明怎么写。
2）逐条动作：每条变更给出「要改哪个文件或配置 → 改成什么 → 怎么验证改对了」，其中需要靠实验才能确认的部分明确标出来，不要给出看起来很确定但没有依据的结论。
3）静默失败清单：单独列出不会报错、只会让行为变样的变更（例如默认参数变化、返回结构多一层、流式输出里少了某些片段），逐条说明靠什么信号才能发现。
4）灰度与回滚：给出切换顺序（先读后写、先内部后线上、按流量比例如何推进），以及每一步的回滚条件。
5）验收：给出上线前必须跑通的最小检查项，以及上线后 24 小时内要盯的指标。
怎么用
- 把上面的提示词全文复制到对话窗口或工作流里。
- 把花括号占位符（如 {任务描述}）替换成你自己的内容。
- 条目越具体，产出越稳定；不需要的条目可以直接删掉。
输出示例
输出会把变更分成必然影响 / 条件影响 / 不受影响三类并逐条给出判据；每条变更都落到「改哪里 → 改成什么 → 怎么验证」，需要实验确认的部分单独标出；单列一份静默失败清单，点名默认参数、返回结构与流式片段这类不报错的变化及对应的发现信号；给出先读后写、按比例放量的灰度顺序与每步回滚条件；给出上线前最小检查项与上线后 24 小时的监控指标。
基本信息
- 分类：编程
- 标签：破坏性变更 · 迁移清单 · 灰度切换 · 回滚条件 · 版本升级
- 收录日期：2026-09-23