での Amazon Q Developer による機能の開発と反復処理 GitHub

注記

Amazon Q Developer for GitHubはプレビューリリースであり、変更される可能性があります。

で Amazon Q Developer を使用するとGitHub、新機能とバグ修正を自動的に実装し、タスクをアイデアから完成したプルリクエストに取り込むことで、開発を合理化できます。機能開発ラベルを問題に追加するか/q dev、スラッシュコマンドを使用すると、Amazon Q Developer はタイトルや説明、リポジトリコードをコンテキストとして使用して、新しいコード修正を生成し、プルリクエストを作成します。プルリクエストでは、フィードバックを提供でき、Amazon Q Developer は提案されたコードを繰り返し実行します。

Amazon Q Developer で機能開発を 1 か月あたり限られた回数で実行できます。Amazon Q Developer アプリのインストールを AWS アカウントに登録することで、いつでも無料利用を増やすことができます。詳細については、「Amazon Q Developer コンソールの使用制限の引き上げと詳細の設定」を参照してください。

重要

Amazon Q Developer アプリは、アクセスを許可する GitHub リポジトリに Amazon Q 開発エージェントと Amazon Q Transform エージェントラベルを自動的に作成しようとします。ラベルが自動的に作成されない場合や、意図せずに削除された場合は、 で手動で作成できますGitHub。ラベルを Amazon Q Developer ラベルとして認識して処理するには、ラベルに Amazon Q 開発エージェントと Amazon Q 変換エージェントという名前を付ける必要があります。詳細については、GitHub ドキュメントの「ラベルの作成」を参照してください。

機能開発に Amazon Q Developer を使用するには

1. 必要に応じて、認証情報を使用してGitHubアカウントにサインインしますGitHub。

2. GitHub 組織に移動し、Amazon Q Developer で新機能を実装するリポジトリに移動します。

3. 問題を選択し、新しい問題を作成するか、既存の問題を選択します。詳細については、GitHub ドキュメントの「問題の作成」を参照してください。

   1. 新しい問題については、「タイトルテキスト入力の追加」フィールドに、機能開発のために Amazon Q Developer にコンテキストを提供するタイトルを入力します (例：「画像認識アプリの作成」）。問題の説明はコンテキストも提供するため、含める必要があります。

      既存の問題については、問題のタイトルと説明を編集して、機能開発のコンテキストを Amazon Q Developer に提供できます。詳細については、 GitHubドキュメントの「問題の編集」を参照してください。

4. 問題の作成時または既存の問題の設定時に、機能開発 Amazon Q Developer /q dev ラベルを適用するか、スラッシュコマンドを使用できます。次のいずれかを行います：

   • 問題にラベルを適用するには、次のいずれかを実行します。

     • ブラウザ拡張機能として提供されている Amazon Q に割り当てるドロップダウンメニューを選択し、Amazon Q 開発エージェントラベルを選択します。

     • 右側のメニューで、ラベルを選択し、Amazon Q 開発エージェントラベルを選択します。

   • コメントで/q devスラッシュコマンドを使用するには：

     1. 問題内で、コメントの追加に移動し、コメントテキスト入力フィールドに「」と入力します/q dev。

     2. [Comment] (コメント) を選択します。

5. 新しい問題の場合は、問題の作成を選択して、Amazon Q Developer が機能を開発するために必要な詳細を含む問題の作成を完了します。既存の問題を設定する場合は、必ず変更を保存してください。詳細については、 GitHubドキュメントの「問題の編集」を参照してください。

   Amazon Q Developer が機能開発のコード変更の生成を完了すると、問題にコメントし、プルリクエストを開きます。

6. Amazon Q Developer が残したコメント (例：I finished generating the proposed code changes and opened a pull request: Resolve Create an image recognition app「」) に移動し、プルリクエストリンクを選択します。

   プルリクエストタブに移動し、Amazon Q Developer によって作成されたプルリクエストを選択することもできます。

7. ファイル変更タブを選択して、コードの変更を表示します。

8. 提案されたコード変更に満足したら、プルリクエストをマージできます。詳細については、「プルリクエストをマージする」を参照してください。

Amazon Q Developer にフィードバックを提供することで、機能開発のプルリクエストを確認し、推奨されるコード変更を反復処理することもできます。

Amazon Q Developer 機能開発コードで反復処理するには

1. Amazon Q Developer によって作成されたプルリクエストを選択し、ファイルの変更タブを選択してコードの変更を表示します。

2. フィードバックを残して Amazon Q Developer に繰り返しさせるコードの行については、＋ を選択してフィードバックを含むコメントを追加し、レビューの開始を選択します。

   レビューを送信すると、Amazon Q Developer はフィードバックに基づいてコードのレビューを開始します。Amazon Q Developer がフィードバックの修正を完了すると、プルリクエストに変更がコミットされ、コメントで更新されます。

3. 「レビューの完了」を選択し、「変更のリクエスト」ラジオボタンを選択し、「レビューの送信」を選択してフィードバックをレビューします。

4. 更新されたコードの変更に満足したら、プルリクエストをマージするか、新しいフィードバックでコードを再度繰り返すことができます。詳細については、「プルリクエストをマージする」を参照してください。

Amazon Q Developer は GitHub Actions ワークフローと統合して、インテリジェントなフィードバックループシステムを作成します。プルリクエストが作成されると、ユニットテストなどの設定されたワークフローが自動的に実行されます。ワークフローが失敗した場合、Amazon Q Developer は出力を分析し、結果と失敗情報に基づいてコードの変更を反復します。コードの変更がプッシュされ、ワークフローが実行されると、Amazon Q Developer は結果を解釈し、この情報を使用してアプローチを絞り込みます。これにより、各反復が以前の試行に基づいて構築され、Amazon Q Developer がそのソリューションを進化できる継続的な学習ループが作成されます。

フィードバックループの有効性は、Amazon Q Developer が解釈して行動するための有意義なフィードバックを提供する、明確に定義されたテストとワークフローがあることに依存します。リポジトリ内の GitHub Actions YAML ファイルを使用してワークフローを設定できるため、Amazon Q Developer が応答できるカスタマイズされたテストおよび検証プロセスが可能になります。詳細については、 GitHubドキュメントのGitHub「アクションについて」を参照してください。