ralph

Ralph Wiggum Loop スキル

クリーンなコンテキストでエージェントを反復実行し、CI をグリーンに保ちながら、PRD 主導の機能に取り組む自律型 AI コーディングパターンです。

コマンド

コマンド	アクション
/ralph	ヘルプメニューを表示
/ralph setup	Ralph の基盤を作成
/ralph init	カスタム PRD を対話形式で作成
/ralph run	自律ループを実行

---

/ralph setup

現在のディレクトリに Ralph のファイルをすべて作成します。

手順：

1. このスキルの templates/ フォルダーからテンプレートを読み込み、コピーします：

   • templates/ralph-loop.sh → ./ralph-loop.sh
   • templates/prd.json → ./prd.json
   • templates/progress.txt → ./progress.txt
   • templates/README-RALPH.md → ./README-RALPH.md

2. スクリプトを実行可能にします：chmod +x ralph-loop.sh

3. プロジェクトのコンテキストを検出してカスタマイズします：

   • package.json を確認 → パッケージマネージャー（pnpm/npm/yarn）を判定
   • tsconfig.json を確認 → TypeScript プロジェクトかどうかを判定
   • それに応じて ralph-loop.sh のテストコマンドを更新

4. 完了メッセージと次の手順を表示

---

/ralph init

カスタム PRD を対話形式で作成できるよう、ユーザーを案内します。

質問する項目：

1. プロジェクト名は何ですか？
2. どのような機能を作りたいですか？（ユーザーストーリーを 3～5 件収集）
3. ストーリーごとに：
   • タイトルは何ですか？
   • 説明は何ですか？
   • 受け入れ条件は何ですか？（具体的でテスト可能な条件を 3～5 件）

出力： ユーザーの入力を使って prd.json を生成します。まだ存在しない場合は、ほかの Ralph ファイルも作成するか確認します。

---

/ralph run

Ralph ループを実行します。

事前チェック：

1. ralph-loop.sh が存在することを確認
2. prd.json が存在することを確認
3. 概要を表示：
   • ユーザーストーリーの合計数
   • 未完了のストーリー（passes: false のもの）
   • 設定されている最大反復回数
4. 実行の確認を求める
5. 実行：./ralph-loop.sh

---

/ralph（引数なし）

ヘルプメニューを表示します：

Ralph Wiggum Loop - Autonomous AI Coding

Commands:
  /ralph setup  - Create Ralph infrastructure in this directory
  /ralph init   - Create a new PRD from scratch
  /ralph run    - Run the Ralph loop

What would you like to do?

---

主な原則

1. 各反復でコンテキストを一新 - 新しいコンテキストで開始し、余計な情報を持ち越しません
2. 一度に 1 つの機能に取り組む - スコープの肥大化を防ぎます
3. CI をグリーンに保つ - コミットごとにテストと型チェックを通過させます
4. 進捗を追跡する - 各反復で progress.txt に追記します
5. 明確な停止条件 - すべてのストーリーが合格したら <promise>COMPLETE</promise> を出力します
6. 安全のための上限 - 最大反復回数を設定して無限ループを防ぎます

PRD の品質チェックリスト

優れたユーザーストーリーの条件：

• ✅ 具体的でスコープが明確（1 回の反復で完了できる）
• ✅ 受け入れ条件が明確（テスト可能で曖昧でない）
• ✅ 優先順位が適切（1 = 最優先）
• ✅ 初期状態で "passes": false が設定されている

よくないユーザーストーリーの例：

• ❌ 曖昧すぎる（「UI を作る」）
• ❌ 大きすぎる（多くのシステムに手を加える）
• ❌ 条件が不明確（「いい感じにする」）