Codex Manual

常用工作流

Codex 的效果很大程度取决于你给任务的方式。

解释项目

请先不要改文件。阅读这个仓库,说明目录结构、主要模块、启动命令、测试命令和最重要的配置文件。

修复 bug

这个问题是:用户点击保存后页面没有提示成功。请先定位原因,不要直接改。找到原因后给出修复方案和验证方式。

确认后:

按方案修改,只改必要文件。完成后运行相关测试,并总结 diff。

补测试

请为这个模块补充单元测试。优先覆盖边界条件,不改变生产逻辑。完成后运行测试。

代码审查

请 review 当前未提交改动。优先指出 bug、回归风险、安全问题和缺失测试。不要改文件,先给我 findings。

文档更新

请根据当前实现更新 README。不要写营销文案,只补充安装、配置、运行和常见错误。

长任务

长任务需要更明确:

目标:把旧的支付回调处理迁移到新的 handler。
范围:只改 api/handler/payment* 和相关测试。
限制:不改数据库结构,不改外部接口字段。
验证:运行 payment 相关测试,并说明没有覆盖的风险。

越明确,Codex 越容易给出可验证结果。