开始前准备
准备一个你有权修改的小项目、可用的 Codex 使用入口,以及项目的运行说明。本教程采用通用的仓库协作步骤,不绑定某个界面的按钮名称。使用前按官方文档完成登录与项目连接;账户可用功能以实际界面为准。
第一步:记录工作区起点
在项目目录运行下面的只读命令。如果已有未提交改动,先弄清它们来自哪里。不要为了让工作区“干净”就删除别人的工作。
git status --short
git diff --stat第二步:交付一个小而明确的任务
第一次合作适合选行为清楚、容易手动复现的改动,例如搜索没有结果时给出下一步提示。
先阅读项目 README 和相关的项目指令,再定位搜索空结果界面。
当用户搜索没有匹配项时,显示“没有找到相关教程,试试其他关键词”。
添加一个清除搜索条件的入口,点击后恢复完整列表。
沿用现有组件和样式,不增加依赖。
完成后说明修改文件、验证方法和结果。第三步:检查实际差异
不要只凭“已完成”的回复判断任务结果。用 git diff 查看改动,确认没有顺手重构无关模块,也没有写入凭据或生成无关文件。对不理解的部分,可以要求 Codex 解释触发条件和影响范围。
git diff第四步:按行为验收
按 README 启动项目,输入一个确定不存在的关键词,确认提示出现;点击清除后确认列表恢复。再测试一个真实关键词,确保正常搜索仍然工作。已有相关测试时运行它;测试失败要区分是本次改动引入,还是环境缺失。
完成标准与下一步
- 差异只涉及本次任务。
- 空结果和正常结果两种状态都被检查。
- 报告如实区分已验证和未验证事项。
完成后再决定是否提交。先掌握这种“任务、差异、行为验证”的节奏,再让 Agent 处理跨文件功能。