运行 Agent 循环,直到满足退出条件。当用户表达“循环”、“盯盘/盯住”、“持续尝试直到”、“每隔 X 检查一次”、“监视/观察”或需要迭代式自主执行时使用。
Paseo Loop Skill
循环(Loop)本质上是一个“执行者/校验者(worker/verifier)”的交替周期:启动 worker → 进行校验 → 重复此流程,直到任务完成或达到限制上限。适用于“持续尝试”、“帮忙盯一下”或“持续观察直到满足条件 X”等场景。
如果是需要在当前对话中返回结果的轻量级定时检查,优先使用 Cron 心跳(先 create_heartbeat,完成后再 delete_heartbeat)。如需修改,请先删除再重新创建。当每次迭代都需要独立的 worker/verifier 生命周期时使用 loop;当每次触发都需要创建一个全新的独立 Agent 和工作区时,请使用 schedule。
用户的参数: $ARGUMENTS
前置要求
先阅读 paseo skill。在选择 worker 或 verifier Provider 之前,除非用户在此请求中明确指定了 Provider,否则必须先读取 ~/.paseo/orchestration-preferences.json。在完成读取之前,不要启动循环。
循环属于 CLI 原生命令:paseo loop run。相关管理命令包括 paseo loop ls、paseo loop inspect <id>、paseo loop logs <id>、paseo loop stop <id>。
你的任务
- 根据
$ARGUMENTS和上下文理解用户意图。 - Worker Prompt —— 内容须自洽完备,明确本次迭代的具体任务,并清晰定义怎样的成果才算作有效进展。
- 校验(Verification) —— 选择合适的校验方式:
- Shell 校验(
--verify-check):适用于可通过命令回答的客观标准(例如gh pr checks --fail-fast、npm test)。 - Verifier Prompt(
--verify):适用于主观判断(“仅当所有测试均通过且修改的文件逻辑连贯时返回 done=true。请引用运行的命令及输出结果。”)。 - 两者结合:先用 Shell 排除明显的失败项,再由 Verifier 校验其余细节。
- Shell 校验(
- Provider 配置 ——
--provider用于 worker,--verify-provider用于 verifier。除非用户显式指定,否则从偏好设置中读取。对于代码实现类的循环,建议将 worker 和 verifier 配对在不同的 Provider 上 —— 以便互相发现对方的盲区。 - 休眠等待(Sleep) —— 仅在轮询外部服务时使用
--sleep。否则让循环以最快速度连续执行。 - 停止条件(Stops) —— 设置合理的
--max-iterations(最大迭代次数)和/或--max-time(最大执行时间)。不设上限的开放式循环很容易导致失控运行。 - 存档(Archive) —— 开启
--archive会在每次迭代后保留 Agent,以便后续排查检查。 - 使用
paseo loop run启动循环。
常见模式
盯 PR(Babysit a PR) —— worker 负责检查 PR 状态并修复问题;Shell 校验为 gh pr checks <n> --fail-fast;休眠时间为 2 分钟(sleep 2m);最大运行时间为 1 小时(max-time 1h)。
跑通测试(Drive tests to green) —— worker 负责排查失败原因并修复代码;Shell 校验为测试命令;verifier 确认所有测试通过;最大迭代次数为 10 次(max-iterations 10)。
跨 Provider 协同实现(Cross-provider implementation) —— worker 使用 impl Provider,verifier 使用另一个 Provider;verifier 检查改动的文件,运行类型检查和测试;设定最大迭代次数与最长运行时间上限;开启 archive 以便复盘检查各轮迭代。
Prompt 编写规则
Worker —— 自洽完备,内容具体(明确涉及的命令、文件、分支、测试、PR、系统等),并清晰定义本次迭代中什么样的情况才算作有效进展。
Verifier —— 只核查客观事实,不提供修复建议,须引用命令、输出或文件证据,并明确定义“完成”的具体标准。






