GitHub ワークフロー
要求された操作を選択し、そのタスクリファレンスに従ってください。各操作は、ghflow タスクが事前に付与されていない通常の Issue または PR に対して行われます。今必要なタスクと共有ルールのみを読み込んでください。作業コンテキストとツールの出力 を適用して、リファレンスの読み込み、検索、および引き継ぎを行います。
操作の実行方法を選択する前に、実行モード を適用してください。ローカルモデルでの作業は、サブエージェントを使用せずに現在のセッション内に留まります。このモードは、ワーカーを派遣したり新しいレビューセッションを開始したりするタスク指示を上書きします。
ソースとツールの特定
この SKILL.md のパスをシンボリックリンクがあれば解決してください。その親ディレクトリが GHFLOW_SKILL_DIR です。以下のパスはすべて、そのディレクトリからの絶対パスで指定してください。リファレンスやサブエージェントへの引き継ぎも同様です。GHFLOW_CLI には、そのディレクトリ以下の cli/ghflow.py の絶対パスを設定してからコマンド例を実行してください。パスは引用符で囲んでください。コマンドツールは呼び出しのたびに新しいシェルを起動する可能性があるため、変数は使用する各コマンド内でエクスポートするか、完全なパスを記述してください：
export GHFLOW_CLI="ABSOLUTE_SKILL_DIRECTORY/cli/ghflow.py"
python3 "$GHFLOW_CLI" --help
ABSOLUTE_SKILL_DIRECTORY を解決したディレクトリに置き換えてください。解決されたスキルディレクトリがソースチェックアウトのルートです。その cli/ghflow.py を直接使用してください。カレントディレクトリはターゲットプロジェクトに維持し、Git、GitHub、および ID の設定がそのプロジェクトを使用するようにしてください。各リファレンスのリンクを通じて記述ガイダンスを解決し、カレントディレクトリ経由では解決しないでください。ソースの読み取りに外部ディレクトリの権限が必要な場合は、解決されたチェックアウトパスを報告し、ソースアクセス権限 のセットアップ手順を使用してください。エージェントの権限を黙って変更しないでください。
選択されたタスクリファレンスは、それが依存する共有ルールを指定します。条件が適用される場合にのみ共有リファレンスを開き、その判断を行うセクションを読んでください。最初のアクションの前にすべての共有リファレンスを読まないでください。条件は以下の通りです：認可（権限やスコープに関する質問が生じた場合）、証拠（結果を報告したり識別子を渡したりする前）、決定（事実や選択肢が不足している場合）、エージェント ID（エージェントが Git または GitHub コマンドを実行する前）、GitHub 書き込み（GitHub のレコードを変更する前）。CLI での読み取りは書き込みの許可を付与しません。
要求された操作を選択
ユーザーの明示的なリクエストを以下の操作と照合してください。対象となるリポジトリは、ユーザーのリクエストまたはターゲットチェックアウトから特定します。python3 "$GHFLOW_CLI" facts は、チェックアウト、リポジトリ、ツール、ID の準備状況、およびプロジェクトファクトファイルを報告します。--issue ISSUE_URL を付けると、その Issue のブランチ、ワークツリー、PR、およびボードアイテムも追加されます。この状態については、個別の git および gh の読み取りの代わりにこれを使用し、ファクトファイルが報告された場合は .ghflow/project.md を読んでください。ローカルモデルセッションの開始時には、preamble ISSUE_URL がこれらのファクトを最初のプロンプトに収まるコンパクトなブロックとして出力します。ソースチェックアウトは指示とツールを提供します。そのリモートと設定されたアカウントは対象を特定するものではありません。選択されたリポジトリ、Issue、または PR が見つからない場合は、GitHub 検索やディスパッチの前に必要な入力を返してください。評価のみのリクエストの場合は、成果物を提供せずに操作と制限について説明してください。問題のあるエンドポイントが不明な場合は、その判断のみを尋ねてください。バックログ作業を選択したり、固定された順序を追加したりしないでください。納品リクエストはデフォルトで、PR をオープンにしたままレビューフォローアップを行います。そのコーディネーターリファレンスを読み、選択した実行モードを適用して、ディスパッチとレビューの要件に対応してください。
| リクエスト | タスクリファレンス |
|---|---|
| 既存の Issue を再評価する | reconsider-issue |
| アイデアや Issue を定義する（下書きのみの作業を含む） | define-issue |
| Issue の決定事項をユーザーと確定させる | interview-issue |
| 広範な親 Issue を子 Issue に分割する | decompose-parent-issue |
| レビュー済みの Issue 下書きを公開する | file-issue |
| Issue をローカルコミットで実装する | implement-issue |
| コード変更を単独でレビューする | review-changes |
| コミット済みの変更を PR として公開する | submit-pr |
| PR のフィードバックに対応し CI を修復する | address-pr-review |
| 明示的に承認された PR をマージする | merge-pr |
| 選択された 1 つの Issue を納品または対応する | express-issue |
| 合意された親 Issue を納品する | deliver-parent-issue |
| 関連 Issue をテーマごとにグループ化する | bundle-issues |
| 要求された一連のオープン Issue を評価する | triage-issues |
| 入力を必要とする Issue を解決する | sweep-needs-input |
| 承認済みの Issue を定義する | sweep-needs-definition |
| ブロックされていない Issue を定義に戻す | sweep-blocked |
| クローズ済み Issue を監査する | sweep-audit-closed |
| 要求されたボードスコープの優先順位を付ける | sweep-prioritize |
| Issue を Ready キューにステージングする | curate-ready-queue |
| 明示的に要求された Ready キューを消化する | burndown-ready-queue |
| プロジェクトファクトファイルを書き込むか更新する | prepare-project-facts |
実行と引き継ぎ
持続的な作業や再構築にコストがかかる発見については、タスクノート を適用してください。再開後またはコンテキスト圧縮後は、調査を繰り返したり決定を再開したりする前に、タスクの既存のノートを読んでください。
選択されたリファレンスのスコープと停止点に従ってください。含まれるタスク全体にわたって、既存の承認を引き継いでください。下書き専用および読み取り専用の制限は引き続き適用されます。実装や提出は、決してマージ権限を意味するものではありません。
委任モードでは、調整 を適用してください。サブエージェントに選択された操作と必要な入力を渡してください。委任または必要なレビューモデルが利用できない場合は、共有ルールに従い、その制限を報告してください。
操作の実際の結果、ソース、チェック、および残っている決定事項を返してください。不足している機能や不完全な証拠を明示的に報告してください。