mcpField
P
paseo-loop

paseo-loop

github.com/getpaseoAgent 工作流22.3k2.6k 次安装今天更新
代码仓库

关于 paseo-loop

paseo-loop 是用于通过命令行运行有限轮次 Worker 与验证器循环的 Paseo 技能。它适合需要反复尝试和检查,直到任务完成或达到设定上限的工作。

主要功能

  1. 01运行 Worker 与验证器循环
  2. 02支持 Shell 检查和验证提示
  3. 03根据偏好选择提供方
  4. 04设置迭代次数和时间上限
  5. 05可保留 Agent 供检查

适用场景

  1. 01反复修复未通过的测试
  2. 02监控并处理 PR 检查结果
  3. 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> 进行管理。

你的任务

  1. 根据 $ARGUMENTS 和对话内容理解用户的意图。
  2. 工作者提示词——内容应独立完整,具体说明本轮要做什么,并明确何为进展。
  3. 验证——选择合适的方式:
    • Shell 检查(--verify-check):适用于命令能够判断的客观标准(gh pr checks --fail-fast、npm test)。
    • 验证者提示词(--verify):适用于需要判断的情形(“仅当所有测试都通过且改动的文件合理一致时,才返回 done=true。注明命令和结果。”)。
    • 两者并用:先通过 Shell 排除明显故障,再由验证者判断其余部分。
  4. 提供方——工作者使用 --provider,验证者使用 --verify-provider。除非用户指定,否则依据偏好设置。对于实现循环,工作者和验证者应使用不同的提供方,以便彼此发现盲点。
  5. 休眠间隔——仅在轮询外部对象时使用 --sleep。否则,让循环按完成速度运行。
  6. 停止条件——设置合理的 --max-iterations 和/或 --max-time。不设终止条件的循环容易失控。
  7. 归档——--archive 会保留每轮结束后的 Agent,供检查。
  8. 使用 paseo loop run 启动。

常见用法

盯着 PR——工作者检查 PR 状态并修复问题;Shell 检查为 gh pr checks <n> --fail-fast;休眠 2m;最长运行时间为 1h。

让测试全部通过——工作者调查失败原因并修复代码;Shell 检查为测试命令;验证者确认所有测试均已通过;最多迭代 10 次。

跨提供方实现——工作者使用 impl 提供方,验证者使用不同的提供方;验证者检查改动的文件、运行类型检查和测试;同时限制最大迭代次数和最长运行时间;启用归档以便检查各轮迭代。

提示词规则

工作者——内容应独立完整且具体(命令、文件、分支、测试、PR、系统),明确说明本轮何为进展。

验证者——检查事实,不提出修复建议;注明命令、输出和文件证据;明确说明“完成”的具体标准。

评论

支持 Markdown