1. 现象
指出当前页面、仓库或失败命令，以及实际发生了什么。
任务
任务路径总览
本指南默认你主要使用 Codex Desktop。先用桌面版把任务闭环跑通，再判断是否需要 Goal、subagent、skills 或自动化。任务页重点讲怎么做，不展开术语解释。
先按范围、风险和协作人数选入口。短小、低风险、单文件任务直接进入五阶段循环，不需要 Issue 或 Worktree；多文件、高风险或多人写入任务升级到 团队工程流程。
短小 / 低风险 / 单文件Desktop 直接循环固定一个写域最窄验证后签发 receipt
页面 / 视觉Desktop + in-app browser先给页面与目标状态URL、截图或页面抽样
代码 / 测试Desktop + integrated terminal保留失败日志与边界最窄测试、构建或 diff
多文件 / 高风险 / 多人写入升级团队工程流程Issue、依赖与互斥写域Worktree、PR、独立 review、CI
稳定重复任务Scheduled tasks + 隔离环境定义停止条件运行记录与异常 receipt
安装 Desktop
先完成安装、登录、打开仓库和第一个小任务。
Codex Desktop
先学桌面版线程、浏览器反馈、审批、diff review 和发布验证。
日常小任务
读代码、解释错误、修 bug、跑测试、审查 diff，通常不需要 Goal。
工程 flow
复杂功能先 grill，再 PRD，再 issues，再实现和 review。
学术 flow
从 research brief 到文献、新颖性、实验、审稿和写作边界。
定时任务
把稳定重复任务放进 Scheduled tasks，并用后台 worktree 隔离改动。
Skills 仓库选择
当任务适合第三方 skills 仓库时，先选 Compound、Matt、ARS 或 ARIS，再写 prompt。
Compound Engineering
插件场景：如何用 /ce-brainstorm、/ce-plan、/ce-work 和 review 组织长任务。
prompt ladder 针对同一个真实任务逐步补齐上下文、边界和验收，不要中途换成更容易的演示任务。每一步只做当前最小改动，完成后立即检查 diff 和局部行为。
V1：只有愿望
帮我优化任务页。缺少现象、写域和完成标准，Codex 只能猜。
V2：补上下文与边界
在 workflows.html 增加任务闭环。
只改这个页面，不改 CSS 和导航。
先读 AGENTS.md 与现有页面结构。同一个任务变得可执行，但还不能证明完成。
V3：补验收证据
沿用上面的范围。
验收：五个阶段各有唯一锚点并按顺序出现；
项目已有的验证命令通过（例如 npm test 或 make check）；桌面和 390px 页面无溢出。
失败时保留错误并进入 blocked receipt。同一个任务现在有可复核的 done / blocked 条件。
实现摘要本身不是验收证据。先按任务合同收集对应证据，再由用户、reviewer 或既定自动门判定 accepted；未 accepted 的任务不能进入 done。
代码测试测试或构建命令退出码与关键结果覆盖实际改动路径
页面证据目标 URL截图或关键页面抽样核对响应式与目标状态
PR / CIPR 链接或标识review dispositionCI checks 全部满足合同
人工验收验收人和对象明确 accepted / rejected保留条件或反馈
实现失败行为、断言或 diff 与合同冲突定位最小失败切片并修复回 practice，重跑原验收
环境失败瞬时服务、端口或临时资源问题确认幂等后有限重试仍失败则 blocked receipt
缺失依赖缺包、服务、数据或磁盘资源不伪造降级结果，列解锁条件handoff 或 blocked receipt
权限拒绝缺少审批或外部写入 grant停止越权动作blocked receipt
来源不确定事实无法由可信来源支持停止发布该主张或降级为演示handoff 或 blocked receipt
产品待决验收口径冲突或需求待裁决不自行猜测产品决定回负责人或 blocked receipt
receipt 是本指南推荐的任务收口实践，不是 Codex 原生 UI 功能。本指南把它分为 done 或 blocked；两者都应列出 changed scope、behavior_changed、验证证据、风险或阻塞，以及明确下一步。
Done receipt
changed scope：实际改动文件或页面；behavior_changed：用户可观察变化；验证证据：accepted 的命令、URL、截图、PR/CI 或人工结论；风险：剩余风险；下一步：发布、观察或无需动作。
Blocked receipt
changed scope：已完成与未完成边界；behavior_changed：当前是否已有行为变化；验证证据：已通过与无法执行项；阻塞：权限、依赖、来源或产品决定；下一步：责任人和解锁条件。
真实实例
真实实例：从一句反馈选择任务路径
用户在 Codex Desktop 的浏览器里说“每个内容都加一个真实的实例”。这个请求涉及多个页面，需要发布，也可能多人写入，因此从 choose 阶段升级到 团队工程流程，但仍使用同一份验收合同直到 receipt。
1. Request
给主要内容加入真实实例，让读者能照着完成任务。
2. Context to inspect
AGENTS.md、现有页面与导航、案例模式、静态检查和发布说明。
3. Allowed change
只改批准的 HTML、案例索引和必要检查；不改共享样式、公共导航或无关 dirty 文件。
4. Validation evidence
语义负向测试、全站链接/锚点检查、diff review、浏览器与公开页面抽样。
5. Final report
列 changed scope、behavior_changed、证据、PR/发布状态、剩余风险与未执行项。
6. Failure stop
来源或脱敏不足、写域扩大、验证失败、外部写入未授权，或公开页面无法确认时停止并给 blocked receipt。
路径选择：
1. choose：确认多文件范围并升级团队流程
2. practice：在同一任务上逐页小步修改
3. evidence：运行静态检查并抽样公开 URL
4. recover：失败时按实现问题或发布 blocker 分类
5. receipt：仅在证据 accepted 后记录 done，否则记录 blocked