目标与评分标准

为 Deep Agents Code 会话定义目标与验收标准

目标与评分标准帮助 Deep Agents Code 检查其工作是否满足你在意的标准。当工作以目标驱动、且希望由智能体协助确定验收标准时使用目标；当你已经明确标准时使用评分标准。

选择目标还是评分标准

当你有一个可衡量的目标、并希望 Deep Agents Code 在开始之前先起草验收标准时，请使用目标。目标有生命周期：一旦被接受，它会跨多个轮次保持生效，直到你暂停它、智能体将其标记为已完成或受阻，或你清除它。你也可以在不停掉当前工作的前提下修改一个生效中的目标。

当你已经明确希望据以评判智能体的标准时，请使用评分标准。评分标准可以只作用于下一轮，也可以跨后续轮次持续生效。

常见用法：

• 单个目标、由智能体起草标准：使用 /goal <objective>。
• 每轮都生效的标准：使用 /rubric set <criteria>。
• 标准存放在文件中：使用 /rubric file <path>。
• 仅一轮的质量门禁：使用 /rubric next <criteria>。

使用目标

当你知道想要的结果、但希望由 Deep Agents Code 在工作开始前提出验收标准时，请使用 /goal。目标适用于开放式工作：智能体把一个目标转化为具体的「完成定义」，然后迭代直到满足这些标准。

/goal add OAuth refresh handling

Deep Agents Code 会在开始任务之前起草验收标准供你审阅。

起草出来的标准如何处理，取决于你的审批模式：

各审批模式下的审阅行为

• Manual：始终打开内联审阅。
• Auto：默认打开审阅。可在 ~/.deepagents/config.toml 中设置 goals.auto_accept_criteria = true，以自动应用生成的标准。
• YOLO：不经审阅直接应用生成的标准。

标准被接受后，该目标会跨多个轮次保持生效，直到它被暂停、完成、受阻或清除。

这种方式让你可以跨多个轮次逐步推进一个更大的目标：

/goal migrate auth callbacks to the new API
start with the OAuth callback
now update the tests
check the docs too

输入框上方的目标面板会显示当前目标，以及它是生效中、已暂停、已受阻还是已完成。使用 /goal show 查看当前目标，使用 /goal clear 将其移除。

修改、暂停与恢复目标

在不必取消当前任务、重跑已有工作的前提下调整进行中的目标：

• /goal amend <feedback> 提出对目标和标准的协同更新。该修订在最终确定前会经过同样的内联审阅（接受、编辑、修改或取消）。
• /goal pause 保存目标，但不再让它驱动工作或评分，因此其间的提示词在运行时不受它影响。/goal resume 重新激活已保存的目标，并从现有对话继续。

/goal amend remove JSON export, add streaming CSV support, keep the CSV tests
/goal pause
/goal resume

完成与评分

每一轮后续对话都会依据目标的验收标准进行评分，直到工作完成。

• 当目标的完成情况获得批准时，Deep Agents Code 会清除该目标

Goal 命令参考

• /goal <objective>：根据用自然语言描述的目标草拟验收标准，并在工作开始前对其进行审阅。
• /goal amend <feedback>：提出对目标和标准的协同更新，以供审阅。
• /goal pause：保存目标，但不再让它驱动工作或评分。
• /goal resume：重新激活已暂停的目标，并从现有对话继续。
• /goal show：查看当前目标、其状态及其标准。
• /goal clear：移除当前生效的目标。
• /goal model [provider:model|clear]：设置或清除用于对目标评分的模型。
• /goal max-iterations <N|clear>：设置或清除目标的最大评分迭代次数。

使用评分标准（rubric）

当你已经明确验收标准，并希望它们充当智能体工作的质量关卡时，请使用 /rubric。

/rubric set tests pass; no unrelated files changed; help text is updated
/rubric next only change the auth callback; do not refactor unrelated code
/rubric file acceptance.md

常驻评分标准在被清除之前会一直应用于后续轮次。仅下一轮生效的评分标准只应用于下一次提交的任务。

Rubric 命令参考

• /rubric show：查看当前生效的评分标准。
• /rubric clear：移除当前生效的评分标准。
• /rubric model <provider:model>：设置用于对评分标准结果评分的模型。

在非交互模式下使用评分标准

非交互式运行无法暂停以进行目标审阅。对于标准已经确定的任务，请使用 --rubric：

dcode -n "implement OAuth refresh handling" --rubric "tests pass; no unrelated files changed"
dcode -n "implement OAuth refresh handling" --rubric @acceptance.md

你还可以设置评分模型和最大评分迭代次数：

dcode -n "implement OAuth refresh handling" \
  --rubric "tests pass; no unrelated files changed" \
  --rubric-model openai:gpt-5.5 \
  --rubric-max-iterations 3

另请参阅

• Deep Agents Code 概述
• 快速开始

---