Codex 项目协作指南：从需求到验证闭环

一、把需求写成可执行任务

越清楚的任务越容易得到可用结果，建议直接说明目标页面、目标行为、限制条件和交付标准

• 不要只说“优化一下”，要说“把文档中心扩展到 8 篇，并更新首页入口”
• 不要只说“高级一点”，要说明颜色、密度、交互和品牌气质
• 需要保留的内容要提前说清，例如备案信息和公司名称

二、让 Agent 先检查现状

正式修改前，先让 Codex 查看文件结构、现有样式、运行方式和可能的风险点，避免凭空改动

三、验证比生成更重要

一次合格的 Codex 协作，应包含实现、访问检查、截图或测试、问题修正和最终说明

• 静态站点检查链接和资源状态码
• 前端页面检查桌面与移动端视口
• 代码项目运行测试或构建命令
• 修改后说明改了什么、如何验证、还剩什么风险

四、适合沉淀的内部模板