queue
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseQueue
决策队列
Turn every unanswered question in the conversation into a decision, then put the
decisions to the user on one page and work through them in rounds.
将对话中每个尚未回答的问题转化为一个决策,然后把所有决策集中放在一个页面上,并分轮次逐一推进。
Decision
决策
A decision is a question the user can settle in one read. Each carries:
- Title: the question or the proposed action, in one line.
- Summary: what is being decided and why it came up, in one or two short paragraphs.
- Evidence: one line per fact, each tagged with how you know it and linked to its
source (issue, PR, commit, file line, test, log):
- : you executed it this session.
ran - : you observed it in the running app or its output.
seen - : you read the source or document yourself.
read - : a subagent or another tool said so and you did not re-check it.
reported - : a person's statement, such as an issue thread or a PR description.
claimed
- Options: two to four mutually exclusive choices, each with its consequence in one sentence. Mark the one you recommend. Leave all unmarked only when the choice is taste.
- Danger: the door (when the choice can be undone,
two-waywhen it cannot) and the blast radius in a few words.one-way - Draft: the exact text that will be posted or sent if the user accepts, when there is one.
Facts are your job. Look up, run, or dispatch a subagent for anything the environment can
answer, and bring the result as evidence. Only what the user must judge becomes a decision.
Ask the frontier: the decisions whose prerequisites are already settled. A decision that
depends on an open one waits for a later round.
Order decisions with the ones an agent is blocked on first, then by group.
决策是用户阅读一次就能确定的问题。每个决策包含:
- 标题:以一行概括问题或拟采取的操作。
- 摘要:用一到两个简短段落说明正在决定什么,以及为什么需要做出这个决定。
- 证据:每项事实占一行,并标注你如何获知该事实,同时链接到其来源(issue、PR、commit、文件行、test、log):
- :你在本次会话中执行过。
ran - :你在运行中的应用或其输出中观察到。
seen - :你亲自阅读过相关源代码或文档。
read - :由 subagent 或其他工具告知,但你没有重新核查。
reported - :由某个人陈述,例如 issue 讨论串或 PR 描述。
claimed
- 选项:提供两到四个互斥选项,每个选项用一句话说明其后果。标记你推荐的选项。只有当选择取决于个人偏好时,才将所有选项都留为未标记状态。
- 风险:标明决策方向(可撤销时为 ,不可撤销时为
two-way),并用几个词描述影响范围。one-way - 草稿:如果用户接受决策后需要发布或发送内容,请提供将要发布或发送的确切文本。
事实核查是你的职责。对于环境能够回答的问题,应主动查找、运行或派发 subagent,并将结果作为证据带回。只有需要用户判断的内容才应成为决策。
确定当前可推进的决策:前置条件已经确定的决策可以立即提出;依赖尚未确定决策的事项则留待后续轮次。
排序时,先放置 agent 正在等待的决策,然后按分组排列。
Page
页面
Put each round on one self-contained HTML page. Follow PAGE.md for the queue
file, the visuals, the build command and how answers come back.
将每一轮决策放在一个自包含的 HTML 页面中。队列文件、视觉设计、构建命令以及答案回传方式请遵循 PAGE.md。
Rounds
轮次
The user may answer only some decisions. After each set of answers:
- Act on every decision that has a choice. A choice the user made approves that decision's draft and action, including an edited draft.
- Reply to every note that came without a choice. It is a question or a steer: answer it with new evidence, or reshape the decision and its options.
- Recompute the frontier and ask the next round: the decisions still open, the ones reshaped by a note, and the ones the answers unblocked.
The work is done when every decision is settled or the user says to stop. When no
unanswered question exists at the start, say so and stop.
用户可以只回答部分决策。每次收到一组答案后:
- 执行每个已有选择的决策。用户做出选择即视为批准该决策的草稿和操作,包括用户编辑后的草稿。
- 回复每条未附带选择意见的备注。这些备注可能是问题或引导;应使用新的证据回答,或重新调整决策及其选项。
- 重新计算当前可推进的决策,并提出下一轮问题:仍未确定的决策、因备注而调整的决策,以及因用户回答而解除阻塞的决策。
当所有决策均已确定,或用户要求停止时,工作即告完成。如果开始时不存在任何尚未回答的问题,应直接说明并停止。