GitHub での Amazon Q Developer による機能開発とイテレーション - Amazon Q Developer

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 コンソールの使用制限の引き上げと詳細の設定」を参照してください。

重要

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    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. 提案されたコード変更に問題がない場合、プルリクエストをマージできます。詳細については、「pull request のマージ」を参照してください。

Amazon Q Developer にフィードバックを提供することで、機能開発のプルリクエストを確認し、推奨されるコード変更のイテレーションを実行することもできます。

Amazon Q Developer 機能開発コードでイテレーションを実行するには

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

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

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

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

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

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 Actions を理解する」を参照してください。