发布前需用codex执行核心功能冒烟测试，命令为codex /test --mode=smoke；支持按模块、prd功能点id或pr号验证；未覆盖路径可通过codex analyze --missing=critical识别并用codex /test --generate生成用例。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在发布新版本前确认所有核心功能仍能正常运行，是避免上线后大面积故障的关键动作。Codex 提供了结构化、可复现的检查路径，不依赖人工逐条点检，也不需要提前写测试脚本。
用 /test 命令触发核心功能快照比对
进入项目根目录，在终端中执行：codex /test --mode=smoke。
该命令会自动加载 .codex/test/smoke.yaml 中定义的核心用例集——这是项目初始化时由 Codex 根据 PRD 和接口文档自动生成的最小可运行路径清单，包含登录、主列表加载、关键提交、异常兜底四类场景。
【执行前必须确保当前分支已同步最新 main，否则比对基线失效】。
手动指定要验证的功能模块
方法一：按模块名快速验证
执行 codex /test --module=user-auth，Codex 会仅运行 user-auth 模块下所有标记为 critical: true 的用例。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
方法二：按 PRD 功能点 ID 验证
执行 codex /test --feature=F-2037，F-2037 是你在 PRD 中为「双因素登录跳过逻辑」分配的唯一编号，Codex 会定位到对应用例并执行。
方法三：验证某次 PR 引入的所有功能
执行 codex /test --pr=1482，Codex 将解析 PR #1482 的标题与描述，提取关键词（如“SSO”“OIDC”“fallback”），自动匹配已有用例并补充临时校验点。
检查未覆盖的核心路径
第一步：导出当前功能覆盖率报告codex coverage --export=json > coverage-report.json。
第二步：筛选缺失的高优先级路径
运行 codex analyze --missing=critical，它会扫描 PRD.md 中所有带 【must-have】 标签的段落，比对 coverage-report.json，输出未被任何用例覆盖的路径列表。
第三步：为缺失项生成最小验证用例
对输出的第一条路径（例如：“用户注销后，本地 token 必须立即失效且不可重放”），执行 codex /test --generate --desc "token 注销即时性"，Codex 将生成可直接运行的 YAML 用例并存入 .codex/test/generated/ 目录。
