mcpField
R
ralph-json-start-loop

ralph-json-start-loop

github.com/richtaborエージェントワークフロー7357 回インストール29 週間前に更新
リポジトリ

ralph-json-start-loop について

ralph-json-start-loop は、JSON PRD に記載された機能作業を反復実行する Claude スキルです。依存関係に沿ってプロジェクトを選び、Git worktree ごとに作業を分離します。

主な機能

  1. 01依存関係を満たすプロジェクトを選択
  2. 02反復回数を指定してループを実行
  3. 03未完了のストーリーを実装
  4. 04品質チェックを実行してコミット
  5. 05PRD JSON を更新して変更を同期

活用シーン

  1. 01計画済みの機能ストーリーを自動実行
  2. 02依存関係に沿ってプロジェクトを進行
  3. 03worktree を分けて機能作業を並行実施

インストール

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

$npx skills add https://github.com/richtabor/agent-skills --skill ralph-json-start-loop

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

同梱ファイルralph.shreferences/prompt.md

詳細

Ralph

自律ループを実行して、prds/ ディレクトリ内の機能を実装します。

使用方法

/ralph              # Run next available project (respects dependencies)
/ralph 25           # Run with 25 iterations
/ralph auth-flow    # Run specific project

プロセス

ループスクリプトをバックグラウンドモードで実行します。

~/.claude/skills/ralph/ralph.sh [iterations] [project-name]

タイムアウトを防ぐため、run_in_background: true を指定します。起動後、ユーザーに <worktree>/.ralph-progress.txt を tail -f で確認するよう伝えてください。

動作内容
  1. 依存関係グラフを表示し、次に実行可能なプロジェクトを見つけます
  2. ../{repo}-{feature}/ に Git ワークツリーを作成します
  3. 各反復で以下を実行します。
    • passes: false の最初のストーリーを選択します
    • 実装して、品質チェックを実行します
    • feat: [id] - [title] としてコミットします
    • JSON を更新し、メインリポジトリに同期します
  4. すべてのストーリーが合格すると、<promise>COMPLETE</promise> を出力します
依存関係

Ralph は各 PRD の dependsOn を読み取り、実行順序を適用します。

{
  "projectName": "Dashboard",
  "dependsOn": ["auth-flow", "user-profile"]
}

依存関係が未完了のプロジェクトはブロックされます。Ralph は準備が整ったプロジェクトの中から、アルファベット順で最初のものを選択します。

前提条件

  1. .claude/plans/、plans/、または prds/ に .json 形式の PRD ファイルが少なくとも 1 つあること
  2. プランモードを使用してプランを作成し、その後 /ralph-json-create-issues を実行して変換すること

注意事項

  • 独立したプロジェクトでは、複数の Ralph を並行して実行できます（別々のターミナルを使用）
  • それぞれが独自のワークツリーで作業するため、競合は発生しません

コメント

Markdown 対応