学完这一课,你能:
- 提供足够但不过量的技术上下文
- 要求 AI 先解释和计划,再做小范围修改
- 检查差异、运行测试并完成技术验收
CODEX 实操 · 12 章第一次用 Codex:从模糊需求到可验收改动
4 分 27 秒 · 中文字幕内容依据官方 OpenAI Codex 学习资料核对;跟着真实网站小改动检查任务边界、代码差异和验证证据。查看章节与完整脚本
1. 技术任务需要六类上下文
- 目标
- 用户最终要完成什么,而不只是“把代码改好”。
- 现状
- 项目结构、运行方式、相关文件和已经正常的功能。
- 证据
- 完整错误、复现步骤、日志和你已经做过的检查。
- 范围
- 允许改哪些文件、不能改什么、是否允许新增依赖。
- 标准
- 功能、界面、异常情况和安全方面怎样才算完成。
- 验证
- 要运行哪些命令、走哪些操作、检查哪些结果。
先脱敏再提供上下文配置文件可能包含密钥、令牌、数据库地址和客户数据。只提供解决问题需要的片段,用占位符替换敏感值。
2. 把一次修改拆成五个关口
- 让 AI 复述理解确认它理解了现象、目标和不能触碰的边界。
- 先给方案,不急着改要求说明根因假设、准备修改的文件和验证方式。
- 控制最小改动一次解决一个问题,不顺手重构,不随意更换技术栈。
- 检查差异看
git diff,让 AI 逐段解释每个变化为什么必要。 - 自己运行验收测试成功路径、错误输入、刷新和边界情况;结果不符合就带证据继续迭代。
3. 一张可复用的技术协作单
项目目标:____
当前环境与运行方式:____
相关文件:____
复现步骤与完整错误:____
我已经验证:____
允许修改:____
禁止修改:____
是否允许新增依赖:____
验收标准:____
验证步骤:____
请先复述你的理解,列出根因假设和最小修改计划。等我确认后再修改。修改完成后,按文件解释差异,并给出验证清单。
当前环境与运行方式:____
相关文件:____
复现步骤与完整错误:____
我已经验证:____
允许修改:____
禁止修改:____
是否允许新增依赖:____
验收标准:____
验证步骤:____
请先复述你的理解,列出根因假设和最小修改计划。等我确认后再修改。修改完成后,按文件解释差异,并给出验证清单。
你不是审批 AI 的语气,而是验收系统行为解释听起来合理不代表代码可用。只有差异可理解、项目能运行、验收步骤通过,任务才完成。
结课任务 · 30 分钟
交付“今日任务板”第一版
- 写出功能边界:新增、完成、删除,刷新后保留;不做登录和云同步。
- 把现有项目文件和协作单交给 AI,让它先解释再提出计划。
- 一次只实现一个功能,每次修改后用浏览器验证并查看差异。
- 至少测试空任务、重复点击、刷新页面和删除任务。
- 写一页 README:怎么运行、文件做什么、验证了什么、已知限制是什么。
第二阶段结课自测
完成第二阶段
你已经从“让 AI 给我一段代码”走到“我能定义任务、理解系统、控制修改并完成验收”。下一阶段将把这些能力用于真实需求、系统设计、部署与持续迭代。