paseo-loop

paseo-loop

热门

运行 Agent 循环,直到满足退出条件。当用户表达“循环”、“盯盘/盯住”、“持续尝试直到”、“每隔 X 检查一次”、“监视/观察”或需要迭代式自主执行时使用。

1.2万Star
1210Fork
更新于 2026/8/3
SKILL.md
只读
名称
paseo-loop
描述

运行 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 lspaseo loop inspect <id>paseo loop logs <id>paseo loop stop <id>

你的任务

  1. 根据 $ARGUMENTS 和上下文理解用户意图。
  2. Worker Prompt —— 内容须自洽完备,明确本次迭代的具体任务,并清晰定义怎样的成果才算作有效进展。
  3. 校验(Verification) —— 选择合适的校验方式:
    • Shell 校验(--verify-check):适用于可通过命令回答的客观标准(例如 gh pr checks --fail-fastnpm test)。
    • Verifier Prompt(--verify):适用于主观判断(“仅当所有测试均通过且修改的文件逻辑连贯时返回 done=true。请引用运行的命令及输出结果。”)。
    • 两者结合:先用 Shell 排除明显的失败项,再由 Verifier 校验其余细节。
  4. Provider 配置 —— --provider 用于 worker,--verify-provider 用于 verifier。除非用户显式指定,否则从偏好设置中读取。对于代码实现类的循环,建议将 worker 和 verifier 配对在不同的 Provider 上 —— 以便互相发现对方的盲区。
  5. 休眠等待(Sleep) —— 仅在轮询外部服务时使用 --sleep。否则让循环以最快速度连续执行。
  6. 停止条件(Stops) —— 设置合理的 --max-iterations(最大迭代次数)和/或 --max-time(最大执行时间)。不设上限的开放式循环很容易导致失控运行。
  7. 存档(Archive) —— 开启 --archive 会在每次迭代后保留 Agent,以便后续排查检查。
  8. 使用 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 —— 只核查客观事实,不提供修复建议,须引用命令、输出或文件证据,并明确定义“完成”的具体标准。