GitHub の CLI を使う

GitHub を接続しておくと、エージェントが gh（GitHub CLI）でプルリクエストを作り、読み、コメントし、 CI の様子を見られます。セッションの中で gh auth login をする必要はありません。

全体像

あなたがやること	エージェントがやること
GitHub を接続する	`gh` を、ログインなしで使う
やってほしいことを頼む	あなたのアカウントとしてプルリクエストを作る・コメントする
権限が足りないと言われたら、接続を直す	権限が足りないときは、そう伝えて止まる

gh は、呼び出しのたびに保存済みの接続を読みます。期限のあるトークンは、git と同じように使うときに更新されます。エージェントは最初から使い方を知っているので、コマンドを教える必要はありません。

⚙設定 →「Git ホスティング」 で GitHub（github.com）を接続します。git の clone・push と同じ接続です。手順は Git のサービスを接続するにあります。

ふだんどおりにお願いするだけです。

この変更でプルリクエストを作って。説明は日本語で

PR 123 のレビューコメントを読んで、直して push して

main の CI が落ちている理由を調べて

エージェントは次のようなことができます。

テナントが組み込みの GitHub OAuth アプリで接続しているとき、トークンのスコープは repo と workflow だけです。このトークンでは、自分の個人リポジトリでも gh pr edit が失敗することがあります。

GraphQL: … The 'login' field requires one of the following scopes: ['read:org']

エージェントには、この場合は REST API で直すよう伝えてあります。自分で直すときも同じです。

gh api -X PATCH repos/<owner>/<repo>/pulls/<N> -F body=@<ファイル>
gh api -X PATCH repos/<owner>/<repo>/pulls/<N> -f title="新しいタイトル"

自分で設定したものがあれば、gh はそちらを使います。

こうしているとき	動き
`GH_TOKEN` か `GITHUB_TOKEN` を設定した	`gh` はそのトークンを使い、接続は使いません
GitHub Enterprise のホストに `gh auth login` した	そのホストには、あなたが `gh auth login` したアカウントが使われます

接続がないか、使えなくなっています。⚙設定 →「Git ホスティング」で、GitHub のカードが「接続済み」かを見てください。