codex 处理模糊需求需先启动 plan 模式进行结构化拆解，再提供含技术栈、文件路径、约束条件的精准上下文，接着人工审查计划步骤的入口正确性、依赖拆分与可验证性，最后授权执行并锁定中间状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你面对“把用户中心优化一下”这种模糊需求时，Codex 无法直接写代码——它必须先确认真实入口、识别影响范围、拆出可验证的最小改动单元，否则改错一个 auth 中间件就可能让整个登录流程崩溃。
启动 Plan 模式触发结构化拆解
在 Codex 对话框中输入 /plan 或按下 Shift + Tab，强制进入规划阶段。这一步不可跳过，否则 Codex 会默认进入代码生成模式，直接输出未经上下文校验的片段。
输入后 Codex 会暂停执行，转而向你提出 2～4 个澄清问题，例如：“当前用户中心涉及哪些 API 路径？”“是否要兼容已有的 JWT 过期逻辑？”——这些问题不是形式主义，而是为了锁定修改边界。
提供精准上下文防止误拆
回答澄清问题时，必须包含三项硬信息：技术栈（如 FastAPI + PostgreSQL）、关键文件路径（如 @src/auth/router.py）、约束条件（如“禁止修改 models.User 的字段定义”）。
如果只说“用 Python 写”，Codex 可能按 Flask 风格生成蓝图路由；如果漏掉 @ 符号标注文件，它会凭空虚构模块结构，后续所有步骤都建立在错误基座上。
这一步操作起来很简单，直接把文件拖进去就行。
审查并修正自动生成的计划步骤
Plan 模式返回的 JSON 计划包含 5～8 个带 ID 的步骤，每个步骤含 step 描述和 status 字段。你需要人工检查三处：
① 第一步是否为“读取 @src/auth/router.py 并定位 /api/users/ 相关路由”——若第一步是“重写用户模型”，说明上下文未被正确理解，必须退回重输。
② 是否存在跨文件强依赖步骤，例如“先改数据库迁移脚本，再改 API 路由”——这类步骤需手动拆成两个独立项，并添加验证指令（如“运行 alembic revision --autogenerate 后确认无字段变更”）。
③ 所有步骤是否满足“可独立验证”：每个 step 结尾必须带明确验收动作，比如“调用 curl -X GET /api/users/me 返回 200 且含 avatar_url 字段”，而不是“确保用户信息正确显示”。【缺少可验证动作的步骤必须删除或重写】
授权执行并锁定中间状态
确认计划无误后，在 Codex 界面点击“Execute Plan”按钮，系统将按顺序执行每步，每步完成后自动标记 status 为 completed。
执行到第 3 步时若失败，Codex 不会继续后续步骤，而是停留在该 step 的 error message 界面——此时你可以选择“Retry”、“Skip”或“Edit Step”，所有已成功步骤的状态和产物均被 Git 快照保存，支持随时回退。
注意：执行过程中禁止手动修改正在处理的文件，否则 plan_tool 的状态追踪会与实际文件内容脱节。
