• 文档
• 教程
• AI 技能

/goal是 Claude Code v2.1.139 起提供的会话级命令，它让 Agent 在一次任务中跨多个回合持续工作，直到一个由 Haiku 模型评估的完成条件被满足为止；Codex、Hermes Agent 也已支持同类能力。本篇以 claude-code-best-practice 仓库中的 Goal 实现文档 为主体，结合 命令参考 与仓库 changelog 证据，完整讲解/goal的用法、工作原理、与/loop/ auto mode 的边界，以及社区验证过的两条高杠杆提示词技巧，让你能把耗时数小时的"长跑任务"交给 Agent 自动完成。

/goal是什么：条件驱动的跨轮次执行

/goal的核心语义是：设定一个目标条件，Claude 持续工作、跨越多个回合，直到该条件成立才停止。它与一次性的"执行这个任务然后结束"模式不同——普通会话里 Claude 完成一轮就停下来等待用户，而/goal让它在每个回合结束后自行判断"条件是否已满足"，未满足就继续下一轮。

从仓库内的实现证据看，/goal在 concepts changelog 中被记录为 v2.1.139 引入的新概念，并明确标注其机制是"session-scoped Stop hook wrapper"——即它本质上是包装在会话级 Stop hook 之上的能力：每当 Claude 在一个回合结束（Stop 事件）时，钩子逻辑检查目标条件是否满足，不满足则阻止会话结束、推动 Agent 继续执行，直到条件达成。这也是为什么它能"工作数小时、甚至数天"而不需要用户反复按回车。

条件本身由Haiku 模型评估（"until a Haiku-evaluated condition holds"），即 Claude 主模型负责干活，而一个轻量的 Haiku 评估器负责判断"目标是否达成"，评估成本低、不占用主模型上下文。

基本用法：启动、查看与清除

在 Claude Code 交互会话中输入：

$ claude > /goal <condition> > /goal clear

• /goal <condition>：设定一个目标条件，Claude 跨回合持续工作直到该条件成立；
• /goal clear：提前移除当前生效的目标。

结合仓库中 命令参考表 对/goal（第 86 项，Session 分类）的完整描述，命令行为还有更多细节：

• 不带参数：显示当前目标或最近一次已达成（most recently achieved）的目标；
• 提前结束：除clear外，stop、off、reset、none、cancel均可移除一个生效中的目标；
• 版本要求：需要 Claude Codev2.1.139+（README 的 🔥 Hot 表 与命令 changelog 均以该版本为引入点）。

与/loop、auto mode 的分工

/goal不是唯一的"让 Agent 自己持续跑"机制，它与仓库内其他自动化能力形成互补：

三者解决不同问题：/loop适合"每隔一段时间做一次"的重复任务（如每 5 分钟检查部署状态）；auto mode 解决"权限弹窗打断"问题；而/goal解决"任务太复杂、一轮做不完、需要 Agent 自行迭代到完成"的问题。实践中最常见的组合是：auto mode 负责放行工具调用，/goal负责定义终点。

社区技巧一：让 Agent 先为你提案目标

第一条来自社区的高杠杆技巧（Alex Finn）：不要自己费劲设计/goal，而是让 Agent 基于它对你的了解来提议目标。社区给出的原版提示词如下：

Based on what you know about me, my goals, ambitions, and what we've built together already, what are the 3 /goals we can run right now that would run for long time periods and produce the best results?

操作流程是：

1. 对 Claude（或你的 Agent）运行上面这句提示词，让它结合你的身份、长期目标以及你们已共同完成的项目，给出 3 个"能长时间运行且产出最佳结果"的/goal候选；
2. 从中选一个你认可的；
3. 再让 Agent 为这个目标生成完整的提示词；
4. 你会得到若干"威力很强"的目标提示词，直接以/goal启动即可。

该技巧的价值在于：长时间任务的目标质量直接决定产出质量，而"最了解你目标和项目上下文"的正是 Agent 本身——它读过你的历史会话与仓库，比人脑临时设计的条件更贴合实际意图。

社区技巧二：让 Agent 起草/goal提示词本身

第二条技巧（Meta Alchemist）把"起草"这一步也交给 Agent，让目标与当前会话/仓库的意图严格对齐。原版提示词（以 Codex 为例，同样适用于 Claude Code）：

read this session and repo, analyze deeply the exact intent and goals we are looking to achieve here then write me the /goal prompt for this.

make sure to dig into history & docs we have to be 100% clear

可选的追加说明：

if you are not sure about certain parts or wanna ask me a few questions to clarify certain goals further don't hesitate

然后：

1. 把 Agent 生成的提示词原样复制；
2. 只把开头部分替换为/goal；
3. 执行后，Agent 就会"在这个会话/仓库里精确执行你想要的事，持续工作直到完成"。

这条技巧的核心是提示词的质量源于上下文：让 Agent 深挖会话历史与仓库文档，把模糊的意图收敛成可评估的条件，再让 Haiku 评估器去判断终点——三个环节各司其职。

结合仓库源码验证：目标条件的写法建议

综合社区两条技巧与仓库文档，一个可运行的/goal条件应具备以下特征：

• 可评估、可判定：条件是"最终状态描述"而非"过程描述"。例如/goal all tests in the repo pass比/goal keep working更适合 Haiku 评估——后者没有明确的完成信号；
• 与仓库事实绑定：目标应引用可验证的产物（测试通过、PR 已建、文档已更新、特定文件已生成），这与本仓库 开发工作流 中"以可验证条件收尾"的实践一致；
• 允许 Agent 自我澄清：在目标生成阶段允许 Agent 反问（第二条技巧的追加句），避免把歧义带进长跑任务——长任务的错误成本会随执行时长放大。

仓库中/goal相关的全部实现证据可交叉验证：

• Goal 实现文档：用法、版本要求、Haiku 评估机制；
• 命令参考表：/goal [condition|clear]完整语义与别名（stop/off/reset/none/cancel）；
• README 🔥 Hot 表：Goal 在概念总览中的位置（/goal <condition>、/goal clear）；
• concepts changelog：v2.1.139 引入记录与"session-scoped Stop hook wrapper"机制描述；
• commands changelog：/goal加入 Session 分类的命令变更记录。

适用边界与注意事项

• 版本前提：/goal需要 Claude Code v2.1.139 及以上版本，低于该版本无法使用；
• 会话作用域：目标是 session-scoped（会话级）的，随会话生命周期存在，不是跨会话持久化配置；
• 资源消耗：长跑任务持续占用模型调用，应结合 用量与速率限制报告 评估成本，并用/usage或/usage-credits监控消耗；
• 上下文管理：跨轮次长任务会使上下文持续增长，建议结合本仓库 会话管理实践（在目标里约定"达到某个上下文水位就/compact或收尾"），避免上下文腐坏影响目标完成质量；
• 目标要有终点：条件缺失或无法被评估时，Agent 可能无限续跑——务必为每个/goal提供一个可验证的、由 Haiku 能判定的完成条件，并保留clear/stop/off随时终止的能力。

从"一轮一个任务"到"条件达成才停"，/goal把 Agent 的执行粒度从回合提升到了目标级。配合"让 Agent 提案、让 Agent 起草"两条社区技巧，它足以支撑跨小时的复杂工程任务——这正是本仓库"from vibe coding to agentic engineering"理念在长跑任务上的直接落地。

• 文档
• 教程
• AI 技能