必须将prd、设计稿、接口文档、埋点规范、灰度计划全部转化为可逐条打钩的验收动作，分四步执行：结构化拆解需求→生成带断言的markdown清单→产出含业务校验的cypress脚本→构建终验仪表盘并接入发布系统。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让Codex生成的全栈功能真正可上线，不能只验证“页面能打开”“接口能返回”，必须把PRD里的业务承诺、设计稿里的状态细节、接口文档里的字段约束、埋点规范里的事件ID、上线计划里的灰度开关，全部转化成可逐条打钩的验收动作。
第一步：用Codex结构化拆解原始需求材料
把PRD正文、Relay原型图截图、Figma设计标注页、OpenAPI 3.0接口文档（YAML格式）、埋点文档Excel，统一放入项目根目录的inputs/文件夹下。
在终端执行：codex --plan "基于inputs/下的全部材料，输出一份端到端验收流程图，要求覆盖主流程、异常路径、空态、权限边界、埋点触发、灰度开关控制点，并标注每个验收项对应来源（如：PRD第3.2节 / 接口文档/users/{id}响应体）"。
这一步必须人工确认流程图中是否包含“未登录用户访问订单页”的跳转逻辑——【若漏掉该路径，后续所有权限相关验收将失效】。
第二步：生成带断言的自动化验收清单
方法一：用Codex直接生成Markdown格式checklist
运行指令：codex --file inputs/acceptance-plan.md "将上一步输出的流程图，转化为带编号的Markdown验收清单。每条含：①验收场景描述；②预期结果（精确到文案、颜色值、HTTP状态码、埋点event_id）；③验证方式（手动/Postman/cypress脚本路径）；④阻塞条件（如：需先开启feature flag:user_profile_v2）"。
方法二：让Codex补全缺失的异常分支
针对清单中“网络失败”类条目，追加指令：@inputs/acceptance-plan.md "补充以下5种弱网场景的验收项：1. 接口超时（>3s）；2. 502网关错误；3. 返回空JSON {}；4. 字段类型错乱（如status返回字符串"pending"而非数字1）；5. 响应头缺失X-Request-ID。每条必须写出前端Toast文案和错误日志上报字段名。"。
第三步：为关键链路生成可执行的Cypress测试脚本
第一步：指定链路范围
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
输入：codex --file inputs/checkout-flow.png "分析该支付链路图，识别出7个必须自动化验证的节点：从商品加入购物车→填写地址→选择优惠券→调起支付SDK→监听支付结果→更新订单状态→跳转成功页"。
第二步：生成带真实断言的脚本
执行：@inputs/checkout-flow.png "为上述7个节点，生成cypress/e2e/checkout.spec.ts。要求：每个it()块包含cy.intercept()捕获对应接口、cy.get()校验UI元素、cy.contains()匹配文案、cy.log()记录埋点触发时刻。特别注意：优惠券不可用时，必须校验disabled属性和tooltip文字"。
第三步：注入业务规则校验
运行：@cypress/e2e/checkout.spec.ts "在支付结果监听环节插入自定义命令cy.verifyPaymentResult()，该命令需校验：①localStorage中order_status字段值；②window.dataLayer数组中payment_success事件的value字段；③后端/webhook回调日志中是否存在对应transaction_id"。
第四步：构建上线前终验仪表盘
创建dashboard.json文件，内容为Codex生成的终验项结构化数据：
codex --output dashboard.json "读取inputs/acceptance-plan.md和cypress/e2e/checkout.spec.ts，提取所有验收项，按'已通过/待验证/阻塞/跳过'四状态分类，统计各模块覆盖率（UI/接口/埋点/权限/灰度），输出为JSON格式，字段包含：id、title、source、status、last_checked、responsible"。
将该JSON接入内部发布系统，每次点击“准备上线”按钮时，自动校验：①所有status为“阻塞”的项是否已解除；②灰度开关配置项是否已在配置中心写入；③dashboard.json中responsible字段对应人员是否已签署电子确认。
