新手首次使用codex应先分析项目结构:1.技术栈;2.入口文件;3.核心目录职责;4.最重要5个文件;5.推荐阅读顺序。不修改任何文件,仅输出结构化信息。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

新手第一次让Codex执行任务,常因提示词模糊导致它改错文件、忽略关键限制或反复追问细节。你只需要说清四件事:要做什么、看哪些内容、哪些不能动、怎样算完成。
先定目标:用结果说话,别只说动作
第一步:用一句话写出最终交付物,聚焦用户可见的结果。比如不要写“优化登录页”,而要写【登录页在 iPhone SE 屏幕上不能出现横向滚动,且提交按钮必须完整可见】。
第二步:立刻补上触发条件或用户场景。例如:“当前用户在 Safari iOS 17.5 下访问时复现该问题”。没有这个上下文,Codex 可能按 Chrome 桌面端逻辑去改,白忙一场。
第三步:指出已有实现位置。直接写“相关代码在 src/pages/auth/LoginPage.tsx 第 42–89 行”,Codex 就不会去动 src/components/Button.tsx 这类无关文件。
再划边界:明确“能改”和“不能碰”的硬线
方法一:用“只改……不改……”句式锁定范围。
只改 src/api/auth.ts 中的 login 函数体;不改路由定义、不改 token 存储逻辑、不新增任何依赖。
方法二:对高风险操作加硬性约束。
数据库 schema 不得变更;已有接口返回字段结构必须保持完全一致;所有修改必须兼容 TypeScript 5.4 类型检查。
【如果 Codex 自行添加了新的 HTTP 状态码(如 422 或 403),说明它越界了,必须回退】。这类错误一旦合并,前端会因未处理新状态码而崩溃。
最后验成果:告诉 Codex 怎样才算“做完了”
① 运行 pytest tests/api/test_auth.py --tb=short,全部通过且覆盖率不低于 85%。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
② 打开 http://localhost:3000/login,在 Chrome DevTools 切换到 iPhone SE 模拟器,手动点击登录按钮,确认无滚动条、按钮无截断、控制台无 layout warning。
③ 对比 src/api/auth.ts 修改前后 diff,确认仅新增了验证码校验逻辑,未改动 JWT 解析部分。
复杂任务必须先拆解再执行
请阅读项目结构,列出实现“订单退款功能”需修改的全部文件路径,并标注每个文件的修改类型(新增/重写/扩写)。
等它输出计划后,你再确认是否包含数据库迁移脚本。若计划中没提 alembic revision,则说明它忽略了 schema 变更,必须叫停。
新手最安全的第一步:只分析,不修改
请阅读当前项目结构,不要修改任何文件。请输出:
1. 项目主要技术栈
2. 入口文件在哪里
3. 核心目录分别负责什么
4. 最重要的 5 个文件
5. 新手应该按什么顺序阅读










