paseo-loop

Paseo ループスキル

ループとは、ワーカーと検証役が交互に処理するサイクルです。ワーカーを起動 → 検証結果を確認 → 完了するか上限に達するまで繰り返します。「何度も試す」「見守る」「X になるまで監視する」といった用途に使います。

この会話に結果を返す軽量な定期チェックには、cron ハートビート（create_heartbeat で作成し、完了したら delete_heartbeat で削除）を優先してください。変更する場合は、削除してから作り直してください。各反復でワーカー／検証役のライフサイクルが必要ならループを使い、実行のたびに独立した新しいエージェントとワークスペースを作成する場合はスケジュールを使います。

ユーザーの引数： $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. 検証 — 適切な形式を選びます。
   • コマンドで判定できる客観的な基準には、シェルチェック（--verify-check）を使います（gh pr checks --fail-fast、npm test など）。
   • 判断が必要な場合は、検証プロンプト（--verify）を使います（「すべてのテストがパスし、変更ファイルに一貫性がある場合にのみ done=true を返します。実行したコマンドと結果を示してください。」など）。
   • シェルで明らかな失敗を除外し、残りを検証役が判断する場合は、両方を使います。
4. プロバイダー — ワーカーには --provider、検証役には --verify-provider を指定します。ユーザーが指定していない場合は、設定に従います。実装ループでは、ワーカーと検証役に異なるプロバイダーを割り当てます。それぞれが相手の見落としに気づけるようにするためです。
5. 待機時間 — 外部の何かをポーリングする場合にのみ --sleep を指定します。それ以外は、ループが完了するたびに続行します。
6. 停止条件 — 妥当な --max-iterations や --max-time、またはその両方を設定します。上限のないループは暴走の原因になります。
7. アーカイブ — --archive を指定すると、各反復後もエージェントが保持され、内容を確認できます。
8. paseo loop run で起動します。

よくある形式

PR を見守る — ワーカーが PR の状態を確認して問題を修正します。シェルチェックには gh pr checks <n> --fail-fast を使い、待機時間は 2m、最大時間は 1h に設定します。

テストをすべてパスさせる — ワーカーが失敗を調査してコードを修正します。シェルチェックにはテストコマンドを使い、検証役がすべてのテストのパスを確認します。最大反復回数は 10 に設定します。

異なるプロバイダー間で実装する — ワーカーには impl プロバイダーを使い、検証役には別のプロバイダーを使います。検証役は変更ファイルを確認して、型チェックとテストを実行します。最大反復回数と最大時間の両方に上限を設定し、反復を確認できるようにアーカイブを有効にします。

プロンプトのルール

ワーカー — 自己完結型で具体的な内容にします（コマンド、ファイル、ブランチ、テスト、PR、システムなど）。この反復で何を進捗とみなすかを明確にします。

検証役 — 修正方法は提案せず、事実を確認します。コマンドや出力、ファイルの証拠を示し、「完了」の定義を具体的にします。