mcpField
S
setup-ralph

setup-ralph

github.com/glittercowboyエージェントワークフロー2.0k124 回インストール30 週間前に更新
リポジトリ

setup-ralph について

Ralph ループのセットアップと管理を支援する、反復型の自律コーディングに取り組む開発者向けスキルです。計画、実装、検証を分け、ファイルで計画状態を反復間に保持します。

主な機能

  1. 01Ralph ループ構成の初期化
  2. 02計画フェーズと構築フェーズの分離
  3. 03テスト、型チェック、ビルドによるフィードバック
  4. 04ファイルによる反復間の計画保持
  5. 05既存ループのカスタマイズと問題対応

活用シーン

  1. 01プロジェクト用の Ralph ループをセットアップ
  2. 02Ralph の手法と動作を理解
  3. 03既存ループのプロンプトや設定を調整
  4. 04ループの問題を診断し検証を改善

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/glittercowboy/taches-cc-resources --skill setup-ralph

インストール後、Claude Code で/setup-ralphを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
operational-learnings.md
project-structure.md
prompt-design.md
ralph-fundamentals.md
validation-strategy.md
templates/
Dockerfile
loop-docker.sh
loop.sh
PROMPT_build.md
PROMPT_plan.md
workflows/
customize-loop.md
setup-new-loop.md
troubleshoot-loop.md
understand-ralph.md

詳細

<essential_principles>

Ralph とは？

Ralph は、タスクの選択、実行、検証を反復するループを用いた、Geoffrey Huntley による自律型 AI コーディング手法です。最も純粋な形では、次のような Bash ループです。

while :; do cat PROMPT.md | claude ; done

このループは Claude にプロンプトファイルを渡し、エージェントが 1 つのタスクを完了して、実装計画を更新し、変更をコミットしてから終了します。その後、ループは新しいコンテキストでただちに再開します。

基本理念

Ralph Wiggum Technique は、決定性のない世界において、決定論的にうまくいかない手法です。 Ralph は、各反復を新しいコンテキストで開始することでコンテキストの蓄積を解決します。これは Geoffrey のアプローチの核心となる洞察です。

3 つのフェーズ、2 つのプロンプト、1 つのループ
  1. 計画フェーズ：ギャップ分析（仕様とコードの比較）によって、優先順位を付けた TODO リストを出力します。実装もコミットも行いません
  2. ビルドフェーズ：計画からタスクを選び、実装し、テスト（バックプレッシャー）を実行して、コミットします
  3. 観察フェーズ：ループの中ではなく、ループを見守ります。Ralph が成功できるように、セットアップと環境を整えます
主な原則

あなたの役割：Ralph がすべての作業を行います。次に実装する計画済みの作業を決めることも、その実装方法を決めることも含まれます。あなたの仕事は、環境を整えることです。

バックプレッシャー：テスト、型チェック、リンター、ビルドによって、無効または許容できない作業を拒否するバックプレッシャーを作り出します。

観察：特に初期段階では、様子を見守ります。観察した失敗パターンに応じて、プロンプトを改善していきます。

コンテキスト効率：200K のウィンドウから利用できるトークンは約 176K です。その 40〜60% を「スマートゾーン」に割り当てる場合、タスクを小さくし、ループごとに 1 つのタスクだけを実行することで、コンテキストを最大限に活用できます。

状態としてのファイル I/O：計画ファイルは分離されたループ実行の間も保持され、決定論的な共有状態として機能するため、高度なオーケストレーションは必要ありません。

リモートバックアップ：ループはプライベートな GitHub リポジトリを自動的に作成し、コミットのたびにプッシュします。これにより、自律的な操作による偶発的なデータ損失を防ぎます。gh CLI の認証が必要です。RALPH_BACKUP=false で無効にできます。

安全ルール：PROMPT_build.md には、プロジェクトディレクトリに対する rm -rf のような危険な操作を禁止する重要な安全ルールが含まれています。テストは分離された一時ディレクトリで実行する必要があります。 </essential_principles>

何をしたいですか？
  1. 新しい Ralph ループをセットアップする - ディレクトリに Ralph の構成を初期化します
  2. Ralph の概念を理解する - この手法とその仕組みを学びます
  3. 既存のループをカスタマイズする - プロンプトまたは設定を変更します
  4. Ralph のトラブルシューティングを行う - ループの問題をデバッグするか、パフォーマンスを改善します

先に進む前に、返答を待ちます。

| 返答 | ワークフロー | |----------|----------| | 1, "set up", "setup", "new", "initialize", "create" | `workflows/setup-new-loop.md` | | 2, "understand", "learn", "concepts", "explain", "how" | `workflows/understand-ralph.md` | | 3, "customize", "modify", "change", "update", "edit" | `workflows/customize-loop.md` | | 4, "troubleshoot", "debug", "fix", "problem", "issue" | `workflows/troubleshoot-loop.md` | | その他 | 意図を明確にしてから、適切なワークフローを選択します |

ワークフローを読んだ後、その手順に正確に従ってください。

<reference_index>

ドメイン知識

すべて references/ にあります。

中核概念: ralph-fundamentals.md - 3 つのフェーズ、2 つのプロンプト、1 つのループ 構造: project-structure.md - 必須ファイルとディレクトリレイアウト プロンプト: prompt-design.md - プランニングモードとビルディングモードの指示 バックプレッシャー: validation-strategy.md - ステアリングとしてのテスト、リント、ビルド ベストプラクティス: operational-learnings.md - AGENTS.md のガイダンスと進化 </reference_index>

<workflows_index>

ワークフロー目的
setup-new-loop.mdディレクトリ内で Ralph 構造を初期化する
understand-ralph.mdRalph の概念と哲学を学ぶ
customize-loop.mdプロンプトまたはループ設定を変更する
troubleshoot-loop.mdループの問題をデバッグし、パフォーマンスを改善する
</workflows_index>

<success_criteria> スキルが成功するのは次の場合です:

  • ユーザーがどのワークフローが必要かを理解している
  • 意図に基づいて適切なワークフローが読み込まれる
  • すべての必須リファレンスがワークフローによって読み込まれる
  • ユーザーが Ralph ループを独立してセットアップし実行できる </success_criteria>

コメント

Markdown 対応