ralph-loop-help

Ralph Loop のヘルプ

トリガー

ユーザーが Ralph Loop とは何か、どのように機能するかを尋ねた場合、または使い方のガイダンスを必要としている場合。

説明する内容

Ralph Loop とは？

Ralph Loop は、Geoffrey Huntley が開拓した、AI の継続的なループに基づく反復的な開発手法である Ralph Wiggum 手法を実装しています。

中核となる考え方は、同じプロンプトをエージェントに繰り返し渡すことです。「自己参照」の仕組みは、出力を入力として再び渡すことではなく、エージェントがファイルや git の履歴にある自身の以前の作業を確認することにあります。

各イテレーションでは：

1. エージェントが同じプロンプトを受け取ります
2. タスクに取り組み、ファイルを変更します
3. 終了しようとします
4. Stop フックが終了を捕捉し、同じプロンプトを再び渡します
5. エージェントはファイルにある自身の以前の作業を確認します
6. 完了するまで反復的に改善します

Ralph Loop の開始

タスクとオプションをエージェントに伝えます：

Start a ralph loop: "Build a REST API for todos" --max-iterations 20 --completion-promise "COMPLETE"

オプション：

• --max-iterations N — 自動停止するまでの最大イテレーション数
• --completion-promise "TEXT" — 完了を知らせるフレーズ

仕組み：

1. 状態ファイル .cursor/ralph/scratchpad.md を作成します
2. エージェントがタスクに取り組みます
3. Stop フックが終了を捕捉し、同じプロンプトを再び渡します
4. エージェントは自身の以前の作業を確認し、反復します
5. promise が検出されるか、最大イテレーション数に達するまで続けます

Ralph Loop のキャンセル

Ralph Loop をキャンセルするようエージェントに依頼します。エージェントは状態ファイルを削除し、イテレーション数を報告します。

完了を知らせる promise

完了を知らせるには、エージェントが <promise> タグを出力します：

<promise>TASK COMPLETE</promise>

Stop フックはこの特定のタグを探します。このタグがない場合（または --max-iterations を指定していない場合）、Ralph は無期限に実行されます。

Ralph の使用に適した場面

適しているタスク：

• 成功基準が明確に定義されたタスク
• 反復と改善が必要なタスク
• 自己修正を伴う反復的な開発
• グリーンフィールドプロジェクト

適していないタスク：

• 人の判断や設計上の決定が必要なタスク
• 一度きりの操作
• 成功基準が不明確なタスク

詳細情報

• 元の手法：https://ghuntley.com/ralph/
• Ralph Orchestrator：https://github.com/mikeyobrien/ralph-orchestrator

出力

上記の情報を、ユーザーの具体的な質問に合わせて明確に提示します。