一、两个真实场景

场景 A： 你让 Claude Code“重构用户认证模块”。它改完一个文件就停了，等你输入下一步。你忙别的去了，半小时后回来，发现它还停在原地——你忘了说“继续”。

场景 B： 你部署完服务，需要等 3~5 分钟才能确认是否成功。你每隔一会儿就切回终端问一句“部署好了吗？”，一天下来，光是轮询就消耗了不少精力。

这两个场景对应两类需求：

• 多步骤长任务——需要持续推进，而非一次性完成
• 定时重复检查——需要自动轮询，而非手动盯盘

/goal 和 /loop 正是为这两类需求而生的命令。

二、/goal：给 AI 一个“北极星”

是什么？

/goal 让你为 Claude Code 设定一个长期目标。设定之后，AI 会在后续每一轮操作中主动评估进度，并在完成当前步骤后自动推进下一步，直到目标达成或你手动终止。

基础用法

# 设定目标
/goal 重构整个用户认证模块，将 JWT 逻辑抽离为独立服务，并确保所有单元测试通过

# 查看当前进度
/goal

# 手动标记完成
/goal done

适合场景

场景	示例
大型重构	/goal 将整个代码库从 CommonJS 迁移到 ESM
功能开发	/goal 实现一个完整的用户注册流程，包括 API、数据库、邮件验证和单元测试
复杂调试	/goal 定位并修复生产环境中的内存泄漏问题，补充相关监控日志
数据处理流水线	/goal 清洗数据 → 特征工程 → 训练模型 → 输出评估报告

注意事项

• 目标最好清晰但不必过细。AI 有拆分能力，过细的描述反而限制其灵活性。
• 中途可以追加条件，AI 会将其纳入目标范围（例如：“对了，还要支持 OAuth 2.0”）。
• 它是会话级别的，新会话或重启 Claude Code 后需要重新设定。

好的条件（三个要素）

要素	说明	示例
可度量的终态	一个明确的结果	npm test 退出码为 0
声明的检查方式	Claude 如何证明已完成	在对话中报告测试输出
约束条件	过程中不能改变的东西	不要修改 /auth 目录外的任何文件

/goal 修复所有失败的测试，直到 npm test 退出码为 0。不要修改 /auth 目录外的任何文件。

/goal 实现深色/浅色主题切换，切换不需要刷新页面，且刷新后状态保持。

/goal src/ 下所有 lint 错误已修复，eslint 退出码为 0，没有修改任何测试文件。

三、/loop：基于时间节奏的定时轮询

是什么？

/loop 让 Claude Code 按照指定的时间间隔，自动重复执行某个任务。适合那些需要“每隔几分钟看一眼”的轮询类工作。

怎么用？

# 固定间隔 + 任务
/loop 3m 检查 staging 环境是否部署完成

# 不指定间隔，AI 自动动态调整（根据任务紧急程度，从 1 分钟到 1 小时不等）
/loop 检查所有 CI 流水线是否通过

# 仅输入 /loop，进入“维护模式”——AI 自动巡检未完成工作
/loop

工作机制

1. 定时触发：按指定间隔（最小 1 分钟）反复执行同一任务描述。
2. 上下文隔离：每次执行都是独立的，不继承上一次执行的上下文或结果。如需跨轮次状态记录，需要 AI 主动写入文件。
3. 自动过期：为避免资源浪费，定时任务最长存活 7 天 后自动删除。
4. 会话范围：任务在当前会话中有效，会话结束则任务停止。

适合什么场景？

场景	示例
部署监控	/loop 2m 检查生产环境新版本是否已全部就绪
CI/CD 护航	/loop 检查 CI 是否全部通过，若有失败则分析失败原因
PR 管理	/loop 5m 监控 PR #123，有新评论时摘要给我，可合并时自动合并
日志巡检	/loop 10m 检查 error.log 中是否有新增异常，如有则分析堆栈

时间单位

单位	含义	说明
s	秒	实际操作中会被四舍五入到 1 分钟
m	分钟	最常用的单位
h	小时	适合长时间任务
d	天	适合日常检查

停止循环

• 在等待下一轮时按 Esc 键即可停止
• 循环最长运行 7 天后自动过期
• 单次会话最多 50 个任务

自定义默认提示词：loop.md

你可以创建 loop.md 文件来定义裸 /loop 命令的默认行为：

• 项目级：.claude/loop.md（优先级更高）
• 用户级：~/.claude/loop.md
• 纯 Markdown 格式，最大 25000 字节
• 修改后下一轮生效，无需重启

示例 .claude/loop.md：

检查 `release/next` PR 的状态。如果 CI 变红，拉取失败的 job 日志，
诊断问题并推送最小修复。如果有新的审查意见，逐一处理并解决评论。
如果一切正常且安静，用一行话总结当前状态。

总结

• /goal 适合有明确终点的工作——“修到全绿为止”、“实现到功能完整为止”。它通过双模型循环（执行 + 评估）确保质量，是深度工作的利器。
• /loop 适合需要持续关注的任务——“每 10 分钟看一次部署”、“盯着 PR 直到合并”。它按时间节奏工作，是运维和监控的得力助手。

参考文档

• Claude Code /goal 官方文档
• Claude Code /loop 官方文档
• awesome-agent-loops: /loop、/goal 实战案例集