说明任务
写清当前现象、目标结果、相关路径和不想碰的范围。最好附上失败日志、截图、URL 或测试名。
任务手册
日常任务 workflow
日常任务不能只用一句“做一下”带过。在 Codex Desktop 里，Codex 会读仓库、改文件、跑命令，也可能误解边界。比较稳妥的做法是：开一个清晰线程，补充上下文，限定范围，审批必要操作，最后检查验证证据。
让 Codex 读上下文
要求先读 AGENTS.md、README、相关源码、测试和日志。没有读上下文之前，不要让它直接大改。
小范围执行
一次只解决一个可验证问题。改文件前应知道预计会改哪些文件，避免顺手重构和无关格式化。
验证和收口
让 Codex 跑最窄测试或构建，解释结果；如果不能跑，要说明原因和剩余风险。
flowchart LR
A["说清任务"] --> B["读上下文"]
B --> C["限定改动范围"]
C --> D["执行最小 diff"]
D --> E["运行最窄验证"]
E --> F["报告证据和风险"]
读代码并解释
适合刚接手仓库、看不懂模块边界、需要快速建立 mental model。要求 Codex 引用真实文件和函数，不要泛泛解释。
请只读分析这个仓库的登录流程。
先读 AGENTS.md、README 和 auth 相关源码。
输出：入口文件、核心函数、数据流、风险点。
不要改文件。修失败测试
适合已经有明确红灯的场景。给出测试命令和失败片段，让 Codex 先定位根因，再做最小修复。
请修复这个失败测试。
失败命令：npm test -- checkout
范围：只改 checkout 相关代码和测试。
要求：先解释根因，再改最小 diff。修改网页或文档
适合样式、内容、导航、README、指南页。要说明目标读者和验收方式，尤其是需要浏览器验证时。
我在 Codex Desktop 浏览器里看到 daily-workflow 页面内容太少。
请更新 daily-workflow 页面。
目标读者：第一次使用 Codex 的中文用户。
验收：页面有完整流程、示例、检查清单。
完成后本地静态服务抽样访问。审查当前 diff
让 Codex 站在 reviewer 视角查 bug、遗漏测试、破坏兼容和文档缺口。只读 review 时要明确“不改文件”。
请 review 当前 git diff。
重点：行为回归、缺失测试、权限/安全风险。
输出：按严重程度排序的 findings。
不要改文件。提交和发布
适合你已经确认改动方向，想让 Codex 负责测试、commit、push、Pages 或 PR 状态确认。一定要要求最终链接和验证证据。
请提交并推送这次网页修改。
提交前：git diff --check，抽样访问关键页面。
提交信息：Improve daily workflow guide
推送后：确认 GitHub Pages built。不要这样写
帮我优化一下这个项目。
这个页面太丑了，改好看点。
测试挂了，修一下。
你自己看着办。这些请求的问题是目标不可验收，范围过大，容易导致 Codex 猜需求、乱改文件或给出空泛总结。
推荐这样写
请修复 checkout 流程里的失败测试。
背景：
- 当前分支新增了优惠券逻辑
- 失败命令是 npm test -- checkout
范围：
- 可以改 checkout、coupon、对应测试
- 不要改 payment provider 接口
要求：
- 先读 AGENTS.md 和失败日志
- 改动前给 3 行短计划
- 完成后运行最窄测试
验收：
- 测试通过
- 最终说明改了什么、验证了什么、剩余风险改动证据
列出关键文件、关键行为变化、没有改哪些范围。不要只说“优化了代码”。
验证证据
列出测试、构建、静态服务、页面访问、截图或线上状态。
风险证据
说明没跑的测试、依赖的外部状态、可能的兼容影响。
交付证据
给出 commit、PR、Pages URL、issue 链接或产物路径。
推荐 closeout 模板
这是本指南推荐实践，不是 Codex 原生 UI。字段与任务页的 receipt 保持一致：
changed scope：实际改动的文件、模块或页面
behavior_changed：用户可观察的行为变化；没有则写 false
validation evidence：测试、构建、URL、截图或人工检查结论
risk-or-blocker：剩余风险、未运行检查或当前阻塞
next step：发布、人工确认、继续修复或无需动作这是一个可迁移到任意 Node/Express 商店的日常修复任务：测试 checkout 在空购物车时报错，Codex 先读失败日志，再只改结算模块。
输入
仓库 example-store，失败命令 npm test -- checkout，现象是空购物车仍尝试扣款。
Prompt
先读 AGENTS.md 和失败日志。
只改 src/checkout/ 下文件。
改动前说明根因。
完成后运行 npm test -- checkout 并报告 diff。审批边界
允许读文件和跑测试；安装新依赖或改支付网关配置需先说明并等待批准。
可观察结果
测试由 fail 变 pass；diff 仅含 checkout 模块；报告列出改动文件和命令输出。
失败恢复
若根因指向 API 契约而非前端逻辑，停止改码，输出 blocked receipt 并建议补集成测试或 mock。
验证证据
终端测试输出、git diff --stat、相关函数路径引用；本项目没有该商店仓库的执行记录，因此标为演示场景。
这次 daily-workflow.html 原本只有几十个词。用户在 Desktop 浏览器里指出“内容太少”，Codex 按日常任务闭环完成了读上下文、改页面、验证和发布。