Cloud 做完任务,不等于你可以直接相信结果。你还要审查、带回本地、验证。
> 前置教程:第一次创建 Codex Cloud 任务
> 如果你还没有完成 Cloud 只读任务,先完成前置教程。
> 依据来源:OpenAI Codex 官方手册中关于 Codex cloud tasks、从 CLI 浏览和应用 Cloud 变更、IDE 预览 Cloud 变更、本地验证的说明。
Cloud 任务结果大致分两类:
| 类型 | 怎么处理 |
| ------ | --------------------- |
| 只读分析结果 | 作为后续任务上下文,不需要应用到本地 |
| 代码修改结果 | 必须审查 diff,再决定是否带回本地验证 |
前一篇我们做的是只读分析,所以不需要应用代码。
后续如果 Cloud 真的改了代码,你才需要“带回本地”。
第 1 步:先审查 Cloud 总结
Section titled “第 1 步:先审查 Cloud 总结”
不要第一眼就点应用。
先看 Cloud 的总结:
- 它做了什么。
- 改了哪些文件。
- 有没有运行检查。
- 检查是否通过。
- 有没有失败或剩余风险。
- 有没有超出任务范围。
如果总结很模糊,追问:
``
请重新总结这次 Cloud 任务:
- 修改了哪些文件。
- 是否只改了任务范围内的文件。
- 是否有无关格式化。
- 是否引入新依赖。
- 是否修改配置文件。
- 是否改了密钥、环境变量、CI 配置。
- 是否动了你没有授权的模块。
- 修改范围符合任务目标。
- 没有明显无关文件。
- 没有敏感信息。
- 检查结果可信。
- 你知道本地要怎么验证。
- 在 Cloud/Web 界面中查看或应用变更。
- 在 IDE 扩展里预览 Cloud 变更。
- 通过 CLI 的 codex cloud
相关能力浏览或应用任务结果。 - 通过 GitHub PR 拉到本地审查。
- 总结当前 Git 变更文件。
2. 每个文件为什么修改。
3. 哪些检查通过了。
4. 哪些检查没有运行,原因是什么。
5. 是否有超出任务范围的修改。
6. 剩余风险是什么。
`
代码修改必须看 diff。
你要检查:
如果 diff 太大,先不要应用。
问:
`
这次 diff 太大了。
请把修改拆成更小的提交建议,并说明哪些文件是必要修改,哪些可以撤回。
`
只有满足这些条件,才考虑带回本地:
如果不满足,先让 Cloud 继续修改或缩小范围。
根据你使用的入口不同,可能有几种方式:
具体按钮和界面会随版本变化,所以本教程不硬写某个固定按钮名称。
你要抓住原则:
`
先审查,再应用;先本地验证,再合并。
`
带回本地后,用 CLI 或 IDE 验证。
推荐用 CLI 做项目级检查:
`
请检查刚刚从 Cloud 带回本地的变更。
要求:
2. 判断是否有无关文件。
3. 根据项目现有脚本进行必要验证。
4. 如果检查失败,请判断是否由本次 Cloud 变更引入。
5. 不要提交代码。
`
如果只是当前文件的小改动,也可以用 IDE 看具体代码。
如果本地验证失败,先不要手改。
先让 Codex 分析:
`
Cloud 变更带回本地后验证失败。
错误信息如下:
【粘贴错误,隐藏敏感信息】
请判断: