ralph-loop

Ralph Loop

このスキルを使用すると、外部から Ralph ループを操作できます。

このスキルを使用する場面

• 適切な -c と -H の入力を指定して Ralph の実行を開始または継続する
• ループの状態、ワークツリー、ログ、履歴、差分を確認する
• フックによって一時停止されたループを再開する
• 完了したワークツリーのループをマージまたは破棄する
• 現在の診断ファイルを使って、想定外のループ動作をデバッグする

ワークフロー

1. ralph loops list または ralph loops list --json を実行して、現在の状態を把握します。
2. ユーザーが実行を希望する場合は、適切なコア設定とハットのソースを指定して ralph run ... を実行します。
3. ループが停止したり、挙動が疑わしかったりする場合は、状態を変更する前に logs、history、diff を確認します。
4. ループが一時停止している場合は、.ralph/suspend-state.json を読み、ralph loops resume <id> を使用します。
5. ループがキューに登録されているか、needs-review の状態にある場合は、まず差分を確認し、状況に応じて merge、process、retry、discard を使用します。
6. ハット、イベント、ツール呼び出し、解析エラー、パフォーマンスの詳細な証拠が必要な場合は、診断情報を使用します。

ガードレール

• .ralph の状態ファイルを直接編集するのではなく、CLI を優先してください。
• タスクとメモリを正規のランタイムシステムとして扱い、スクラッチパッドを主要な状態モデルにしないでください。
• マージする前に差分を確認してください。
• ロックやキューの成果物を削除するのは、基盤となるプロセスが停止していることを確認できた場合に限ってください。
• .ralph/ 内の手動編集は最後の手段として行い、使用した場合は必ず明示してください。

必要に応じて、以下のリファレンスを参照してください

• コマンドの使用例とオペレーター向けの手順については、references/commands.md を参照してください。
• 診断ファイルと一時停止状態の詳細については、references/diagnostics.md を参照してください。