Codex 新建任务需主动提供核心资料:①明确任务目标(一句话交付物);②项目基本信息(技术栈、启动方式、目录结构);③涉及文件路径。补充报错日志、约束条件、验收标准可提升准确性,截图与文档片段为高价值辅助信息。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

新建任务时,Codex 不会自动猜你要改哪段代码、读哪个配置、生成什么格式的文档——它需要你主动提供足够支撑决策的资料,否则可能修改错误文件、忽略关键约束、输出无法落地的结果。
必须提供的核心资料
第一步:明确写出任务目标,用一句话说清「最终要交付什么」。例如不要写“优化登录流程”,而要写【修复用户点击登录按钮后页面无响应的问题,确保提交后跳转至首页,且不触发重复请求】。目标模糊会导致 Codex 自行脑补场景,偏离真实需求。
第二步:给出当前项目的基本信息。包括技术栈(如 Python 3.11 + FastAPI)、启动方式(如 uvicorn main:app --reload)、关键目录结构(如 auth/ 下有 login.py 和 middleware.py)。没有这些,Codex 可能误判模块归属或调用方式。
第三步:指定涉及的文件范围。直接拖入或输入路径,比如 auth/login.py、tests/test_login.py。不提供具体路径时,Codex 可能扫描整个项目,既慢又容易引入无关改动。
强烈建议补充的上下文资料
方法一:粘贴报错日志或截图中的关键片段。Codex 能识别堆栈位置、异常类型和触发条件,比单纯描述“登录失败”高效得多。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
方法二:说明已有约束。例如【不得修改 utils/http_client.py,该文件由其他团队维护】或【所有 API 响应必须保持 status=200,错误信息统一走 data.error 字段】。这类限制一旦遗漏,Codex 可能直接重写被保护文件。
方法三:提供验收标准。不是“让它能用”,而是写清楚“成功标志是:① 手动点击登录按钮后 Network 面板显示仅 1 次 POST 请求;② 返回 JSON 中包含 redirect_url 字段;③ 单元测试 test_login_success() 全部通过”。Codex 会据此自检结果,而非仅凭“我觉得差不多”就结束任务。
可选但高价值的辅助资料
如果任务涉及 UI 或交互逻辑,提供一张当前页面截图即可。Codex 能识别按钮位置、表单字段和状态文案,避免你手动描述“用户名输入框在左上角第三个位置”这种低效信息。
已有相关文档片段(如接口协议 Markdown、PRD 截图、数据库 ER 图)可直接上传。Codex 会从中提取字段名、校验规则和业务术语,减少因名词不一致导致的理解偏差。
不需要提供完整项目压缩包。Codex 只读取你明确指向的文件和你当前对话中粘贴的内容,其余部分它默认不可见也不会猜测。

















