ドキュメント自動化

GitHubの接続

ワークスペースにGitHubアカウントとリポジトリを接続する方法と、組織リポジトリの承認手順を説明します。

SpecifyはGitHubリポジトリをドキュメントの根拠として使います。リポジトリを接続すると、エージェントがコードを読み取ってドキュメントを生成し、以降の変更を修正案として用意できるようになります。

GitHubは2か所から接続できます。

ドキュメントプロジェクトの作成のソースのステップにあるGitHub を接続 — ドキュメント生成の根拠となるリポジトリを選びます。
ツールとスキル → コネクタ → GitHubの連携 — チャットでエージェントがコードとイシュー・PRをあわせて参照できるようにします。コネクターの接続を参照してください。

接続の流れ

GitHubの接続を開始する
ドキュメントプロジェクトの作成画面のソースのステップでGitHub を接続を選択します。このワークスペースでリポジトリを選択するには、まずGitHubを接続する必要があります。
GitHubでアクセスを許可する
GitHubの画面に移動したら、Specifyが読み取るアカウントとリポジトリの範囲を選択して許可します。
リポジトリとブランチを選択する
Specifyに戻ったらGitHub アカウントを選び、リポジトリ名で検索して選択してから、ブランチを選びます。一覧を読み込めない場合は、owner/repo形式で直接入力することもできます。

組織リポジトリには、GitHub組織の管理者の承認が必要です。

組織の管理者の承認を待っている間は、その組織のリポジトリは一覧に表示されません。

コネクターでGitHubを連携すると、エージェントがリポジトリのコード・ファイル内容、イシュー・PRとコメント、コミット履歴を読み取り、コード検索やイシュー・PRの要約などの作業を行えるようになります。

1つのドキュメントプロジェクトに複数のソースを追加できます。プロジェクト設定のソース項目で、ドキュメントの根拠として使うリポジトリとブランチを追加または削除します。各ソースには役割を指定できます。

ソースごとにpush で実行をオンにすると、そのブランチにコードをpushしたときにもドキュメントの修正案を用意します。詳しい設定は自動化の詳細設定を参照してください。

症状	確認すること
リポジトリを読み込めない	しばらくしてから再試行するか、手動で入力で`owner/repo`を入力します。
利用できるリポジトリがない	選択したGitHubアカウントで、Specifyへのアクセスを許可したリポジトリがあるか確認します。
利用できるブランチがない	リポジトリにブランチがあるか、アクセス権限があるかを確認します。
組織リポジトリが表示されない	組織の管理者の承認が完了しているかを確認してから、再接続を押します。