在 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 每月執行有限次數的功能開發。您隨時可以透過 AWS 帳戶註冊 Amazon Q Developer 應用程式安裝，以增加免費用量。如需詳細資訊，請參閱 在 Amazon Q Developer 主控台中提高用量限制和設定詳細資訊。

重要

Amazon Q Developer 應用程式會嘗試在您授權存取的 GitHub 儲存庫中，自動建立 Amazon Q 開發代理程式和 Amazon Q 轉換代理程式標籤。如果未自動建立標籤，或意外刪除標籤，您可以在 GitHub 中手動建立標籤。標籤必須命名為 Amazon Q 開發代理程式和 Amazon Q 轉換代理程式，才能將其辨識為 Amazon Q Developer 標籤並進行處理。如需詳細資訊，請參閱文件 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 Actions。