AI Agent / 系统课时

提出可执行的修改请求

提出可执行的修改请求

本课把“帮我改一下”转换成 Codex 可以直接实施并自我验证的小型任务。你将使用目标、范围、限制和验收标准四部分描述需求,减少误改、漏改和无效探索。

学习目标

  • 把模糊需求改写为可观察行为
  • 明确允许修改的范围和必须保持的约束
  • 为任务定义可执行的验收标准

一条任务指令的四个部分

目标说明最终要产生什么行为,不要只描述实现手段。范围指出优先检查和允许修改的文件或模块。限制定义不能破坏的兼容性、安全规则与已有行为。验收标准则把“完成”变成可以通过测试、命令或人工观察检查的结果。

例如“给登录接口加校验”仍然太模糊。更好的描述应指出校验对象、失败响应、允许修改的位置,以及已有成功登录流程必须保持不变。

编写完整修改请求

下面以一个 TypeScript API 为例。路径和命令是示例,发送前应替换为当前仓库的真实信息。

text
目标:
为 POST /api/login 增加邮箱格式校验。邮箱无效时返回 HTTP 400,响应体为 {"code":"INVALID_EMAIL"}。

范围:
优先检查并修改 src/auth/login.ts 和对应测试文件。
如确有必要,可以修改同目录的校验工具,但不要重构其他认证模块。

限制:
保持有效邮箱的登录行为、现有响应字段和密码校验逻辑不变。
不要新增运行时依赖,不要修改数据库结构。

验收标准:
1. 无效邮箱返回 400 和指定错误码。
2. 有效邮箱继续进入原有密码校验流程。
3. 新增或更新测试覆盖两种行为。
4. 运行相关测试和静态检查,报告命令与结果。
5. 最后总结修改文件,不要提交 Git commit。

预期结果

text
计划:定位登录入口与现有测试
改动:在限定文件内增加邮箱校验和测试
验证:相关测试与静态检查通过
总结:列出修改文件、行为变化和未解决问题

这类指令不要求你预先指定每一行代码,而是把决策空间限制在安全范围内,同时保留 Codex 根据代码库惯例选择实现方式的能力。

先小后大

第一次编码任务应优先选择单一行为、少量文件和清晰测试入口。若一个请求同时包含数据库迁移、接口改造、前端页面和部署配置,应先拆成多个阶段,而不是把所有内容塞进一条指令。

小任务的价值在于反馈快。Codex 完成后,你能直接判断它是否理解了项目约定;如果方向错误,修正成本也更低。

避免隐藏前提

不要假设 Codex 知道团队口头约定。诸如“错误格式保持一致”“不能新增依赖”“只兼容 Node.js 20”“不得修改公共接口”等条件,都应写进限制或验收标准。

若你不知道真实命令,可以要求 Codex 先读取 package.json、构建文件或项目文档,再提出验证计划。先确认命令,再授权执行,比直接猜测更可靠。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

提出可执行的修改请求

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通