真实代码库工程能力进阶官方难度：Intermediate1h

原题：Upgrade your API integration

升级 API 集成

让 Codex 检查现有 API 调用并迁移到新的推荐集成方式。

官方概览

让 Codex 检查现有 API 调用并迁移到新的推荐集成方式。

这篇官方 use case 的核心，是把「升级 API 集成」从一个模糊请求变成可执行、可验证、可交接的 Codex 工作流。

使用时不要只描述最终愿望，还要告诉 Codex 输入来源、目标产物、约束条件、验证方式和需要人工确认的动作。

适用场景

适合需要在真实代码库中推进工程任务，并保留构建、测试或回归验证的场景。
适合希望围绕「升级 API 集成」建立标准化 prompt、交付物和验收流程的用户。

推荐工作流

这个场景属于「真实代码库工程能力」。建议把它当成一个有输入、有过程、有验收标准的任务，而不是一次开放式聊天。

1说明任务目标、输入来源、权限范围和不应触碰的内容。
2让 Codex 先读取相关上下文，并输出一版执行计划或信息结构。
3按可 review 的小步骤推进，每一步都保留证据、链接、命令输出或检查结果。
4对外部动作和高风险改动先生成草稿或计划，等待人工确认。
5完成后要求 Codex 总结交付物、验证结果、风险和下一步。

内容拆解

你可以把这类任务拆成三层：先收集上下文，再生成结构化产物，最后做验证和交接。

上下文包括仓库、文档、消息、数据、会议纪要、issue、日志或设计资料；结构化产物可以是代码、清单、报告、草稿、playbook、测试记录或修复计划。

验证方式应该提前定义，例如构建通过、测试通过、截图对比、数据可复核、链接有效、风险项已标注，或等待人工审批。

交付与验收

交付时应能回答三个问题：Codex 做了什么、依据是什么、结果如何验证。如果还有不确定信息，应明确列入待确认事项。

输出清晰的执行记录和关键链接。
列出成功、失败、跳过和需要人工确认的事项。
给出下一步建议，而不是只说任务完成。

官方 Starter Prompt 中文翻译

请帮我完成「升级 API 集成」。

目标：让 Codex 检查现有 API 调用并迁移到新的推荐集成方式。

执行要求：
- 先确认输入来源、权限范围、目标产物和不能触碰的边界。
- 如果需要读取邮件、消息、文档、代码、数据或外部系统，先说明你会读取哪些来源。
- 把任务拆成可验证的小步骤，每一步都保留依据和结果。
- 涉及发送、发布、删除、创建、分配、付款或修改外部系统前，必须先停下来让我确认。
- 完成后输出执行记录、交付物、验证结果、剩余风险和建议的下一步。