Communitygithub.com

tundergod/easy-loop

リポジトリ内でKarpathyスタイルのプランナー/ジェネレーター/評価エージェントループを実行します。マネージャーがテスト可能な契約を交渉し、再開可能なバックグラウンドランナーを駆動します。

easy-loop とは?

Easy Loopは、AIエージェントワークフロー(Claude Code, Cursor, Codex等)向けのスキルで、長期間・複数ファイルにわたるタスクを**マネージャー**と**ランナー**の2役割に分離して管理します。マネージャーはユーザーと直接対話し、テスト可能な契約(contract.md)を交渉・承認し、背景で動作するランナーを起動します。ランナーはプランナー→ジェネレーター→評価者の反復サイクルを自律的に駆動し、状態をディスク上の実行ディレクトリに保存するため、セッションクラッシュ後でも再開可能です。このスキルは、評価基準が明確で人間の承認ゲートが必要なタスクに特に有用で、契約違反や進捗停滞時のみユーザーにエスカレーションします。

対応~Claude Code~Codex CLI~Cursor
npx skills add tundergod/easy-loop

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Easy Loop

/easy-loop はこのセッションをマネージャーにします。ユーザーとテスト可能な契約を交渉し、プランナー→ジェネレーター→評価者の反復処理を行うバックグラウンドランナーを起動し、契約が満たされるか人間の介入が必要になった場合のみユーザーに戻ります。あなたはマネージャーです — references/role-manager.md に従ってください。

2つの役割があり、これらを統合することはできません — 一方はユーザーと対話し、もう一方は切り離されて動作します:

  • マネージャー — このメインセッション。ユーザー向け: 契約、承認、起動、再開。アプリケーションコードは書きません。
  • ランナー — バックグラウンドサブエージェント。反復処理を駆動し、各ラウンドで新しいプランナー/ジェネレーター/評価者を生成し、状態をディスクに書き込み、人間の介入が必要になった時点で停止します。ユーザーと対話することはありません。

状態はコンテキストではなくディスク上に存在します: ループはクラッシュやセッション終了後も生存し、すべての実行は実行ディレクトリから再構築可能です。実行ディレクトリのレイアウト、状態スキーマ、ラチェット/ロールバック、ステータスルーティング、再開ルールについては references/loop-protocol.md を参照してください — ステップ1および3~6でこれを利用します。

生成する各サブエージェントは空のコンテキストから開始します。そのプロンプトに必要なものを注入します: guideline.md(共有の規律)、対応する references/role-*.md、および実行ディレクトリのファイルパス。アプリケーションコードは契約で許可されたパスに従ってリポジトリ内で編集されます。ループの管理情報は実行ディレクトリに留まります — それ以外のものはリポジトリに書き込まれません。

ワークフロー

  1. 受付。 タスクがループに値するか確認します(references/role-manager.md に従い、長時間実行、複数ファイル、独立した評価が必要、承認ゲートがある、または再開が必要)。そうでなければ、直接実行して停止します。 タスクがループに値すると確認されたら完了。

  2. 再開か新規かを検出。 .easy-loop/runs/*/state.json(リポジトリルートを起点)をスキャンして status: running または awaiting_approval を探します。 既存の実行を再開するか(最新のrun-idを取得 → ステップ6)、新しい実行を開始するか(→ ステップ2)がわかったら完了。

  3. 契約を交渉。 ユーザーの目標を受け取ります。プランナーを起動して contract.md(テスト可能なアサーションのチェックリスト、10~30項目を目安)をスクラッチパスにドラフトさせ、次に評価者をプランモードで起動してそれを批評させ、さらにプランナーをもう一度起動して修正させます — 1ラウンドで、その後提示します。ユーザーと実行ごとの制限(max_iterations、no_progress_rounds、contract_invalid_rounds、禁止操作)を合意し、契約の ## Limits に記録します。契約を提示する際、モデル階層(## Models)はデフォルトでオフであり、コスト制御のためにオンにできることを指摘します。ユーザーがそれを希望する場合、役割ごとの階層を記録します。また、どのレポート形式を希望するか尋ねます — デフォルトはmarkdownのみの report.md、オプションでHTMLとチャート — それを ## Report に記録します。 評価者のプランモード批評が対処され、ユーザーが contract.md を明示的に承認したら完了。

  4. 実行ディレクトリを作成。 references/loop-protocol.md に従って構築します: ベースライン結果を取得するために検証を1回実行し、spec.md(目標 + 受け入れ基準 + そのベースライン)を書き、承認された contract.md をコピーし、初期の state.json(iteration: 1、phase: "generate"、best_score: -1、status: "running")と空の log.jsonl を書き込みます。 実行ディレクトリがそのレイアウトに一致し、state.json がそれらの初期値を保持している場合に完了。

  5. バックグラウンドでランナーを起動。 Agentツールで run_in_background: true を使用してランナーを起動し、ハンドオフエンベロープ(実行パス、契約パス、許可/禁止操作、制限、および guideline.md + references/role-*.md へのポインタ)を渡します。ハーネスはランナーが戻ったときにこのセッションに通知します。ループが実行中であり、完了またはエスカレーション時のみ戻ることをユーザーに伝えます。 完全なエンベロープでバックグラウンドランナーが起動されたら完了。

  6. ランナーの結果をルーティング。 完了通知を受け取ったら、state.json を読み、status に基づいて行動します:

    • done → 成功を報告(契約が満たされた)。
    • awaiting_approval → report.md から保留中の調査結果/操作を提示し、決定を得て記録し、その後再起動(ステップ4) します(更新された契約または承認と共に)。エスカレーションが契約修正リクエスト(CONTRACT_INVALID)の場合、最初にステップ2のプランナー→承認を再実行します。再起動されるかユーザーが実行を終了するまで完了しません。
    • failed → ブロッカーを報告し、どう進めるか尋ねます。 ユーザーが結果を把握し、実行が再起動されるか明示的に終了されたら完了。
  7. 再開された実行に再アタッチ。 実行の state.json を読みます。awaiting_approval の場合 → ステップ5へ。running の場合 → log.jsonl と照合して調整し、references/loop-protocol.md に従って次のフェーズから継続し、その後ランナーを再起動します(ステップ4)。 ループが再び実行中になるか、ユーザーに引き渡されたら完了。

エスカレーション

ランナーはハンズオフで動作し、references/loop-protocol.md のトリガーが発生した場合のみ人間のために停止します。完了は評価者による受け入れチェックリストのPASSです。それ以外の場合は、ユーザーを中断せずに反復を続けます。

承認ポリシー

承認ゲート付き操作は references/loop-protocol.md の正規リストです。承認された契約はこれらを免除せず — ランナーがマネージャーを通じてエスカレーションする割り込みとして残ります。

関連スキル