gh-issues

• 明確にスコープが定義されたバグ issue のバックログがある場合、人間によるレビューの前に、自動修正を一度試みたいときに活用できます。
• スケジュールされた CI/cron パイプラインを運用している場合、手動介入なしに issue を自動的にトリアージして PR を作成したいときに使用します（--cron モード）。
• フォークベースのコントリビューションモデルで作業している場合、アップストリームリポジトリをターゲットとした PR を作成するために、フォークにブランチをプッシュする必要があるときに利用できます（--fork）。
• PR レビューコメントを自動的に対処したい場合 — --reviews-only を使用すると、gh-issues がオープンな fix/issue-* PR をスキャンし、変更依頼に対する修正をプッシュします。

• Issueが曖昧、アーキテクチャに関わる、またはスコープが大きい — gh-issuesのサブエージェントは自己評価で信頼度を判定し、7/10未満と評価したIssueはスキップしますが、非常に複雑なIssueは手動で対応する必要があります。
• 確実な正確性が必要な場合 — サブエージェントは利用可能なテストを実行しますが、自動生成された修正はプロダクションにマージする前にレビューしてください。
• GitHubトークン（GH_TOKEN）がない場合 — gh-issuesはトークンなしではいかなるGitHub APIにも認証できません。

最大8つのサブエージェントが同時並行で動作し、それぞれが1つのIssueをエンドツーエンドで担当します。具体的には、ブランチの作成、コード分析、修正の実装、テストの実行、コミット、プッシュ、そしてPRのオープンまでを一貫して処理します。各エージェントには60分の時間枠が設けられており、組み込みの信頼度チェック機能も備わっています。信頼度が10点満点中7点以上を満たせないIssueは、自動的にスキップされます。

PRがオープンされた後、フェーズ6はレビュー、インラインコメント、一般的なPRコメント、さらにはGreptileなどの埋め込みボットレビューも取得します。対応が必要なコメントは追加のサブエージェントをトリガーし、そのサブエージェントがブランチをチェックアウトして、要求された変更を適用し、更新をプッシュし、各コメントにコミットSHAを返信します。

--fork user/repo を渡すことで、すべてのブランチをフォークにプッシュし、フォークからアップストリームのソースリポジトリを対象としたPRを開くことができます。アップストリームへの書き込み権限を必要とせず、標準的なオープンソースのコントリビューションワークフローに対応しています。

--cron はファイア・アンド・フォーゲット型のスケジューリングを有効にします。オーケストレーターは条件を満たすイシューを1つ選択し、サブエージェントを起動した後、即座に終了します。これにより、数分ごとにcronジョブから安全に呼び出すことができます。--watch はオーケストレーターを継続的に稼働させ、設定可能なインターバルで新しいイシューとレビューコメントをポーリングし続けます。

スポーン前に、このスキルは既存のオープンなPR、プッシュリポジトリ上の進行中のブランチ、および2時間の有効期限を持つローカルのクレームファイルを確認します。これにより、重複したサブエージェントが、重複するcron実行や監視サイクルをまたいで同じissueに対して競合するのを防ぎます。

Telegram チャンネル ID を指定して --notify-channel を渡すと、PR リンクと各 Issue の結果を含む最終サマリーメッセージを受信できます。送信されるのは最終結果のみで、途中の進捗状況は送信されません。

スケジュールジョブから /gh-issues owner/repo --label bug --limit 10 --cron を実行します。呼び出しのたびに、次の未着手バグissueを選択し、修正を実装するサブエージェントを起動して終了します。時間をかけて、実行と実行の間に人の手を介することなく、バックログが段階的に処理されていきます。

/gh-issues upstream/project --fork myfork/project --label good-first-issue を使用することで、gh-issues がアップストリームリポジトリからイシューを取得し、修正ブランチをあなたのフォークにプッシュして、アップストリームをターゲットとしたPRをオープンします — 標準的なコントリビューターワークフローに従った形で実行されます。

既存のPRパイプラインと並行して、/gh-issues owner/repo --reviews-only --cron をスケジュール設定します。各実行では、未対応の CHANGES_REQUESTED レビューやインラインコメントが存在するオープン中の fix/issue-* PRをスキャンし、最初の未処理PRを選択して、要求された変更を適用し返信するエージェントを起動します。

スプリント計画セッション中に /gh-issues owner/repo --label enhancement --watch --interval 10 を実行します。このスキルはissueを取得し、どれを処理するか確認を求め、エージェントを起動し、新しいissueとレビューフィードバックを10分ごとにポーリングします。「stop」と入力するまで、累積結果を表示し続けます。