Communitygithub.com

fr-goal: 自律ゴール駆動PRパイプライン

Claude Code向けプラグインスイート: 計画立案、devcontainer+worktree分離、ゴールからPRまでの自律実行、VibeKanbanランナーへのフェーズディスパッチを実現します。

fr-goal: 自律ゴール駆動PRパイプライン とは?

fr-goalは、Claude Codeエージェントが「ゴール記述」から「レビュー済みPR」までを自律的に実行するための包括的なワークフローを定義したスキルです。開発者は単一のゴールを記述するだけで、エージェントがブレインストーミング、仕様策定、実装計画、TDDベースの実装、コードレビュー、PR作成までの一連の工程を自動で進めます。特徴的なのは、すべての承認ポイントを「レビュー&修正」パスに置き換え、人間の介入を最小限にしつつ品質を担保する点です。秘匿情報やデプロイ作業などの手動フェーズは自動的に最後にバックロードされ、エージェントが誤った推測を出荷するリスクを回避します。対応プラットフォームはClaude Codeで、fr-plan、fr-execute、fr-isolationなどの関連ツールと連携して動作します。このスキルにより、開発者は細かい指示出しから解放され、戦略的レビューとマージ判断に集中できるようになります。

対応✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add derio-net/super-fr

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

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

ドキュメント

fr-goal

1つのオペレータタッチポイントで、ゴールからレビュー済みPRまでを実現します: ブレインストーミング → 一括Q&A → 仕様 → レビュー → fr-plan → レビュー → TDD実装 → レビュー → 単一PR。各レビューでは見つかった問題をすべて修正します。オペレータの自律化指示により、各承認停止はレビュー&修正パスに置き換えられます。ブロックされた場合: 停止し、何がブロックされているか、何を試したかを伝え、質問をします — 間違った推測をPRで出荷する方が、実行を一時停止するよりコストがかかります。

開始時に宣言: 「このゴールをfr-goalを使用して自律実行しています。」

対話が必要な箇所

タイミング理由
一括Q&A (1回、ブレインストーミング時)設計判断はオペレータが所有 — 未回答=停止、デフォルトは不可
マルチプロジェクトリポジトリの場所アクセス質問 — ファイルシステムが回答できない場合のみ
手動フェーズシークレット、UI操作、デプロイは人間のみ — 配置ポリシー参照
PRマージエージェントは自己マージしない
マージ後テスト計画実際のデプロイを証明; オペレータの環境が必要

1. 一括Q&Aによるブレインストーミング — 分離環境で

fr-brainstorming を呼び出します(fr isolation up を先に実行; devcontainerプロファイルがない場合 → 一時停止してfr-initインタビューを実施)。分離はすべてに優先します — 調査、測定、クラスタ操作も含む; オペレータが「Xから開始」と指示した場合、最初のアクションではなく最初の作業項目が変更されます。調査し、オペレータが所有する判断をすべて収集し、すべてを1回のAskUserQuestion呼び出しで質問します(最大4質問、最初の推奨)。デリバラブルがデプロイされる場合(サービス/ボット/インフラ)にのみ、マージ後テスト計画の質問を含めます。純粋なコードの場合は含めません。遅れて出た質問もバッチ処理します。ハードゲート: 未回答の呼び出しは停止信号です — ターンを終了し、未回答の質問を再度述べて待機します。実際の回答をデフォルト値で代用してはいけません。

2. 仕様 — その後レビュー

docs/superpowers/specs/<YYYY-MM-DD-slug>-design.md を作成し、Q&Aの回答およびコードベースの現実に対してレビューします(記述されたファイル/ヘルパー/サービスが実際に存在するか?)。すべての指摘を修正します。テスト計画が選択された場合、仕様にはマージ後のステップを示す ## Test Plan セクションが含まれます。

3. マルチプロジェクトチェック

クロスリポジトリ仕様(owner/repo:path 形式)の場合、このセッションは1つのリポジトリの計画とPRを担当します。他の各リポジトリについては: 作業コピーを自分で探します(兄弟ディレクトリ、通常のルート)。見つからない場合のみパス/クローンを質問し、Q&Aにバッチ処理します。仕様リファレンスとステップ4からのパイプラインを使用して、リポジトリごとに1つのエージェントをディスパッチします(isolation: "worktree")。計画1つ、PR1つをリポジトリごとに作成します。

4. 計画 — fr-plan、その後レビュー

fr-plan を呼び出し、セクションごとの承認をスキップします(仕様が設計をエンコードしています)。v2計画をフォルダとして保持し、TDD形式のステップにします。レビュー: fr plan self-review がパスし、フェーズが仕様に対して読み返され(すべてカバーされていること)、修正、実装します。

5. 手動フェーズ — デフォルトでバックロード

fr-planのエージェント純粋性ゲートは、手動作業を専用の [manual] フェーズに収集します。fr-goalは配置ポリシーを追加します(計画途中の手動フェーズは実行を停止します):

  • デフォルトでバックロード: すべての手動作業を最後のフェーズに配置し、それに依存するエージェントフェーズは置きません。PRは意図的に未実装の状態で出荷され、オペレータ用にマークされ、オペレータが同じPRに実装してプッシュします(fr plan edit --complete-phase N --note)。
  • エージェント作業が本当にそれに依存する場合のみフロントロードします。 計画 + レビューを完了し、仕様 + 計画のPRを開き(手動の指示自体がデリバラブル)、一時停止; オペレータのGo指示があるまで再開しません。
  • マルチリポジトリ: クロスリポジトリの依存関係をモデル化 — depends_on は計画内でのみ有効なので、順序は仕様とPRシーケンスに依存します(あるリポジトリのシークレットが別のリポジトリのフェーズをゲートする可能性があります)。

6. 実装 — fr-executeローカルモード、TDD、サブエージェントなし

ステップ1の分離ワークスペースが作業コピーです — すべてのコマンドは fr isolation exec 経由で実行します。fr-execute をLOCALモードで実行します(計画ディレクトリ + フェーズ)、ディスパッチはしません(仕様/計画がmainになく、fr apply --yes が拒否します)。サブエージェントではなくインラインで実装します(コンテキストとしてQ&A + 仕様の履歴が必要です)。ステップごとにTDD; ステップをチェック/ fr plan edit でフェーズを完了します。手動フェーズは決して実行しません。

実装レイヤーはブランチをプッシュするのみ — PRは開きません(インライン、または委任されたマルチリポジトリビルダーによる)。ここでPRを開くと、レビュー(7)の前にデリバ(8)が順序を入れ替え、オペレータが修正前にマージできるようになり、修正がマージ済みブランチに孤立してしまいます(#320、3回)。オーケストレーターは可視性のために ドラフト PRを開きます — ステップ8まではマージ不可、「Draft」バッジは「まだマージしないで」を意味します。

7. マイルストーンでのレビュー — 見つかったすべてを修正

各マイルストーン(完了したフェーズ、または小規模計画の場合は実装全体)の後、仕様 + 計画 + コードに対して superpowers:requesting-code-review を呼び出します。すべての指摘を即座に修正し、テストを追加します。事実上誤った指摘は反論理由を付けて返答します(superpowers:receiving-code-review)、黙って無視してはいけません。発見リストを保持します。

8. デリバリ — リポジトリごとに1PR、すべての成果物を含む

最初に検証します(superpowers:verification-before-completion): 完全なテストスイート出力、自己レビューパス、ステップがチェック済みであること。PRは今(ステップ7の修正後)のみマージ可能にします: ドラフトに対して gh pr ready — この前に「マージ準備完了」と言ってはいけません。PR本文: サマリー + 仕様/計画パス; レビュー指摘とその修正(反論された指摘があればそれも); バックロードされた手動フェーズが「未実装 — オペレータがこのPRにプッシュ」とマークされていること; テスト計画をそのまま、「ポストマージ — オペレータ駆動」とラベル付け。停止; オペレータがマージします。

9. マージ後クローズアウト

オペレータがマージを報告したとき: まず修正が main に到達したことを確認します — fr isolation verify-merge --branch <b> を実行します(スカッシュ/リベース/マージセーフ; 終了コード1=未確認)。未確認の場合 → 停止して復旧します(チェリーピック / 新しいPR)。次に、テスト計画があれば実行します(エージェントがチェックを実行し、オペレータが到達できないものを確認)。フェーズ完了を確認し(fr status)、fr archive <plan-dir> を実行し、ハウスキーピングPRでコミット、fr isolation down を実行します。

関連スキル