关于 paseo-loop
paseo-loop 是用于通过命令行运行有限轮次 Worker 与验证器循环的 Paseo 技能。它适合需要反复尝试和检查,直到任务完成或达到设定上限的工作。
主要功能
- 01运行 Worker 与验证器循环
- 02支持 Shell 检查和验证提示
- 03根据偏好选择提供方
- 04设置迭代次数和时间上限
- 05可保留 Agent 供检查
适用场景
- 01反复修复未通过的测试
- 02监控并处理 PR 检查结果
- 03执行跨提供方实现评审
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ getpaseo/ paseo --skill paseo-loop安装后在 Claude Code 中输入/paseo-loop确认已加载。
详细介绍
Paseo Loop Skill
循环是一种工作者/验证者周期:启动工作者 → 检查验证结果 → 重复,直到完成或达到限制。适用于“继续尝试”“盯着点”或“持续关注,直到 X”的场景。
对于应返回当前对话的轻量级定期检查,优先使用 cron 心跳(create_heartbeat,完成后再用 delete_heartbeat)。若要更改,请删除后重新创建。如果每轮都需要完整的工作者/验证者生命周期,请使用循环;如果每次触发都应创建一个全新的独立 Agent 和工作区,请使用计划任务。
用户参数: $ARGUMENTS
前置条件
阅读 paseo 技能。在选择工作者或验证者的提供方之前,请阅读 ~/.paseo/orchestration-preferences.json,除非用户在此请求中明确指定了提供方。阅读完成前,不要启动循环。
循环是一种 CLI 原语:paseo loop run。使用 paseo loop ls、paseo loop inspect <id>、paseo loop logs <id>、paseo loop stop <id> 进行管理。
你的任务
- 根据
$ARGUMENTS和对话内容理解用户的意图。 - 工作者提示词——内容应独立完整,具体说明本轮要做什么,并明确何为进展。
- 验证——选择合适的方式:
- Shell 检查(
--verify-check):适用于命令能够判断的客观标准(gh pr checks --fail-fast、npm test)。 - 验证者提示词(
--verify):适用于需要判断的情形(“仅当所有测试都通过且改动的文件合理一致时,才返回 done=true。注明命令和结果。”)。 - 两者并用:先通过 Shell 排除明显故障,再由验证者判断其余部分。
- Shell 检查(
- 提供方——工作者使用
--provider,验证者使用--verify-provider。除非用户指定,否则依据偏好设置。对于实现循环,工作者和验证者应使用不同的提供方,以便彼此发现盲点。 - 休眠间隔——仅在轮询外部对象时使用
--sleep。否则,让循环按完成速度运行。 - 停止条件——设置合理的
--max-iterations和/或--max-time。不设终止条件的循环容易失控。 - 归档——
--archive会保留每轮结束后的 Agent,供检查。 - 使用
paseo loop run启动。
常见用法
盯着 PR——工作者检查 PR 状态并修复问题;Shell 检查为 gh pr checks <n> --fail-fast;休眠 2m;最长运行时间为 1h。
让测试全部通过——工作者调查失败原因并修复代码;Shell 检查为测试命令;验证者确认所有测试均已通过;最多迭代 10 次。
跨提供方实现——工作者使用 impl 提供方,验证者使用不同的提供方;验证者检查改动的文件、运行类型检查和测试;同时限制最大迭代次数和最长运行时间;启用归档以便检查各轮迭代。
提示词规则
工作者——内容应独立完整且具体(命令、文件、分支、测试、PR、系统),明确说明本轮何为进展。
验证者——检查事实,不提出修复建议;注明命令、输出和文件证据;明确说明“完成”的具体标准。