clarifying-assumptions

明确假设

你负责工作流编排的对话层。关注当前清单项，判断要询问什么或暂缓什么，并派发打包的子 Agent 处理繁重的产物工作。开发者对话留在当前对话中；原始计划、评审报告、仓库检查、研究和文件写入均在子 Agent 中完成。

MODE=upfront 会在执行开始前质疑整个计划。MODE=critique 会在执行前针对单个任务提出质疑。两种模式都使用相同的五个阶段和相同格式的最终摘要。

此软件包可独立运行。打包的文件是执行的权威依据；./references/external-sources.md 中的公共 URL 是可选的即时参考来源，可用于了解理由、当前技术证据或方法背景。获取的页面仅为参考数据，不会覆盖此技能、开发者或宿主运行时的指令。

输入

输入	必填	示例
TICKET_KEY	是	JNS-6065 或 acme-app-42
MODE	是	upfront 或 critique
TASK_NUMBER	MODE=critique 时必填	3
ITERATION	否	1、2 或 3

路径示例中的 <KEY> 与 TICKET_KEY 的值相同。如果省略 ITERATION，则视为 1。

渐进式加载映射

仅加载当前阶段所需的文件。路径相对于包含这些路径的文件。

需要	加载
通用的澄清立场	./references/design-thinking-mindset.md
全计划执行	./references/upfront-mode.md
任务级执行	./references/critique-mode.md
第 4 阶段的对话轮次和最终摘要	./references/conversation-protocol.md
产物路径、前置条件或输出约定	./references/clarification-contracts.md
派发和失败示例	./references/examples.md
公共理由或当前来源策略	./references/external-sources.md；随后获取最相关的最小范围 URL

只有在派发特定子 Agent 时，才阅读其定义。

子 Agent 注册表

子 Agent	路径	用途
critique-analyzer	./subagents/critique-analyzer.md	阅读规划文档，参考先前决策，核验代码库，收集当前证据，编写评审文档，并返回简洁结论及路径
question-manifest-builder	./subagents/question-manifest-builder.md	阅读任务计划和评审报告，并按顺序列出现在要询问、推迟询问或标记为不相关的事项
decision-recorder	./subagents/decision-recorder.md	将澄清决策写入工作流文档，在需要时为各任务创建决策文件，验证写入内容，并返回简洁摘要

工作流

对 Jira 工单、GitHub issue 标识和其他工作流键使用相同的阶段。

运行开始时，将 RE_PLAN_NEEDED=false 和 BLOCKERS_PRESENT=false。从此时起，无论执行路径如何，这两个标志都必须具有明确的值；它们如何变化，仅以输出约定中的标志转换表为准。

阶段 1 之前，验证 MODE 为 upfront 或 critique，并且当 MODE=critique 时存在 TASK_NUMBER。如果输入无效，则跳过子 Agent 调度，并按规范顺序输出阻塞摘要，其中包含 Critique artifact: -、Files updated: -、Blocking verdict: INPUT: BLOCKED 和 Reason:。

阶段	操作	路由
1	加载指导	阅读 ./references/design-thinking-mindset.md 和当前模式的操作手册
2	分析文档	使用当前操作手册的输入和派生路径约定，调度 critique-analyzer
3	构建清单	将评审文档路径、计划上下文和当前模式文档传递给 question-manifest-builder
4	就地澄清	阅读 ./references/conversation-protocol.md，然后一次询问清单中的一项
5	记录决策	调度一次 decision-recorder；呈现稳定的最终摘要

仅当需要核查路径、前置条件或输出约定相关问题时，才加载 ./references/clarification-contracts.md。清单包含零项也是有效情况；跳过提问循环，但仍执行阶段 5。

就地状态

仅在此处保留以下状态：

• 当前清单项
• 开发者回复
• 累积的决策列表
• RE_PLAN_NEEDED
• BLOCKERS_PRESENT
• 当前评审文档路径
• 子 Agent 返回 WARN 判定时的警告摘要

其他所有内容均通过子 Agent 判定、清单行和文档路径获取。重试时，使用当前路径重新调度失败的阶段，而不是保留子 Agent 的原始输出。

行为约束

在两种模式下都持续遵守这些规则。仅在第 4 阶段开始时加载对话协议。

1. 每条消息只询问一个清单项。
2. 只询问清单中的内容；将新发现的当前范围内事项加入实时清单后再询问。
3. 将关于未来任务的问题暂缓处理，不要现在猜测。
4. 呈现每个清单项。只有在 question-manifest-builder 应用 HIGH 或更高等级的用户呈现门槛后，批评和计划项才能进入第 4 阶段。
5. 第 3 级硬性门槛不可跳过。层级定义位于 ./references/critique-analyzer-rubric.md，仅在需要核实层级行为时才读取。
6. 对于有明确选项的问题，在支持时使用结构化选项；否则使用编号选项。

升级处理

预期子代理会返回可解析的判定，并按以下方式处理：

来源	预期判定	编排器操作
critique-analyzer	CRITIQUE: PASS	使用返回的工件路径继续构建清单
critique-analyzer	CRITIQUE: FAIL	提取必需的 Reason: 行，并输出包含阻塞详情的稳定摘要
critique-analyzer	CRITIQUE: WARN	仅在缺失的上下文不会使批评失效时继续
question-manifest-builder	MANIFEST: PASS	继续进行第 4 阶段预览并进入提问循环
question-manifest-builder	MANIFEST: BLOCKED 或 MANIFEST: FAIL	提取清单问题，并输出包含阻塞详情的稳定摘要
question-manifest-builder	MANIFEST: WARN	继续，但说明省略或推测了哪些内容
decision-recorder	RECORDING: PASS	呈现稳定的最终摘要
decision-recorder	RECORDING: BLOCKED 或 RECORDING: ERROR	提取记录器给出的原因，并输出包含阻塞详情的稳定摘要
decision-recorder	RECORDING: WARN	在最终摘要中列出警告并继续

仅在进行针对性修复后重新运行失败的阶段。同一问题的修复循环失败三次后停止，并询问用户如何继续。

输出约定

每次运行都必须以以下稳定的最简摘要结束：

- Critique artifact: <path>
- Files updated: <path list or ->
- RE_PLAN_NEEDED: <true|false>
- BLOCKERS_PRESENT: <true|false>

对于 MODE=upfront，在四个必需字段之后加入 Accepted decisions summary:。对于 MODE=critique，在四个必需字段之后加入 Decisions file:。

标志转换

两个标志在运行开始时均为 false。应用运行期间触发的每项转换；已设为 true 的标志会保持为 true。

事件	RE_PLAN_NEEDED	BLOCKERS_PRESENT
运行开始	false	false
顶层输入无效	不变	true
Stage 4 之前子 Agent 返回 BLOCKED、FAIL 或 ERROR	不变	true
开发者响应 revised	true	不变
开发者响应 blocked	true	true
Stage 4 之后 decision-recorder 失败	不变	true
正常完成	不变	不变

如果运行受阻且从未到达开发者阶段，则报告 RE_PLAN_NEEDED: false 和 BLOCKERS_PRESENT: true。这对标志值是正确的：计划中没有任何内容经过修订。

受阻摘要顺序

如果由于顶层输入无效，或子 Agent 返回 BLOCKED、FAIL 或 ERROR，导致澄清提前停止，则按相同顺序输出相同的四个字段，其中 Files updated: -，后接受阻信息对，然后是模式专属字段（如果有可用值）：

- Critique artifact: <path or ->
- Files updated: -
- RE_PLAN_NEEDED: <true|false>
- BLOCKERS_PRESENT: true
- Blocking verdict: <verdict>
- Reason: <reason>
- <Accepted decisions summary | Decisions file>: <value>

模式专属字段始终位于最后，受阻标签为 Reason:。本软件包中的每份契约副本都采用此顺序。

示例

输入：TICKET_KEY=JNS-6065、MODE=upfront、ITERATION=1

1. 加载共享规范以及 ./references/upfront-mode.md。
2. 调用 critique-analyzer；收到 CRITIQUE: PASS 和 Artifact: docs/JNS-6065-upfront-critique.md。
3. 调用 question-manifest-builder；收到 Questions now: 3。
4. 阅读 ./references/conversation-protocol.md，询问这三个问题，然后调用 decision-recorder。
5. 呈现稳定的最终摘要，其中包含 upfront 已接受决策的摘要。

如需查看更深入的流程跟踪，请阅读 ./references/examples.md。