Codex

用 Codex 完成第一处代码改动:从读仓库到验收

以修改一个空状态提示为例,练习限定范围、审阅差异和验证结果。

开始前准备

准备一个你有权修改的小项目、可用的 Codex 使用入口,以及项目的运行说明。本教程采用通用的仓库协作步骤,不绑定某个界面的按钮名称。使用前按官方文档完成登录与项目连接;账户可用功能以实际界面为准。

第一步:记录工作区起点

在项目目录运行下面的只读命令。如果已有未提交改动,先弄清它们来自哪里。不要为了让工作区“干净”就删除别人的工作。

sh
git status --short
git diff --stat

第二步:交付一个小而明确的任务

第一次合作适合选行为清楚、容易手动复现的改动,例如搜索没有结果时给出下一步提示。

text
先阅读项目 README 和相关的项目指令,再定位搜索空结果界面。
当用户搜索没有匹配项时,显示“没有找到相关教程,试试其他关键词”。
添加一个清除搜索条件的入口,点击后恢复完整列表。
沿用现有组件和样式,不增加依赖。
完成后说明修改文件、验证方法和结果。

第三步:检查实际差异

不要只凭“已完成”的回复判断任务结果。用 git diff 查看改动,确认没有顺手重构无关模块,也没有写入凭据或生成无关文件。对不理解的部分,可以要求 Codex 解释触发条件和影响范围。

sh
git diff

第四步:按行为验收

按 README 启动项目,输入一个确定不存在的关键词,确认提示出现;点击清除后确认列表恢复。再测试一个真实关键词,确保正常搜索仍然工作。已有相关测试时运行它;测试失败要区分是本次改动引入,还是环境缺失。

完成标准与下一步

  • 差异只涉及本次任务。
  • 空结果和正常结果两种状态都被检查。
  • 报告如实区分已验证和未验证事项。

完成后再决定是否提交。先掌握这种“任务、差异、行为验证”的节奏,再让 Agent 处理跨文件功能。

官方资料与参考

产品功能与命令可能调整。遇到差异时,以对应官方页面和当前环境为准。

读完了,动手试一次。

完成练习后,标记进度,方便继续学习。

需要独立的 macOS 开发环境?

了解三万主机的远程 Mac 租赁,或先看看你是否需要一台远程 Mac。

了解三万主机 ↗