Codex可自动扫描指定路径文档，精准定位旧字段【orderStatus】引用位置并标记上下文；需先确认文档路径与格式，再用带方括号的字段名触发锚定匹配，最后依结果逐行替换为新字段【status】并人工核验枚举值。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
接口字段变更后，文档常被遗忘更新，导致新成员按旧文档对接失败、测试用例断言错位、前端取值报undefined。Codex能自动扫描项目中所有文档类文件，比人工grep快且不漏死角。
确认文档存放位置和格式
先执行pwd和ls -R | grep -E "(md|txt|adoc|json)"，确认文档是否集中在docs/、src/docs/或根目录下的API_SPEC.md等位置。如果项目用Swagger或OpenAPI，还要检查openapi.yaml或swagger.json是否在public/或config/下。这一步不能跳过——Codex只会搜索你指定的路径，不会主动猜文档在哪。
若发现文档散落在多个目录（比如README.md在根目录、接口说明在src/pages/api、示例请求在tests/fixtures），请手动汇总路径，后续提示词里必须明确列出，否则Codex默认只查docs/子目录。
让Codex扫描并比对字段引用
在Codex终端输入以下指令：
请扫描以下路径中的所有文档文件：[你刚确认的路径列表]。目标是找出所有提及旧字段名【orderStatus】的位置，并标记其上下文（如“响应示例”“参数说明”“错误码表”）。不要修改任何文件，只输出匹配行+所在文件+段落标题（如有）。
注意：必须用【orderStatus】这种带方括号的写法，避免Codex把status、order、state等近义词也误判为命中。方括号是强制锚定符号，不是装饰。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
等待Codex返回结果后，快速扫一眼文件名分布。如果它只在API_SPEC.md里找到3处，却漏了src/components/OrderCard/README.md里的一处字段说明，说明路径没给全，要补上再试一次。
生成文档更新建议
第一步确认字段引用位置后，执行第二步：
① 把Codex刚输出的所有匹配结果复制下来，连同新字段名【status】一起粘贴进新任务框；
② 输入：基于以下旧字段引用位置，为每个位置生成对应的新文档描述。要求：保留原文结构和语气，仅替换字段名、类型说明和示例值；若原文有“字段已废弃”“兼容旧版”等提示语，请保留；不要新增解释性句子。
③ 等Codex输出后，直接复制粘贴到对应文档中，**不要全选覆盖**——只替换它标出的具体行。因为有些段落可能混着多个字段，全选会误删其他内容。
这一步操作起来很简单，直接把Codex生成的文本块拖进编辑器对应位置就行。但要注意：如果某处原文写着“orderStatus（字符串，取值：'pending'/'success'/'failed'）”，而新字段status实际去掉了pending状态，Codex不会主动删枚举值，你得自己核对后手动修正。
