> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kanaeru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Kana GitHubアプリを接続し、エージェントがリポジトリを読み、プルリクエストを作成できるようにします。

Kanaeru は **Kana GitHubアプリ** を通じてリポジトリで作業します。エージェントがどのリポジトリにアクセスできるかはアプリが決めます。自分の GitHub アカウントを連携すると、コミットの作成者はそのアカウントになります。

## Kana GitHubアプリをインストールする

Kanaeru 組織のオーナーまたは管理者が、最初に 1 回だけ行います。

1. ユーザーメニュー（左サイドバー下部のあなたの名前）から **プロフィール** を開き、コネクタのセクションで **GitHub** を接続します。ワークスペース内では、ワークスペースの **設定** にある **連携サービス** → **サービスを連携** からも接続できます。
2. **Kana GitHubアプリをインストール** を選びます。GitHub の組織を追加する場合は **組織にインストール** を選びます。
3. Kanaeru に使わせるリポジトリを選びます。自分がオーナーではない組織にインストールする場合は、その組織のオーナーによる承認が必要になることがあります。

アプリが複数の GitHub アカウントにインストールされている場合は、どのインストール先を接続するかを Kanaeru が確認します。

ターミナルでは、`kana connectors install-url` でインストールページの URL を表示できます。

### アプリがアクセスできる範囲

| 権限 | アクセス |
| - | - |
| Contents | Write |
| Pull requests | Write |
| Issues | Write |
| Workflows | Write |
| Actions | Write |
| Administration | Write（アウトカムで必要になったときに新しいプライベートリポジトリを作成するためだけに使い、エージェントには渡しません） |
| Checks | Read |
| Commit statuses | Read |
| Metadata | Read |

アプリは、プルリクエスト、レビュー、レビューコメント、レビュースレッド、Issue コメント、チェックラン、チェックスイートのイベントを購読します。これらのイベントで、プルリクエストを担当しているエージェントが起動します。

## 個人の GitHub アカウントを連携する

**プロフィール** で **個人のGitHub** を接続すると、自分のセッションのコミットはあなたが作成者となり、エージェントは共同作成者として追加されます。これによってアクセス範囲が広がることはありません。エージェントがアクセスできるのは、引き続き組織のアプリのインストール先に含まれるリポジトリだけです。

連携はプロフィールからいつでも解除できます。GitHub の **Settings → Applications** で取り消すこともできます。

## プルリクエストの流れ

1. **タスクのプルリクエスト。** 各タスクは、専用のワークツリーの専用ブランチで作業します。パイプラインが完了すると、タスクブランチからアウトカムブランチへのプルリクエストを作成します。
2. **プルリクエストのケア。** エージェントは自分のプルリクエストを担当し続けます。CI の失敗やレビューの指摘を修正し、自分では答えられない質問はあなたに回します。
3. **デリバリーのプルリクエスト。** 最後のタスクのプルリクエストがマージされると、Kanaeru はリポジトリごとに、アウトカムブランチから統合ブランチへのプルリクエストを 1 件作成します。説明欄にはアウトカムの解説が入ります。
4. **受け入れ。** デリバリーのプルリクエストがマージされたら、あなたが **振り返りを開始** で承認し、アウトカムは振り返りに進みます。振り返りの後、**デリバリーを承認し、アウトカムを完了** でアウトカムが完了します。

レビューとマージは、いつもどおり GitHub で行います。Kanaeru は、マージ、レビュー、CI の結果を GitHub のイベントから取得します。


## Related topics

- [設定とプロフィール](/ja/guides/settings.md)
- [他のツールとの比較](/ja/concepts/comparison.md)
- [コマンドリファレンス](/ja/cli/reference.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.