翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Q Developer for GitHub (プレビュー)
**注記**
Amazon Q Developer for GitHub はプレビューリリースであり、変更される可能性があります。
[Amazon Q Developer for GitHub または GitHub Enterprise Cloud](https://github.com/marketplace/amazon-q-developer) を使用すると、ソフトウェア開発ワークフローで Amazon Q Developer の機能を活用できます。特殊な開発エージェントを使用すると、新しいアイデアを実装し、品質の問題のコードを確認し、ユニットテストで脆弱性に対処できます。エージェントがタスクを完了すると、フィードバックを提供でき、エージェントは前のソリューションのイテレーションを行います。詳細については、「[Amazon Q Developer エージェント](#github-agents)」を参照してください。
[https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer) から Amazon Q Developer 統合にアクセスし、組織のリポジトリへのアクセスを許可できます。Amazon Q Developer for GitHub の使用を開始するには、「[クイックスタート: GitHub のインストール、機能の使用、使用制限の引き上げ](github-quickstart.md)」を参照してください。
**重要**
Amazon Q Developer アプリをインストールして GitHub リポジトリへのアクセスを許可するには、GitHub 組織の要件を満たしている必要があります。詳細については、「*GitHub ドキュメント*」の「[GitHub App をインストールするための要件](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app)」および「[Organization のロール](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)」を参照してください。
**注記**
Amazon Q Developer と GitHub の統合は米国内でデータを処理します。詳細については、「[Cross-region processing in Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/cross-region-processing.html)」を参照してください。
**注記**
Amazon Q Developer for GitHub (プレビュー) は現在、サービスの改善のためにユーザーのコンテンツを使用しません。AWS が今後これを有効にする場合は、適切な通知とそのような使用をオプトアウトする方法が提供されます。
**Topics**
+ [Amazon Q Developer アプリのインストールとアクセスの承認](#github-concepts-set-up)
+ [Amazon Q Developer エージェント](#github-agents)
+ [アプリのインストールの登録](#github-concepts-register-app-install)
+ [GitHub でのブラウザ拡張機能の使用](#github-concepts-extensions)
+ [GitHub 問題とプルリクエストでのスラッシュコマンドの使用](#github-slash-commands)
+ [クイックスタート: GitHub のインストール、機能の使用、使用制限の引き上げ](github-quickstart.md)
+ [GitHub での Amazon Q Developer による機能開発とイテレーション](github-feature-development.md)
+ [Amazon Q Developer in GitHub を使用したコードレビュー](github-code-reviews.md)
+ [Amazon Q Developer コンソールの使用制限の引き上げと詳細の設定](github-register-app-install.md)
+ [登録済みインストールの詳細の設定](github-configuration.md)
+ [Amazon Q Developer for GitHub の問題のトラブルシューティング](github-troubleshooting.md)
## Amazon Q Developer アプリのインストールとアクセスの承認
GitHub 組織管理者は、開始するために AWS アカウントを設定することなく、 から Amazon Q Developer アプリ[https://github.com/apps/amazon-q-developer](https://github.com/apps/amazon-q-developer)を無料でインストールして設定できます。インストールプロセス中に、GitHub 組織内のすべてのリポジトリまたは選択したリポジトリへのアクセスを提供することを選択します。インストールして承認すると、GitHub で Amazon Q Developer 機能を無料で使用できます。[Amazon Q Developer コンソール](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github)でアプリのインストールを登録することで、無料利用枠を増やすことができます。を増やすことができます。を増やすことができます。詳細については、「[クイックスタート: GitHub のインストール、機能の使用、使用制限の引き上げ](github-quickstart.md)」を参照してください。
**重要**
Amazon Q Developer アプリをインストールして GitHub リポジトリへのアクセスを許可するには、GitHub 組織の要件を満たしている必要があります。詳細については、「*GitHub ドキュメント*」の「[GitHub App をインストールするための要件](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app)」および「[Organization のロール](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)」を参照してください。
**注記**
GitHub エンタープライズ組織が IP 許可リストを有効にしている場合は、GitHub アプリで許可された IP アドレスを受け入れる必要があります。IP アドレスを許可リストに自動的に追加することもできます。詳細については、「*GitHub ドキュメント*」の「[GitHub Apps によるアクセスの許可](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps)」および「[許可 IP アドレスを有効化する](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#enabling-allowed-ip-addresses)」を参照してください。
GitHub リソースへのアクセスには、次の IP アドレスが使用されます。
```
34.228.181.128
44.219.176.187
54.226.244.221
```
## Amazon Q Developer エージェント
Amazon Q Developer エージェントは、コーディング、テスト、デプロイからトラブルシューティングまで、ソフトウェア開発ライフサイクル全体でサポートを提供します。
+ **Amazon Q Developer エージェント** – 問題を作成して機能開発ラベルを追加すると、Amazon Q Developer は新機能の実装とバグ修正を自動的に行います。Amazon Q Developer は、変更と変更の概要を含むプルリクエストを作成します。ラベルを適用する代わりに、問題のコメントで `/q dev` スラッシュコマンドを使用して機能開発を開始することもできます。詳細については、「[GitHub での Amazon Q Developer による機能開発とイテレーション](github-feature-development.md)」を参照してください。
+ **Amazon Q コードレビューエージェント** – 新しいプルリクエストが作成されるか、クローズドプルリクエストが再開されると、Amazon Q Developer は自動的にコードレビューを実行し、コードの品質、潜在的な問題、セキュリティ上の懸念に関するフィードバックを提供します。Amazon Q Developer は、特定された問題の修正も生成します。これを確認してプルリクエストにコミットすることができます。コードレビューには、スレッド化された検出結果を含むコードレビューの概要が含まれます。Amazon Q Developer を操作するには、プルリクエストコメントで `/q` コマンドを使用して、コードレビューの結果について質問します。
自動コードレビューは、既存のプルリクエスト内で行われた後続のコミットによってトリガーされません。`/q review` スラッシュコマンドを使用して、プルリクエスト内で追加のコードレビューを開始できます。詳細については、「[Amazon Q Developer in GitHub を使用したコードレビュー](github-code-reviews.md)」を参照してください。
**重要**
Amazon Q Developer アプリは、アクセスを許可するGitHubリポジトリに **Amazon Q 開発エージェント**ラベルを自動的に作成しようとします。ラベルが自動的に作成されない場合、または意図せずに削除された場合は、 で手動で作成できますGitHub。ラベルを **Amazon Q Developer ラベルとして認識して処理するには、ラベルに Amazon Q 開発エージェント**という名前を付ける必要があります。詳細については、「*GitHub ドキュメント*」の「[ラベルの作成](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label)」を参照してください。
## アプリのインストールの登録
GitHub への Amazon Q Developer の統合は無料で利用できます。開始するために AWS アカウントを設定する必要はありません。機能開発では 1 か月あたりの呼び出し数に制限があり、コードレビューでは 1 か月あたりの行数に制限があります。Amazon Q Developer アプリのインストールを AWS アカウントに登録することで、無料利用枠を増やすことができます。詳細については、「[Amazon Q Developer コンソールの使用制限の引き上げと詳細の設定](github-register-app-install.md)」を参照してください。
**重要**
Amazon Q Developer コンソールでアプリのインストールを登録するには、GitHub 組織の要件を満たしている必要があります。詳細については、「*GitHub ドキュメント*」の「[GitHub App をインストールするための要件](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app)」および「[OAuth apps と Organization](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations)」を参照してください。
## GitHub でのブラウザ拡張機能の使用
サポートされているブラウザで Amazon Q Developer 拡張機能を使用すると、ラベルメニューを検索しなくても、GitHub問題で機能開発用のラベルをすばやく追加できます。
Amazon Q Developer 拡張機能は、次のブラウザで使用できます。
+ [Google Chrome](https://chromewebstore.google.com/detail/amazon-q-github-issue-hel/oefafjbablenakmhacfllkmpaeabnnfi)
+ [Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/amazon-q-github-issue-helper)
+ [Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/amazon-q-github-issue-helper/poghackjbfhejeppjaegbnblangjbmmc)
## GitHub 問題とプルリクエストでのスラッシュコマンドの使用
GitHub 問題のコメントやプルリクエストでスラッシュコマンドを使用することで、Amazon Q Developer を呼び出して開発タスクを実行したり、サポートを提供したりできます。
+ `/q dev` - GitHub 問題で Amazon Q Developer を呼び出して、新機能の実装とバグ修正を自動的に行います。Amazon Q Developer は、変更と変更の概要を含むプルリクエストを作成します。
+ `/q review` - Amazon Q Developer を呼び出して、プルリクエストが作成または再開されたときにコードレビューを自動的に実行します。コードレビューは、コードの品質、潜在的な問題、セキュリティ上の懸念に関するフィードバックとともに、修正案、スレッド化された検出結果を含むコードレビューの概要を提供します。プルリクエストコメントで `/q` を使用して、検出結果を操作します。自動レビューは、既存のプルリクエストへの後続のコミットによってトリガーされません。
+ `/q help` - スラッシュコマンド、機能、カスタマイズの詳細に加えて、「*Amazon Q Developer Developer Guide*」の「[Amazon Q Developer for GitHub (プレビュー)](#amazon-q-for-github) ドキュメント」へのリンクなど、Amazon Q Developer for GitHub に関する情報を提供します。
# クイックスタート: GitHub のインストール、機能の使用、使用制限の引き上げ
**注記**
Amazon Q Developer for GitHub はプレビューリリースであり、変更される可能性があります。
このチュートリアルでは、以下のタスクについて説明します。
1. GitHub Marketplace から Amazon Q Developer アプリをインストールして、リポジトリへのアクセスを提供します。
1. 問題が発生した場合は、機能開発用のラベルを追加するか、コードレビュー用の新しいプルリクエストを作成して、Amazon Q Developer の使用を開始します。または、問題でスラッシュコマンドを使用して機能開発を開始することもできます。さらにスラッシュコマンドを使用して、プルリクエスト内で追加のコードレビューを開始することもできます。
1. (オプション) Amazon Q Developer アプリのインストールを AWS アカウントに登録して、使用制限を増やします。
## ステップ 1: GitHub に Amazon Q Developer をインストールしてアクセスを許可する
Amazon Q Developer は、 AWS アカウントをセットアップしなくてもGitHub無料で使用できます。GitHub で Amazon Q Developer を使用する最初のステップは、[https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer) からアプリをインストールすることです。このプロセス中に、Amazon Q Developer にすべての GitHub リポジトリまたは選択したリポジトリへのアクセスを提供できます。
**重要**
Amazon Q Developer アプリをインストールして GitHub リポジトリへのアクセスを許可するには、GitHub 組織の要件を満たしている必要があります。詳細については、「*GitHub ドキュメント*」の「[GitHub App をインストールするための要件](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app)」および「[Organization のロール](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)」を参照してください。
**Amazon Q Developer をインストールしてアクセスを許可するには**
1. [Amazon Q Developer for GitHub アプリ](https://github.com/marketplace/amazon-q-developer)ページに移動します。
1. 必要に応じて、GitHub 認証情報を使用して [https://github.com/](https://github.com/) アカウントにサインインします。
1. Amazon Q Developer アプリの概要と機能を確認し、**[インストール]** を選択します。
1. GitHub リポジトリへのアクセスを設定するには、次のいずれかを実行します。
1. 現在および今後のすべてのリポジトリへのアクセスを許可するには、**[すべてのリポジトリ]** を選択します。
1. 特定のリポジトリへのアクセスを許可するには、**[リポジトリのみを選択]** を選択し、**[リポジトリを選択]** ドロップダウンを選択して、アクセスを許可するリポジトリを選択します。
1. **[インストール]** を選択して、GitHub への Amazon Q Developer のインストールを完了し、リポジトリへのアクセスを承認します。
GitHub にアプリをインストールしてアクセスを許可すると、GitHub の Amazon Q Developer の概要ページにリダイレクトされます。GitHub リポジトリに移動して、Amazon Q Developer 機能の使用を開始できます。
**注記**
GitHub エンタープライズ組織が IP 許可リストを有効にしている場合は、GitHub アプリで許可された IP アドレスを受け入れる必要があります。IP アドレスを許可リストに自動的に追加することもできます。詳細については、「*GitHub ドキュメント*」の「[GitHub Apps によるアクセスの許可](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps)」および「[許可 IP アドレスを有効化する](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#enabling-allowed-ip-addresses)」を参照してください。
GitHub リソースへのアクセスには、次の IP アドレスが使用されます。
```
34.228.181.128
44.219.176.187
54.226.244.221
```
## ステップ 2: GitHub で Amazon Q Developer 機能を使用する
に Amazon Q Developer アプリをインストールGitHubし、リポジトリへのアクセスを許可したら、Amazon Q Developer エージェントを使用して、アプリケーションのコーディング、テスト、デプロイからトラブルシューティングまで、ソフトウェア開発ライフサイクル全体でサポートを開始できます。詳細については、以下のいずれかを参照してください。
**重要**
Amazon Q Developer アプリは、アクセスを許可するGitHubリポジトリに **Amazon Q 開発エージェント**ラベルを自動的に作成しようとします。ラベルが自動的に作成されない場合、または意図せずに削除された場合は、 で手動で作成できますGitHub。ラベルを **Amazon Q Developer ラベルとして認識して処理するには、ラベルに Amazon Q 開発エージェント**という名前を付ける必要があります。詳細については、「*GitHub ドキュメント*」の「[ラベルの作成](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label)」を参照してください。
+ [GitHub での Amazon Q Developer による機能開発とイテレーション](github-feature-development.md)
+ [Amazon Q Developer in GitHub を使用したコードレビュー](github-code-reviews.md)
## ステップ 3: 無料使用枠を増やし、詳細を設定する
GitHub での Amazon Q Developer エージェントは無料で使用できます。開始するために AWS アカウントを設定する必要はありません。機能開発とコードレビューのために、1 か月あたりの呼び出しが制限されています。Amazon Q Developer アプリのインストールを AWS アカウントに登録することで、いつでも無料利用を増やすことができます。登録すると、コードレビューの無効化や、検索とフィルタリングのためのタグの追加などの詳細を設定することもできます。詳細については、「[Amazon Q Developer コンソールの使用制限の引き上げと詳細の設定](github-register-app-install.md)」を参照してください。
**重要**
Amazon Q Developer コンソールでアプリのインストールを登録するには、GitHub 組織の要件を満たしている必要があります。詳細については、「*GitHub ドキュメント*」の「[GitHub App をインストールするための要件](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app)」および「[OAuth apps と Organization](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations)」を参照してください。
# GitHub での Amazon Q Developer による機能開発とイテレーション
**注記**
Amazon Q Developer for GitHub はプレビューリリースであり、変更される可能性があります。
GitHub で Amazon Q Developer を使用すると、新機能の実装とバグ修正を自動的に実装し、タスクをアイデアから完成したプルリクエストに取り込むことで、開発を合理化できます。機能開発ラベルを問題に追加するか、`/q dev` スラッシュコマンドを使用すると、Amazon Q Developer はタイトルや説明、リポジトリコードをコンテキストとして使用して、新しいコード修正を生成し、プルリクエストを作成します。プルリクエストでは、ユーザーはフィードバックを提供でき、Amazon Q Developer は推奨コードを繰り返し実行します。
Amazon Q Developer での機能開発の実行回数は、1 か月あたりの回数制限があります。Amazon Q Developer アプリのインストールを AWS アカウントに登録することで、いつでも無料利用を増やすことができます。詳細については、「[Amazon Q Developer コンソールの使用制限の引き上げと詳細の設定](github-register-app-install.md)」を参照してください。
**重要**
Amazon Q Developer アプリは、アクセスを許可するGitHubリポジトリに **Amazon Q 開発エージェント**ラベルを自動的に作成しようとします。ラベルが自動的に作成されない場合、または意図せずに削除された場合は、 で手動で作成できますGitHub。ラベルを **Amazon Q Developer ラベルとして認識して処理するには、ラベルに Amazon Q 開発エージェント**という名前を付ける必要があります。詳細については、「*GitHub ドキュメント*」の「[ラベルの作成](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label)」を参照してください。
**機能開発に Amazon Q Developer を使用するには**
1. 必要に応じて、GitHub 認証情報を使用して [https://github.com/](https://github.com/) アカウントにサインインします。
1. GitHub 組織に移動し、Amazon Q Developer を使用して新機能を実装するリポジトリに移動します。
1. **[問題]** を選択し、新しい問題を作成するか、既存の問題を選択します。詳細については、「*GitHub ドキュメント*」の「[Issue の作成](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/creating-an-issue)」を参照してください。
1. 新しい問題の場合、**[タイトルの追加]** テキスト入力フィールドで、機能開発のために Amazon Q Developer にコンテキストを提供するタイトルを入力します (例:「画像認識アプリの作成」)。問題の説明はコンテキストも提供するため、含める必要があります。
既存の問題の場合、問題のタイトルと説明を編集して、機能開発のために Amazon Q Developer にコンテキストを提供できます。詳細については、「*GitHub ドキュメント*」の「[issue の編集](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/editing-an-issue)」を参照してください。
1. 問題の作成時または既存の問題の設定時に、機能開発 Amazon Q Developer ラベルを適用するか、`/q dev` スラッシュコマンドを使用できます。次のいずれかを行います:
+ 問題にラベルを適用するには、次のいずれかを実行します。
+ ブラウザ拡張機能として提供されている **[Amazon Q への割り当て]** ドロップダウンメニューを選択し、**[Amazon Q Developer エージェント]** ラベルを選択します。
+ 右側のメニューで **[ラベル]** を選択し、**[Amazon Q Developer エージェント]** ラベルを選択します。
+ コメントで `/q dev` スラッシュコマンドを使用するには:
1. 問題内で **[コメントの追加]** に移動し、コメントテキスト入力フィールドに「`/q dev`」と入力します。
1. **[コメント]** を選択します。
1. 新しい問題の場合は、**[問題の作成]** を選択して、Amazon Q Developer が機能を開発するために必要な詳細を含む問題の作成を完了します。既存の問題を設定する場合は、必ず変更を保存してください。詳細については、「*GitHub ドキュメント*」の「[issue の編集](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/editing-an-issue)」を参照してください。
Amazon Q Developer が機能開発のコード変更の生成を完了すると、問題にコメントし、プルリクエストを開きます。
1. Amazon Q Developer が残したコメント (例:「`I finished the proposed code changes, and the pull request is ready for review: [PR link]`」) に移動し、プルリクエストリンクを選択します。
**[プルリクエスト]** タブに移動し、Amazon Q Developer によって作成されたプルリクエストを選択することもできます。
1. **[変更されたファイル]** タブを選択して、コードの変更を表示します。
1. 提案されたコード変更に問題がない場合、プルリクエストをマージできます。詳細については、「[pull request のマージ](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)」を参照してください。
Amazon Q Developer にフィードバックを提供することで、機能開発のプルリクエストを確認し、推奨されるコード変更のイテレーションを実行することもできます。
**Amazon Q Developer 機能開発コードでイテレーションを実行するには**
1. Amazon Q Developer によって作成されたプルリクエストを選択し、**[変更されたファイル]** タブを選択してコードの変更を表示します。
1. 必要に応じて、フィードバックを提供する特定のコード行について、**\$1** を選択してフィードバックを含むコメントを追加します。
会話では、 `/q` コマンドの後に自然言語 ( `/q implement my suggestions`や など) の手順を使用できます`/q refactor this function for better performance`。Amazon Q Developer は、フィードバックに基づいて行う変更を説明するコメントで応答します (たとえば、「フィードバックに基づいて次の変更を実装します: ...」）。実装が完了すると、Amazon Q Developer は、変更を確認する別のコメント (「提案された変更を実装しました」など) と、変更を表示できる生成されたコミットへのリンクを投稿します。
1. 会話で提供されたコミットリンクに従って、Amazon Q Developer によって行われた変更を確認します。必要に応じて、 コマンドを使用して追加のフィードバックを提供し、`/q`さらに繰り返しを行うことができます。
1. 更新されたコードの変更に問題がない場合、プルリクエストをマージするか、新しいフィードバックでコードを再度繰り返すことができます。詳細については、「[pull request のマージ](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)」を参照してください。
# Amazon Q Developer in GitHub を使用したコードレビュー
**注記**
Amazon Q Developer for GitHub はプレビューリリースであり、変更される可能性があります。
Amazon Q Developer は、GitHub 内で自動コードレビューを有効化します。新しいプルリクエストを作成するか、クローズドプルリクエストを再開すると、Amazon Q Developer は自動的にコードレビューを実行し、コードの品質、潜在的な問題、重要度の高い検出結果に関するフィードバックを提供します。各レビューには、スレッド化された検出結果を含むコードレビューの概要が含まれます。Amazon Q Developer は、特定された問題の修正も生成します。これを確認してプルリクエストにコミットすることができます。プルリクエストコメントで `/q` コマンドを使用して、コードレビューの結果について質問したりやり取りしたりすることができます。自動コードレビューは、既存のプルリクエスト内で行われた後続のコミットによってトリガーされません。
**注記**
Amazon Q Developer コンソールのコードレビュー機能設定は、プルリクエストが作成または再開されたときに実行される自動コードレビューを制御します。プルリクエストコメントで`/q review`スラッシュコマンドを使用してコードレビューを開始することは、この設定の影響を受けません。
`/q review` スラッシュコマンドを使用して、プルリクエスト内でコードレビューを開始することもできます。スラッシュコマンドを新しいプルリクエストコメントに追加できます。これにより、コメントや新しいコミットを含め、現在のステータスでプルリクエストの新しいコードレビューが開始されます。詳細については、「[GitHub プルリクエスト内でのコードレビューの開始](#github-code-reviews-in-pr)」を参照してください。
Amazon Q Developer は、1 か月あたり限られた数の行に対してコードレビューを実行できます。Amazon Q Developer アプリのインストールを AWS アカウントに登録することで、いつでも無料利用を増やすことができます。詳細については、「[Amazon Q Developer コンソールの使用制限の引き上げと詳細の設定](github-register-app-install.md)」を参照してください。
**注記**
コードレビュー機能が以前に無効になっている場合は、GitHub でラベルを適用する前に [Amazon Q Developer コンソール](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github)で有効にする必要があります。詳細については、「[Amazon Q Developer in GitHub の機能の編集](github-configuration.md#github-edit-features)」を参照してください。
## 前提条件
Amazon Q Developer でコードレビューを開始する前に、ターゲット GitHub リポジトリに対する適切なアクセス許可が必要です。サポートされているリポジトリロールは、書き込み、メンテナンス、または管理者です。読み取りロールまたはトリアージロールを持つユーザー、およびロールを持たないメンバーは、Amazon Q Developer でコードレビューを開始できません。
GitHub トリアージロールを持つユーザーは、リポジトリ内のプルリクエストを引き続きレビューできます。ロールに関係なく、ユーザーはパブリックリポジトリでプルリクエストをレビューできます。
詳細については、「*GitHub ドキュメント*」の「[Organization のリポジトリロール](https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization#repository-roles-for-organizations)」および「[事前に定義済みの組織の役割について](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#about-pre-defined-organization-roles)」を参照してください。
## GitHub プルリクエストのコードレビューの開始
新しいプルリクエストを開くか、クローズドプルリクエストを再開すると、Amazon Q Developer は自動的にコードレビューを実行し、コード品質、潜在的な問題、重要な検出結果に関するフィードバックを提供します。
**Amazon Q Developer をコードレビューに使用して修正を適用するには**
レビューを開始する前に、`project-root/.amazonq/rules` ディレクトリのシンプルな Markdown ファイルでカスタムコーディング標準を定義することで、コード品質レビューをカスタマイズできます。Amazon Q は自動的にガイドラインに従い、プロジェクト全体で一貫したコード品質を確保します。詳細については、「[サードパーティープラットフォームでの Amazon Q Developer のプロジェクトルールの作成](third-party-context-project-rules.md)」を参照してください。
1. 必要に応じて、GitHub 認証情報を使用して [https://github.com/](https://github.com/) アカウントにサインインします。
1. GitHub 組織に移動し、Amazon Q Developer でコードレビューを実行するリポジトリに移動します。
1. ソースコードに加えられた変更のプルリクエストを新しく作成します。詳細については、「*GitHub ドキュメント*」の「[pull request の作成](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)」を参照してください。
新しいプルリクエストを作成すると、Amazon Q Developer は自動的にコードレビューを開始し、潜在的な問題を検出します。Amazon Q Developer がレビューを完了すると、コードレビューの概要が表示されます。各検出結果は、プルリクエストにコミットできる推奨される修正とともに、概要の下にスレッドコメントとして表示されます。
1. 変更を実装し、プルリクエストのソースブランチに直接コミットを作成するようにエージェントに依頼します。これを行うには、 で始まり`/q`、その後にエージェントが変更を加えるためのリクエストを自然言語で投稿します。
1. (オプション) 特定の検出結果について質問します。プルリクエスト内で、**[コメントの追加]** に移動し、コメントテキスト入力フィールドに、質問 (「`/q explain the importance of this finding`」など) に続けて「`/q`」と入力します。
1. Amazon Q Developer によって提案されたコード変更を確認し、**[提案をコミットする]** を選択し、**[変更をコミットする]** を選択してプルリクエストを更新します。
1. 提案されたコード修正に問題がない場合は、プルリクエストをマージして、Amazon Q Developer によって提案されたコード変更を適用できます。詳細については、「*GitHub ドキュメント*」の「[pull request のマージ](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)」を参照してください。
## GitHub プルリクエスト内でのコードレビューの開始
Amazon Q Developer が新規または再開された GitHub プルリクエストに対して自動コードレビューを実行した後、`/q review` スラッシュコマンドを使用して追加のコードレビューを開始してコードのイテレーションを実行できます。コードレビューは、プルリクエストの差分全体に対して実行されます。
**注記**
コードレビューは、新しいコメントを含むプルリクエスト内でのみ開始できます。`/q review` スラッシュコマンドは、既存のコメントスレッドでは機能しません。`/q review` スラッシュコマンドを使用したコードレビューの開始は、Amazon Q Developer コンソールのコードレビュー機能設定の影響を受けません。
**プルリクエストでコードレビューの開始するには**
1. 必要に応じて、GitHub 認証情報を使用して [https://github.com/](https://github.com/) アカウントにサインインします。
1. GitHub 組織に移動し、Amazon Q Developer でコードレビューを実行するプルリクエストに移動します。詳細については、「[pull requests について](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)」を参照してください。
1. プルリクエスト内で **[コメントの追加]** に移動し、コメントテキスト入力フィールドに「`/q review`」と入力します。
1. **[コメント]** を選択してコードレビューを開始します。
Amazon Q Developer がプルリクエストコードの分析を完了するまでに数分かかる場合があります。Amazon Q Developer が分析を完了すると、コードレビューの概要が表示されます。各検出結果は、プルリクエストにコミットおよびアップデートできる提案される変更とともに、概要の下にスレッドコメントとして表示されます。
1. (オプション) 特定の検出結果について質問します。プルリクエスト内で、**[コメントの追加]** に移動し、コメントテキスト入力フィールドに、質問 (「`/q explain the importance of this finding`」など) に続けて「`/q`」と入力します。
1. 提案されたコード修正に問題がない場合は、プルリクエストをマージして、Amazon Q Developer によって提案されたコード変更を適用できます。詳細については、「*GitHub ドキュメント*」の「[pull request のマージ](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)」を参照してください。
# Amazon Q Developer コンソールの使用制限の引き上げと詳細の設定
**注記**
Amazon Q Developer for GitHub はプレビューリリースであり、変更される可能性があります。
で Amazon Q Developer エージェントGitHubを無料で使用できます。開始するために AWS アカウントを設定する必要はありません。機能開発およびコードレビュー機能については、1 か月あたりの呼び出し数が限られています。Amazon Q Developer アプリのインストールを AWS アカウントに登録することで、いつでも無料利用を増やすことができます。
デフォルトでは、**コードレビュー**と**機能開発**機能は、アプリのインストールGitHub時に で有効になります。登録時に、これらの機能のいずれかを無効にすることができます。登録するには、コンソールから機能を管理する Amazon Q Developer プロファイルが必要です。プロファイルには、設定とコードレコメンデーションのカスタマイズが保存されます。
**重要**
Amazon Q Developer コンソールでアプリのインストールを登録するには、GitHub 組織の要件を満たしている必要があります。詳細については、「*GitHub ドキュメント*」の「[GitHub App をインストールするための要件](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app)」および「[OAuth apps と Organization](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations)」を参照してください。
**Amazon Q Developer のインストールを登録するには**
1. [Amazon Q Developer コンソール](https://us-east-1.console.aws.amazon.com/amazonq/developer/home)に移動します。
1. ページの上部にある**「Q Developer を有効にする**」を選択し、プロンプトに従って Kiro と Amazon Q Developer を有効にします。
Kiro と Amazon Q Developer を以前に有効にした場合は、ステップ 3 に進みます。
1. ナビゲーションペインで、 **で Amazon Q Developer GitHub**を選択します。
1. **[インストールの登録]** を選択し、**[認証]** を選択して GitHub に移動します。
以前に Amazon Q Developer に GitHub 組織へのアクセスを許可した場合は、Amazon Q Developer コンソールにリダイレクトされます。この場合、ステップ 7 に進みます。
1. GitHub 認証情報を使用して GitHub アカウントにサインインします。複数のアカウントがある場合は、Amazon Q Developer へのアクセスを許可するアカウントを選択します。
1. **[Amazon Q Developer を承認]** を選択して、GitHub アカウントへのアクセスを付与します。認証後、Amazon Q Developer コンソールにリダイレクトされます。
1. **[登録の詳細]** で、GitHub の詳細を入力し、オプションでコードレビュー機能を設定し、タグを追加します。
1. **[登録名]** テキスト入力フィールドに、アプリのインストールの名前を入力します。
1. (オプション) **[組織名 - *オプション*]** テキスト入力フィールドに、アプリのインストールに関連付けられた組織の名前を入力します。
1. (オプション) **[機能]** でトグルを選択して **[コードレビュー]** 機能を設定し、機能を有効または無効にします。**機能開発**設定は変更できず、デフォルトで有効になっています。
1. (オプション) **タグ - オプション**で、**新しいタグを追加** を選択して、 で AWS リソースを検索およびフィルタリングするのに役立つタグを追加しますGitHub。
1. **Register** を選択して、アプリのインストールを AWS アカウントに登録GitHubします。
アプリのインストールを正常に登録したら、登録の詳細を表示できます。コードレビュー機能を有効または無効にしたり、後でタグを追加したりできます。登録を削除することもできます。詳細については、「[登録済みインストールの詳細の設定](github-configuration.md)」を参照してください。
# 登録済みインストールの詳細の設定
**注記**
Amazon Q Developer for GitHub はプレビューリリースであり、変更される可能性があります。
Amazon Q Developer プロファイルを作成し、アプリのインストールを GitHub に登録したら、Amazon Q Developer コンソールから以下を実行できます。
+ コードレビューの使用を有効または無効にする。機能開発設定は現在変更できません。
+ GitHub 問題に Amazon Q Developer 機能ラベルを追加する方法を提供するブラウザ拡張機能へのリンクを検索する。
+ タグを追加して、リソースを検索およびフィルタリングしたり、 AWS コストを追跡したりできます。
+ GitHub アプリのインストール登録を削除する。
## Amazon Q Developer in GitHub の機能の編集
Amazon Q Developer in GitHub で使用できる機能は、GitHub にアプリをインストールし、組織にアクセスするための認証を付与するときに、デフォルトで有効になります。GitHub でこの機能を使用しなくなった場合は、機能を無効にすることができます。
**Amazon Q Developer in GitHub の機能を有効化または無効化するには**
1. [Amazon Q Developer コンソール](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github)に移動します。
1. ナビゲーションペインの **[Amazon Q Developer in GitHub]** で、**[登録済みインストール]** を選択します。
1. **[名前]** 列で、機能を有効または無効にするインストールの登録名を選択します。
1. **[機能]** で、**[編集]** を選択して機能の可用性を設定します。
1. モーダルで、有効または無効にする機能のトグルを選択し、**[保存]** を選択して変更を保存します。
[Amazon Q Developer コンソール](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github)で機能を有効または無効にすると、変更は GitHub に反映されます。機能を無効にした後に Amazon Q Developer ラベルに問題を割り当てると、エラーが発生します。この機能が無効になっている場合、コードレビューは新しいプルリクエストで行われなくなります。
## ブラウザ拡張機能のインストール
Amazon Q Developer 拡張機能は、サポートされているブラウザのいずれかにインストールできます。拡張機能を使用すると、ラベルメニューで検索することなく、GitHub問題発生時に機能開発タスクを Amazon Q Developer にすばやく割り当てることができます。
Amazon Q Developer 拡張機能は、次のブラウザで使用できます。
+ [Google Chrome](https://chromewebstore.google.com/detail/amazon-q-github-issue-hel/oefafjbablenakmhacfllkmpaeabnnfi)
+ [Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/amazon-q-github-issue-helper)
+ [Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/amazon-q-github-issue-helper/poghackjbfhejeppjaegbnblangjbmmc)
[Amazon Q Developer コンソール](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github)の登録インストールの詳細ページで、サポートされているブラウザを表示することもできます。
## Amazon Q Developer GitHub アプリのインストール登録の削除
Amazon Q Developer コンソールを使用して、GitHub アプリインストールの登録を削除できます。登録を完全に削除すると、登録に関連付けられたすべてのデータも削除されます。このアクションは元に戻すことができません。
**GitHub アプリのインストールを削除するには**
1. [Amazon Q Developer コンソール](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github)に移動します。
1. ナビゲーションペインの **[Amazon Q Developer in GitHub]** で、**[登録済みインストール]** を選択します。
1. 次のいずれかを行います:
+ **[アクション] **列で、削除するインストールの **[登録の削除]** を選択します。
+ **[名前]** 列で、削除するインストールの登録名を選択し、**[削除]** を選択します。
**[アクション] **列で、削除する登録済みインストールの **[登録の削除]** を選択します。
1. モーダルで、登録の削除の詳細を確認します。
1. テキスト入力フィールドに「**confirm**」と入力し、**[削除]** を選択して、変更を確認します。
GitHub アプリのインストールを削除したら、新しいインストールの登録を選択できます。
# Amazon Q Developer for GitHub の問題のトラブルシューティング
Amazon Q Developer for GitHub を使用する際の一般的な問題のトラブルシューティングについては、次のセクションを参照してください。
## Amazon Q Developer がブランチ保護ルールを持つリポジトリでプルリクエストを生成しない
**問題**: Amazon Q Developer は、ブランチ保護ルールがある GitHub リポジトリにプルリクエストを作成できません。
**解決策**: ブランチ保護ルールは、Amazon Q Developer がブランチを作成してプルリクエストを作成できないようにします。ブランチ保護ルールを持つリポジトリで Amazon Q Developer for GitHub を使用するには、Amazon Q Developer アプリを許可リストに追加する必要があります。
**Amazon Q Developer アプリを許可リストに追加するには**
1. 必要に応じて、GitHub 認証情報を使用して [https://github.com/](https://github.com/) アカウントにサインインします。
1. GitHub 組織に移動し、許可するリポジトリに移動して、Amazon Q Developer for GitHub アプリを一覧表示します。
1. **[設定]** を選択し、ナビゲーションペインで **[ブランチ]** を選択します。
1. **[ブランチ保護ルール]** で、**[編集]** を選択してブランチ保護ルールを変更します。
1. **[一致するブランチを作成するプッシュを制限する]** を選択し、Amazon Q Developer for GitHub アプリを検索します。
1. **[変更を保存]** を選択して、Amazon Q Developer が Amazon Q Developer ラベルに関する問題のプルリクエストを作成できるようにします。
GitHub でのブランチ保護ルールの変更の詳細については、「[ブランチ保護ルールを作成する](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule#creating-a-branch-protection-rule)」を参照してください。
## GitHub 問題に Amazon Q Developer ラベルがない
**問題**: GitHub問題に **Amazon Q 開発エージェント**ラベルが表示されません。
**解決策**: GitHubアプリケーション用の Amazon Q Developer をインストールしたときにラベルが自動的に作成されない場合、または意図せずに削除された場合は、 で手動で作成できますGitHub。ラベルを **Amazon Q Developer ラベルとして認識して処理するには、ラベルに Amazon Q 開発エージェント**という名前を付ける必要があります。詳細については、「*GitHub ドキュメント*」の「[ラベルの作成](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label)」を参照してください。
## Amazon Q Developer が GitHub 問題のコードを作成しない
**問題**: GitHub 問題を作成し、タスクを実行するために Amazon Q Developer を呼び出したが、技術的な問題に関する以下の一連のメッセージが表示された。
1. ⏳ I'm working on generating code for this issue. I'll update this issue with a comment and open a pull request when I'm done.
1. ⚠️ I'm having technical difficulties. I couldn't solve the issue. I'm going to try again. This might take some time.
1. ⚠️ I'm having technical difficulties. I couldn't solve the issue. I'm going to try again. This might take some time.
1. 🔴 I'm having technical difficulties. I couldn't solve the issue.
Consider reassigning this issue to a user. This will help you stay within the quotas for generative AI feature usage.
**解決策**: Amazon Q Developer が問題を処理してコードを生成できない場合は、新しい問題を作成し、**Amazon Q 開発エージェント**ラベルを新しい問題に適用します。問題の作成と Amazon Q Developer エージェントラベルの適用の詳細については、「」を参照してください[GitHub での Amazon Q Developer による機能開発とイテレーション](github-feature-development.md)。