OpenAI 升级到 GPT-5.5

本指南用于明确要求将既有集成升级到 GPT-5.5 的任务，默认目标为 gpt-5.5。迁移判断应结合当前官方模型和参数资料。

升级原则

先替换模型字符串，仅修改与对应调用直接相关的提示词，采用最小安全变更。较早或含义不明的使用点可能被有意固定，例如历史文档、示例、测试、评测基线、模型比较，以及低成本回退或路由分支。除非用户明确要求全部升级，否则保持这些位置并列为待确认。

尽可能采用提示词层面的升级。若涉及 API、更换提供商、重写参数、重新连接工具或更广的实现修改，应标出阻塞，不把模型升级扩展成其他迁移。

查找模型字符串、客户端调用和关联提示词，包括内联文本、模板、YAML／JSON 配置、Markdown 与已保存提示词。
为每个调用匹配最近的提示词：内联 system／developer、相邻提示文件、共享模板。无法可靠匹配时记录不确定性。
识别来源：GPT-5.4、GPT-5.3-Codex／GPT-5.2-Codex、更早 GPT-5.x、GPT-4o／GPT-4.1、o 系列、第三方模型，或混合来源。
分类为仅换模型、模型加轻量提示词修改，或无需代码改动就无法升级。
检查当前宿主是否接受 gpt-5.5，以及结构化输出、工具 Schema、函数名与下游解析器能否保持。长任务与工具型 Responses 还要检查 phase。依赖实现修改时为 blocked，信息不足时为 unknown。
对范围内位置执行最小改动。首轮先保持当前可见的推理力度，除非已有测量说明需要变化；被阻塞或不明确的位置不直接修改。
汇报当前使用点、模型更新、推理处理、提示词修改、结构化输出与格式评估、工具评估、必要时的 phase 评估、兼容检查和实际验证。

每个位置都要说明起始推理建议。能看到当前设置时先保留；看不到时，不主动新增设置，除非当前官方资料明确要求。

来源是 GPT-5.4，提示词已经简短、明确且边界清楚，工作流不依赖需要专门验证的严格格式、工具行为、批量完整性或长时程执行，也没有明确兼容阻塞时，可仅替换模型。

改为 gpt-5.5，保留推理力度与提示词，用已有测试、实际任务抽查或已有评测集验证。

适合需要加强完整性、引用、验证、依赖处理，或新模型回答过长、过密、不易浏览的工作流。严格输出格式缺少明确合同、Schema 或解析验证，研究结果稀疏或为空，以及仍可沿用 API 和工具定义的编程／终端／多智能体任务，也属于需要检查的情形。

首轮保留原推理力度，只针对观察到的风险调整最少提示词，并参考GPT-5.5 提示实践：

不要顺带重写无关提示词。长 Responses 任务如果使用开场消息或多条 assistant 消息，需检查 phase；补建该处理需要改代码时，应说明阻塞。现有工具流程不能仅因示例简短就被判为不可升级。

以下情况需明确指出范围外工作：API 变化、实现内参数或推理设置改写、工具定义／处理器／Schema 变化，IDE／插件／Shell／环境迁移，提供商专有接口改造，或无法定位调用对应提示词。

不自行扩大升级范围；说明具体阻塞，并在有帮助时给出解除阻塞所需的最小后续任务。

升级前核对八项：

第1项不成立、第3—4项要求实现工作，或第7项缺失且需改代码时，返回 blocked。第2项无法确认时为 unknown，等待补充具体提示词位置。

工具、智能体和多个调用点本身不是阻塞。相同 API 与工具定义能够继续使用时，优先考虑模型加轻量提示词修改。没有任务级测量，不能宣称节省词元。

允许修改或建议模型字符串及直接关联提示词，读取相关实现和提示文件，检查已有 phase，标出兼容阻塞，并提出用已有测试、抽查或评测集验证的计划。

不包含更换 API、迁移 SDK／IDE／Shell 钩子／插件／提供商工具，重写参数结构，修改工具定义与结果处理，改变结构化输出接线，补建 phase，或重写业务与编排逻辑。安全迁移若需要这些变化，应另列实施任务。

有 GPT-5.4 基线时与其对照，使用已有测试、实际任务或现成评测。检查任务成功率、重试次数、工具调用次数、总词元、延迟、输出结构和用户可见质量。

针对专用流程，优先验证其关键合同；不要仅凭回答“看起来更好”判断成功。新增提示块应解决明确问题，存在下游影响时完成针对性验证。