codex-usage-guide/workflows.html at master · WhoJay0609/codex-usage-guide · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>任务路径</title>
  <!-- guide:theme-bootstrap:start -->
<script src="assets/theme.js"></script>
<!-- guide:theme-bootstrap:end -->
  <link rel="stylesheet" href="assets/site.css">
  <!-- guide:metadata:start -->
<meta name="description" content="根据任务复杂度选择工作流，并用推荐 receipt 实践收口。">
<meta name="guide-build" content="ee947e14a0a9">
<link rel="icon" href="favicon.svg" type="image/svg+xml">
<link rel="canonical" href="https://whojay0609.github.io/codex-usage-guide/workflows.html">
<meta property="og:type" content="website">
<meta property="og:locale" content="zh_CN">
<meta property="og:site_name" content="Codex 使用指南">
<meta property="og:title" content="任务路径">
<meta property="og:description" content="根据任务复杂度选择工作流，并用推荐 receipt 实践收口。">
<meta property="og:url" content="https://whojay0609.github.io/codex-usage-guide/workflows.html">
<meta property="og:image" content="https://whojay0609.github.io/codex-usage-guide/figures/social-preview.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="Codex 使用指南">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="任务路径">
<meta name="twitter:description" content="根据任务复杂度选择工作流，并用推荐 receipt 实践收口。">
<meta name="twitter:image" content="https://whojay0609.github.io/codex-usage-guide/figures/social-preview.png">
<meta name="twitter:image:alt" content="Codex 使用指南">
<!-- guide:metadata:end -->
</head>
<body>
  <!-- guide:header:start -->
<script src="assets/site-data.js"></script><a class="skip-link" href="#main-content">跳到正文</a><header class="topbar"><div class="topbar-inner"><a class="brand" href="index.html"><span class="brand-mark" aria-hidden="true"></span><span>Codex 使用指南</span></a><div class="topbar-actions"><label class="theme-control"><span class="sr-only">主题</span><select class="theme-select" id="theme-select" name="theme" aria-label="主题"><option value="light" selected>浅色</option><option value="dark">深色</option></select></label><span class="theme-status sr-only" aria-live="polite"></span><button class="search-trigger" type="button" aria-haspopup="dialog" aria-controls="site-search-dialog">搜索</button><button class="menu-toggle" type="button" aria-controls="global-nav" aria-expanded="false">目录</button></div></div></header><dialog class="search-dialog" id="site-search-dialog" role="dialog" aria-modal="true" aria-labelledby="site-search-title"><div class="search-dialog-panel"><div class="search-dialog-head"><p class="search-title" id="site-search-title">搜索全站</p><button class="search-close" type="button" aria-label="关闭搜索">关闭</button></div><label class="search-label" for="site-search-input">搜索标题、正文和可复用 prompt</label><input class="search-input" id="site-search-input" type="search" role="combobox" autocomplete="off" aria-autocomplete="list" aria-controls="site-search-results" aria-describedby="site-search-status" aria-expanded="false"><p class="search-message" id="site-search-status" aria-live="polite">输入关键词开始搜索。</p><ul class="search-results" id="site-search-results" role="listbox" aria-label="搜索结果"></ul></div></dialog>
<!-- guide:header:end -->

  <!-- guide:shell-open:start -->
<div class="toolbook-shell"><aside class="global-nav" id="global-nav" aria-label="全站导航"><section class="global-nav-group"><strong>开始</strong><a data-nav href="index.html">首页</a><a data-nav href="install-desktop.html">安装</a><a data-nav href="desktop-cli.html">Desktop</a></section><section class="global-nav-group"><strong>基础概念</strong><a data-nav href="codex.html">Codex</a><a data-nav href="git.html">Git</a><a data-nav href="worktrees.html">Worktrees</a><a data-nav href="permissions.html">权限</a><a data-nav href="agents-md.html">AGENTS.md</a><a data-nav href="skills.html">Skills</a><a data-nav href="mcp.html">MCP</a><a data-nav href="subagents.html">Subagents</a><a data-nav href="goal.html">Goal</a></section><section class="global-nav-group"><strong>任务路径</strong><a data-nav href="workflows.html" aria-current="page">任务</a><a data-nav href="daily-workflow.html">日常</a><a data-nav href="engineering.html">工程</a><a data-nav href="research.html">学术</a><a data-nav href="automation.html">定时任务</a></section><section class="global-nav-group"><strong>扩展与资料</strong><a data-nav href="compound-engineering.html">Compound</a><details class="global-nav-disclosure"><summary>Skills 仓库</summary><a data-nav href="skills-repositories.html">全部仓库</a><a href="skills-repositories.html#compound-engineering">Compound Engineering</a><a href="skills-repositories.html#mattpocock-skills">Matt Pocock skills</a><a href="skills-repositories.html#academic-research-skills-codex">ARS</a><a href="skills-repositories.html#aris-auto-claude-code-research-in-sleep">ARIS</a><a href="skills-repositories.html#refine-user-prompt">refine-user-prompt</a></details><a data-nav href="prompt-guidance.html">提示词</a><a data-nav href="resources.html">资料</a></section></aside><div class="toolbook-main"><nav class="breadcrumbs" aria-label="面包屑"><a href="index.html">首页</a><span aria-hidden="true">/</span><span>任务路径</span><span aria-hidden="true">/</span><span aria-current="page">任务</span></nav><div class="page-freshness"><span>页面更新：<time datetime="2026-08-06">2026-08-06</time></span><span>事实核验：<time datetime="2026-07-12">2026-07-12</time></span></div><aside class="page-toc" aria-label="本页目录"><details><summary>本页目录</summary><nav><a class="toc-h2" href="#先选工作面-再写任务">先选工作面，再写任务</a><a class="toc-h3" href="#安装-desktop">安装 Desktop</a><a class="toc-h3" href="#codex-desktop">Codex Desktop</a><a class="toc-h3" href="#日常小任务">日常小任务</a><a class="toc-h3" href="#工程-flow">工程 flow</a><a class="toc-h3" href="#学术-flow">学术 flow</a><a class="toc-h3" href="#自动化">定时任务</a><a class="toc-h3" href="#skills-仓库选择">Skills 仓库选择</a><a class="toc-h3" href="#compound-engineering">Compound Engineering</a><a class="toc-h2" href="#同一任务-小步练到可验收">同一任务，小步练到可验收</a><a class="toc-h3" href="#1.-现象">1. 现象</a><a class="toc-h3" href="#2.-合同">2. 合同</a><a class="toc-h3" href="#3.-最小执行">3. 最小执行</a><a class="toc-h3" href="#4.-验收请求">4. 验收请求</a><a class="toc-h3" href="#v1-只有愿望">V1：只有愿望</a><a class="toc-h3" href="#v2-补上下文与边界">V2：补上下文与边界</a><a class="toc-h3" href="#v3-补验收证据">V3：补验收证据</a><a class="toc-h2" href="#统一案例模板">统一案例模板</a><a class="toc-h2" href="#坏-prompt-怎么修">坏 prompt 怎么修</a><a class="toc-h3" href="#帮我优化项目">“帮我优化项目”</a><a class="toc-h3" href="#直接推送">“直接推送”</a><a class="toc-h3" href="#开-subagent-并行做">“开 subagent 并行做”</a><a class="toc-h2" href="#证据通过-才算-accepted">证据通过，才算 accepted</a><a class="toc-h3" href="#accepted">Accepted</a><a class="toc-h3" href="#not-accepted">Not accepted</a><a class="toc-h2" href="#先分类失败-再决定回路">先分类失败，再决定回路</a><a class="toc-h2" href="#用两种终态收口">用两种终态收口</a><a class="toc-h3" href="#done-receipt">Done receipt</a><a class="toc-h3" href="#blocked-receipt">Blocked receipt</a><a class="toc-h2" href="#真实实例-从一句反馈选择任务路径">真实实例：从一句反馈选择任务路径</a><a class="toc-h3" href="#1.-request">1. Request</a><a class="toc-h3" href="#2.-context-to-inspect">2. Context to inspect</a><a class="toc-h3" href="#3.-allowed-change">3. Allowed change</a><a class="toc-h3" href="#4.-validation-evidence">4. Validation evidence</a><a class="toc-h3" href="#5.-final-report">5. Final report</a><a class="toc-h3" href="#6.-failure-stop">6. Failure stop</a></nav></details></aside>
<!-- guide:shell-open:end -->
<main id="main-content">
    <section class="hero compact">
      <div class="hero-copy">
        <p class="hero-kicker">任务</p>
        <h1>任务路径总览</h1>
        <p class="lead">本指南默认你主要使用 Codex Desktop。先用桌面版把任务闭环跑通，再判断是否需要 Goal、subagent、skills 或自动化。任务页重点讲怎么做，不展开术语解释。</p>
      </div>
    </section>

    <section class="section" id="task-entry" data-loop-stage="choose">
      <div class="section-head">
        <div class="section-title">
          <p class="section-kicker">1 / 选择</p>
          <span class="fragment-alias" id="heading-workflows-1" data-canonical-fragment="先选工作面-再写任务" aria-hidden="true"></span><h2 id="先选工作面-再写任务">先选工作面，再写任务<a class="heading-permalink" data-heading-permalink data-search-exclude href="#先选工作面-再写任务" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2>
        </div>
        <p class="scrub-text">先按范围、风险和协作人数选入口。短小、低风险、单文件任务直接进入五阶段循环，不需要 Issue 或 Worktree；多文件、高风险或多人写入任务升级到 <a href="engineering.html#team-flow">团队工程流程</a>。</p>
      </div>
      <div class="decision-table">
        <div class="decision-row"><strong>短小 / 低风险 / 单文件</strong><span>Desktop 直接循环</span><span>固定一个写域</span><span>最窄验证后签发 receipt</span></div>
        <div class="decision-row"><strong>页面 / 视觉</strong><span>Desktop + in-app browser</span><span>先给页面与目标状态</span><span>URL、截图或页面抽样</span></div>
        <div class="decision-row"><strong>代码 / 测试</strong><span>Desktop + integrated terminal</span><span>保留失败日志与边界</span><span>最窄测试、构建或 diff</span></div>
        <div class="decision-row"><strong>多文件 / 高风险 / 多人写入</strong><span>升级团队工程流程</span><span>Issue、依赖与互斥写域</span><span>Worktree、PR、独立 review、CI</span></div>
        <div class="decision-row"><strong>稳定重复任务</strong><span>Scheduled tasks + 隔离环境</span><span>定义停止条件</span><span>运行记录与异常 receipt</span></div>
      </div>
      <div class="bento">
        <a class="source-card span-4" href="install-desktop.html"><span class="fragment-alias" id="heading-workflows-2" data-canonical-fragment="安装-desktop" aria-hidden="true"></span><h3 id="安装-desktop">安装 Desktop</h3><p>先完成安装、登录、打开仓库和第一个小任务。</p></a>
        <a class="source-card span-4" href="desktop-cli.html"><span class="fragment-alias" id="heading-workflows-3" data-canonical-fragment="codex-desktop" aria-hidden="true"></span><h3 id="codex-desktop">Codex Desktop</h3><p>先学桌面版线程、浏览器反馈、审批、diff review 和发布验证。</p></a>
        <a class="source-card span-4" href="daily-workflow.html"><span class="fragment-alias" id="heading-workflows-4" data-canonical-fragment="日常小任务" aria-hidden="true"></span><h3 id="日常小任务">日常小任务</h3><p>读代码、解释错误、修 bug、跑测试、审查 diff，通常不需要 Goal。</p></a>
        <a class="source-card span-4" href="engineering.html"><span class="fragment-alias" id="heading-workflows-5" data-canonical-fragment="工程-flow" aria-hidden="true"></span><h3 id="工程-flow">工程 flow</h3><p>复杂功能先 grill，再 PRD，再 issues，再实现和 review。</p></a>
        <a class="source-card span-4" href="research.html"><span class="fragment-alias" id="heading-workflows-6" data-canonical-fragment="学术-flow" aria-hidden="true"></span><h3 id="学术-flow">学术 flow</h3><p>从 research brief 到文献、新颖性、实验、审稿和写作边界。</p></a>
        <a class="source-card span-4" href="automation.html"><span class="fragment-alias" id="heading-workflows-7" data-canonical-fragment="自动化" aria-hidden="true"></span><h3 id="自动化">定时任务</h3><p>把稳定重复任务放进 Scheduled tasks，并用后台 worktree 隔离改动。</p></a>
        <a class="source-card span-4" href="skills-repositories.html"><span class="fragment-alias" id="heading-workflows-8" data-canonical-fragment="skills-仓库选择" aria-hidden="true"></span><h3 id="skills-仓库选择">Skills 仓库选择</h3><p>当任务适合第三方 skills 仓库时，先选 Compound、Matt、ARS 或 ARIS，再写 prompt。</p></a>
        <a class="source-card span-4" href="compound-engineering.html"><span class="fragment-alias" id="heading-workflows-9" data-canonical-fragment="compound-engineering" aria-hidden="true"></span><h3 id="compound-engineering">Compound Engineering</h3><p>插件场景：如何用 /ce-brainstorm、/ce-plan、/ce-work 和 review 组织长任务。</p></a>
      </div>
    </section>

    <section class="section" id="bounded-practice" data-loop-stage="practice">
      <div class="section-head">
        <div class="section-title"><p class="section-kicker">2 / 实践</p><span class="fragment-alias" id="heading-workflows-10" data-canonical-fragment="同一任务-小步练到可验收" aria-hidden="true"></span><h2 id="同一任务-小步练到可验收">同一任务，小步练到可验收<a class="heading-permalink" data-heading-permalink data-search-exclude href="#同一任务-小步练到可验收" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2></div>
        <p>prompt ladder 针对同一个真实任务逐步补齐上下文、边界和验收，不要中途换成更容易的演示任务。每一步只做当前最小改动，完成后立即检查 diff 和局部行为。</p>
      </div>
      <div class="steps">
        <article class="step"><span class="fragment-alias" id="heading-workflows-11" data-canonical-fragment="1.-现象" aria-hidden="true"></span><h3 id="1.-现象">1. 现象<a class="heading-permalink" data-heading-permalink data-search-exclude href="#1.-现象" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>指出当前页面、仓库或失败命令，以及实际发生了什么。</p></article>
        <article class="step"><span class="fragment-alias" id="heading-workflows-12" data-canonical-fragment="2.-合同" aria-hidden="true"></span><h3 id="2.-合同">2. 合同<a class="heading-permalink" data-heading-permalink data-search-exclude href="#2.-合同" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>补齐目标、允许写域、禁区和可以接受的行为变化。</p></article>
        <article class="step"><span class="fragment-alias" id="heading-workflows-13" data-canonical-fragment="3.-最小执行" aria-hidden="true"></span><h3 id="3.-最小执行">3. 最小执行<a class="heading-permalink" data-heading-permalink data-search-exclude href="#3.-最小执行" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>先读约束，只改最小范围；不因验证困难而换成演示任务。</p></article>
        <article class="step"><span class="fragment-alias" id="heading-workflows-14" data-canonical-fragment="4.-验收请求" aria-hidden="true"></span><h3 id="4.-验收请求">4. 验收请求<a class="heading-permalink" data-heading-permalink data-search-exclude href="#4.-验收请求" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>明确要运行的测试、页面检查或外部状态核对，再进入证据门。</p></article>
      </div>
      <div class="bento">
        <article class="card span-4"><span class="fragment-alias" id="heading-workflows-15" data-canonical-fragment="v1-只有愿望" aria-hidden="true"></span><h3 id="v1-只有愿望">V1：只有愿望<a class="heading-permalink" data-heading-permalink data-search-exclude href="#v1-只有愿望" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><pre><code>帮我优化任务页。</code></pre><p>缺少现象、写域和完成标准，Codex 只能猜。</p></article>
        <article class="card span-4"><span class="fragment-alias" id="heading-workflows-16" data-canonical-fragment="v2-补上下文与边界" aria-hidden="true"></span><h3 id="v2-补上下文与边界">V2：补上下文与边界<a class="heading-permalink" data-heading-permalink data-search-exclude href="#v2-补上下文与边界" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><pre><code>在 workflows.html 增加任务闭环。
只改这个页面，不改 CSS 和导航。
先读 AGENTS.md 与现有页面结构。</code></pre><p>同一个任务变得可执行，但还不能证明完成。</p></article>
        <article class="card span-4"><span class="fragment-alias" id="heading-workflows-17" data-canonical-fragment="v3-补验收证据" aria-hidden="true"></span><h3 id="v3-补验收证据">V3：补验收证据<a class="heading-permalink" data-heading-permalink data-search-exclude href="#v3-补验收证据" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><pre><code>沿用上面的范围。
验收：五个阶段各有唯一锚点并按顺序出现；
项目已有的验证命令通过（例如 npm test 或 make check）；桌面和 390px 页面无溢出。
失败时保留错误并进入 blocked receipt。</code></pre><p>同一个任务现在有可复核的 done / blocked 条件。</p></article>
      </div>
      <div class="content-block">
        <p class="section-kicker">Prompt 骨架</p>
        <span class="fragment-alias" id="heading-workflows-18" data-canonical-fragment="统一案例模板" aria-hidden="true"></span><h2 id="统一案例模板">统一案例模板<a class="heading-permalink" data-heading-permalink data-search-exclude href="#统一案例模板" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2>
        <pre><code>背景：
我正在 Codex Desktop 里处理 [项目/论文/网页]。
当前页面/仓库是：[当前已打开的仓库或仓库内相对路径]。
当前问题是：[具体现象]。

目标：
请完成 [可验收结果]。

范围：
- 可以改：[文件/目录/页面]
- 不要改：[禁区/外部接口/已有用户改动]

要求：
- 先读 AGENTS.md、README 和相关源码
- 改动前说明你准备改哪里
- 需要联网、启动服务或推送前先说明理由
- 完成后运行最窄验证

验收：
- [测试/构建/页面访问/截图/commit/push]
- 最终报告列出改动、验证、风险和未完成项</code></pre>
      </div>
      <div class="section-head">
        <div class="section-title"><p class="section-kicker">反例</p><span class="fragment-alias" id="heading-workflows-19" data-canonical-fragment="坏-prompt-怎么修" aria-hidden="true"></span><h2 id="坏-prompt-怎么修">坏 prompt 怎么修<a class="heading-permalink" data-heading-permalink data-search-exclude href="#坏-prompt-怎么修" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2></div>
        <p>反例可以帮助找出缺失的边界。每次修改 prompt，都补上范围、验收、验证和停止条件。</p>
      </div>
      <div class="bento">
        <article class="card span-4 repair-card"><span class="fragment-alias" id="heading-workflows-20" data-canonical-fragment="帮我优化项目" aria-hidden="true"></span><h3 id="帮我优化项目">“帮我优化项目”<a class="heading-permalink" data-heading-permalink data-search-exclude href="#帮我优化项目" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>改成：说明目标页面/目录、目标读者、允许改的文件、验收命令和不碰的边界。</p></article>
        <article class="card span-4 repair-card"><span class="fragment-alias" id="heading-workflows-21" data-canonical-fragment="直接推送" aria-hidden="true"></span><h3 id="直接推送">“直接推送”<a class="heading-permalink" data-heading-permalink data-search-exclude href="#直接推送" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>改成：先报告 diff 和验证结果，再说明推送目标和公开页面抽样方式。</p></article>
        <article class="card span-4 repair-card"><span class="fragment-alias" id="heading-workflows-22" data-canonical-fragment="开-subagent-并行做" aria-hidden="true"></span><h3 id="开-subagent-并行做">“开 subagent 并行做”<a class="heading-permalink" data-heading-permalink data-search-exclude href="#开-subagent-并行做" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>改成：列出每个写域、等待点、输出合同、集成负责人和冲突处理方式。</p></article>
      </div>
    </section>

    <section class="section" id="acceptance-evidence" data-loop-stage="evidence">
      <div class="section-head">
        <div class="section-title"><p class="section-kicker">3 / 证据</p><span class="fragment-alias" id="heading-workflows-23" data-canonical-fragment="证据通过-才算-accepted" aria-hidden="true"></span><h2 id="证据通过-才算-accepted">证据通过，才算 accepted<a class="heading-permalink" data-heading-permalink data-search-exclude href="#证据通过-才算-accepted" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2></div>
        <p>实现摘要本身不是验收证据。先按任务合同收集对应证据，再由用户、reviewer 或既定自动门判定 <code>accepted</code>；未 accepted 的任务不能进入 done。</p>
      </div>
      <div class="decision-table">
        <div class="decision-row"><strong>代码测试</strong><span>测试或构建命令</span><span>退出码与关键结果</span><span>覆盖实际改动路径</span></div>
        <div class="decision-row"><strong>页面证据</strong><span>目标 URL</span><span>截图或关键页面抽样</span><span>核对响应式与目标状态</span></div>
        <div class="decision-row"><strong>PR / CI</strong><span>PR 链接或标识</span><span>review disposition</span><span>CI checks 全部满足合同</span></div>
        <div class="decision-row"><strong>人工验收</strong><span>验收人和对象</span><span>明确 accepted / rejected</span><span>保留条件或反馈</span></div>
      </div>
      <div class="bento">
        <article class="card span-6"><span class="fragment-alias" id="heading-workflows-24" data-canonical-fragment="accepted" aria-hidden="true"></span><h3 id="accepted">Accepted<a class="heading-permalink" data-heading-permalink data-search-exclude href="#accepted" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>合同中的必需证据齐全且结论通过，进入 receipt，记录 done。</p></article>
        <article class="card span-6 dark-card"><span class="fragment-alias" id="heading-workflows-25" data-canonical-fragment="not-accepted" aria-hidden="true"></span><h3 id="not-accepted">Not accepted<a class="heading-permalink" data-heading-permalink data-search-exclude href="#not-accepted" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>证据失败、缺失或无法执行，进入 recovery；不得用“代码已写”替代验证。</p></article>
      </div>
    </section>

    <section class="section" id="recovery" data-loop-stage="recover">
      <div class="section-head">
        <div class="section-title"><p class="section-kicker">4 / 恢复</p><span class="fragment-alias" id="heading-workflows-26" data-canonical-fragment="先分类失败-再决定回路" aria-hidden="true"></span><h2 id="先分类失败-再决定回路">先分类失败，再决定回路<a class="heading-permalink" data-heading-permalink data-search-exclude href="#先分类失败-再决定回路" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2></div>
        <p>验证失败先保留原命令、错误和已确认事实，再区分实现问题与外部 blocker。恢复动作必须仍服务于原任务合同。</p>
      </div>
      <div class="decision-table">
        <div class="decision-row"><strong>实现失败</strong><span>行为、断言或 diff 与合同冲突</span><span>定位最小失败切片并修复</span><span>回 practice，重跑原验收</span></div>
        <div class="decision-row"><strong>环境失败</strong><span>瞬时服务、端口或临时资源问题</span><span>确认幂等后有限重试</span><span>仍失败则 blocked receipt</span></div>
        <div class="decision-row"><strong>缺失依赖</strong><span>缺包、服务、数据或磁盘资源</span><span>不伪造降级结果，列解锁条件</span><span>handoff 或 blocked receipt</span></div>
        <div class="decision-row"><strong>权限拒绝</strong><span>缺少审批或外部写入 grant</span><span>停止越权动作</span><span>blocked receipt</span></div>
        <div class="decision-row"><strong>来源不确定</strong><span>事实无法由可信来源支持</span><span>停止发布该主张或降级为演示</span><span>handoff 或 blocked receipt</span></div>
        <div class="decision-row"><strong>产品待决</strong><span>验收口径冲突或需求待裁决</span><span>不自行猜测产品决定</span><span>回负责人或 blocked receipt</span></div>
      </div>
    </section>

    <section class="section" id="task-receipt" data-loop-stage="receipt">
      <div class="section-head">
        <div class="section-title"><p class="section-kicker">5 / 回执</p><span class="fragment-alias" id="heading-workflows-27" data-canonical-fragment="用两种终态收口" aria-hidden="true"></span><h2 id="用两种终态收口">用两种终态收口<a class="heading-permalink" data-heading-permalink data-search-exclude href="#用两种终态收口" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2></div>
        <p><strong>receipt 是本指南推荐的任务收口实践</strong>，不是 Codex 原生 UI 功能。本指南把它分为 <code>done</code> 或 <code>blocked</code>；两者都应列出 changed scope、<code>behavior_changed</code>、验证证据、风险或阻塞，以及明确下一步。</p>
      </div>
      <div class="bento">
        <article class="card span-6"><span class="fragment-alias" id="heading-workflows-28" data-canonical-fragment="done-receipt" aria-hidden="true"></span><h3 id="done-receipt">Done receipt<a class="heading-permalink" data-heading-permalink data-search-exclude href="#done-receipt" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p><strong>changed scope：</strong>实际改动文件或页面；<strong>behavior_changed：</strong>用户可观察变化；<strong>验证证据：</strong>accepted 的命令、URL、截图、PR/CI 或人工结论；<strong>风险：</strong>剩余风险；<strong>下一步：</strong>发布、观察或无需动作。</p></article>
        <article class="card span-6 dark-card"><span class="fragment-alias" id="heading-workflows-29" data-canonical-fragment="blocked-receipt" aria-hidden="true"></span><h3 id="blocked-receipt">Blocked receipt<a class="heading-permalink" data-heading-permalink data-search-exclude href="#blocked-receipt" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p><strong>changed scope：</strong>已完成与未完成边界；<strong>behavior_changed：</strong>当前是否已有行为变化；<strong>验证证据：</strong>已通过与无法执行项；<strong>阻塞：</strong>权限、依赖、来源或产品决定；<strong>下一步：</strong>责任人和解锁条件。</p></article>
      </div>
      <div class="content-block">
        <p class="section-kicker">真实实例</p>
        <span class="fragment-alias" id="heading-workflows-30" data-canonical-fragment="真实实例-从一句反馈选择任务路径" aria-hidden="true"></span><h2 id="真实实例-从一句反馈选择任务路径">真实实例：从一句反馈选择任务路径<a class="heading-permalink" data-heading-permalink data-search-exclude href="#真实实例-从一句反馈选择任务路径" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2>
        <p>用户在 Codex Desktop 的浏览器里说“每个内容都加一个真实的实例”。这个请求涉及多个页面，需要发布，也可能多人写入，因此从 choose 阶段升级到 <a href="engineering.html#team-flow">团队工程流程</a>，但仍使用同一份验收合同直到 receipt。</p>
        <div class="bento">
          <article class="card span-4"><span class="fragment-alias" id="heading-workflows-31" data-canonical-fragment="1.-request" aria-hidden="true"></span><h3 id="1.-request">1. Request<a class="heading-permalink" data-heading-permalink data-search-exclude href="#1.-request" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>给主要内容加入真实实例，让读者能照着完成任务。</p></article>
          <article class="card span-4"><span class="fragment-alias" id="heading-workflows-32" data-canonical-fragment="2.-context-to-inspect" aria-hidden="true"></span><h3 id="2.-context-to-inspect">2. Context to inspect<a class="heading-permalink" data-heading-permalink data-search-exclude href="#2.-context-to-inspect" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p><code>AGENTS.md</code>、现有页面与导航、案例模式、静态检查和发布说明。</p></article>
          <article class="card span-4"><span class="fragment-alias" id="heading-workflows-33" data-canonical-fragment="3.-allowed-change" aria-hidden="true"></span><h3 id="3.-allowed-change">3. Allowed change<a class="heading-permalink" data-heading-permalink data-search-exclude href="#3.-allowed-change" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>只改批准的 HTML、案例索引和必要检查；不改共享样式、公共导航或无关 dirty 文件。</p></article>
          <article class="card span-4"><span class="fragment-alias" id="heading-workflows-34" data-canonical-fragment="4.-validation-evidence" aria-hidden="true"></span><h3 id="4.-validation-evidence">4. Validation evidence<a class="heading-permalink" data-heading-permalink data-search-exclude href="#4.-validation-evidence" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>语义负向测试、全站链接/锚点检查、diff review、浏览器与公开页面抽样。</p></article>
          <article class="card span-4"><span class="fragment-alias" id="heading-workflows-35" data-canonical-fragment="5.-final-report" aria-hidden="true"></span><h3 id="5.-final-report">5. Final report<a class="heading-permalink" data-heading-permalink data-search-exclude href="#5.-final-report" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>列 changed scope、<code>behavior_changed</code>、证据、PR/发布状态、剩余风险与未执行项。</p></article>
          <article class="card span-4 dark-card"><span class="fragment-alias" id="heading-workflows-36" data-canonical-fragment="6.-failure-stop" aria-hidden="true"></span><h3 id="6.-failure-stop">6. Failure stop<a class="heading-permalink" data-heading-permalink data-search-exclude href="#6.-failure-stop" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p>来源或脱敏不足、写域扩大、验证失败、外部写入未授权，或公开页面无法确认时停止并给 blocked receipt。</p></article>
        </div>
        <pre><code>路径选择：
1. choose：确认多文件范围并升级团队流程
2. practice：在同一任务上逐页小步修改
3. evidence：运行静态检查并抽样公开 URL
4. recover：失败时按实现问题或发布 blocker 分类
5. receipt：仅在证据 accepted 后记录 done，否则记录 blocked</code></pre>
      </div>
    </section>
  </main>
<!-- guide:shell-close:start -->
<nav class="page-sequence" aria-label="前后页"><a rel="prev" href="goal.html">← Goal</a><a rel="next" href="daily-workflow.html">日常 →</a></nav></div></div>
<!-- guide:shell-close:end -->

  <footer class="footer">
    <p><strong>任务路径</strong><br>从任务选择开始，逐步进入工程、学术和自动化场景。</p>
    <a class="button" href="resources.html">资料地图</a>
  </footer>
  <!-- guide:runtime:start -->
<script src="assets/site.js"></script>
<!-- guide:runtime:end -->
</body>
</html>