在 CodeCatalyst 中建立問題

PDF

焦點模式

在 CodeCatalyst 中建立問題 - Amazon CodeCatalyst

指派給 Amazon Q 問題的最佳實務

開發團隊會建立問題，以協助追蹤和管理其工作。您可以根據您的需求在專案中建立問題。例如，您可以建立一個問題來追蹤更新程式碼中的變數。您可以指派問題給專案中的其他使用者、使用標籤來協助您追蹤工作等等。

請依照這些指示在 CodeCatalyst 中建立問題。

建立問題

開啟 CodeCatalyst 主控台，網址為 https：//https://codecatalyst.aws/。
導覽至您要建立問題的專案。
在專案首頁上，選擇建立問題。或者，在導覽窗格中，選擇問題。
選擇建立問題。

注意
您也可以在使用網格檢視時內嵌新增問題。
輸入問題的標題。
（選用）輸入描述。您可以使用 Markdown 新增格式。
（選用）為問題選擇狀態、優先順序和估算。

注意
如果專案的估算設定設定為隱藏估算，則不會有估算欄位。
（選用）將任務新增至問題。任務可用來將問題的工作細分為較小的目標。若要新增任務，請選擇 + 新增任務。然後，在文字欄位中輸入任務名稱，然後按 Enter 鍵。新增任務後，您可以選擇核取方塊，將它們標記為完成，或從核取方塊左側選擇並拖曳任務，以重新排序它們。
（選用）新增現有標籤或建立新標籤，然後選擇 + 新增標籤來新增標籤。
1. 若要新增現有的標籤，請從清單中選擇標籤。您可以在欄位中輸入搜尋詞彙，以搜尋專案中包含該詞彙的所有標籤。
2. 若要建立新的標籤並新增標籤，請在搜尋欄位中輸入您要建立的標籤名稱，然後按 Enter 鍵。
（選用）透過選擇 + 新增指派者來新增指派者。您可以選擇 + 新增我，以快速將自己新增為被指派者。

提示
您可以選擇將問題指派給 Amazon Q，讓 Amazon Q 嘗試解決問題。如需詳細資訊，請參閱教學課程：使用 CodeCatalyst 生成式 AI 功能來加速開發工作。此功能僅適用於美國西部（奧勒岡）區域。
此功能需要為空間啟用生成式 AI 功能。如需詳細資訊，請參閱管理生成式 AI 功能。
（選用）新增現有的自訂欄位或建立新的自訂欄位。問題可以有多個自訂欄位。
1. 若要新增現有的自訂欄位，請從清單中選擇自訂欄位。您可以在欄位中輸入搜尋詞彙，以搜尋專案中包含該詞彙的所有自訂欄位。
2. 若要建立新的自訂欄位並將其新增，請在搜尋欄位中輸入您要建立的自訂欄位名稱，然後按 Enter 鍵。然後選擇您要建立的自訂欄位類型，並設定值。
選擇建立問題。右下角會顯示通知：如果問題已成功建立，則會出現確認訊息，指出問題已成功建立。如果未成功建立問題，則會顯示錯誤訊息，其中包含失敗原因。然後，您可以選擇重試以編輯和重試建立問題，或選擇捨棄以捨棄問題。這兩個選項都會關閉通知。

注意
您無法在建立提取請求時將其連結至問題。不過，您可以在建立之後對其進行編輯，以新增提取請求的連結。

建立和處理指派給 Amazon Q 的問題時的最佳實務

當您建立問題時，有時有些會停留。原因可能很複雜且可變。有時候是因為尚不清楚誰應該處理。有時，問題需要對程式碼庫的特定部分進行研究或專業知識，而工作的最佳候選者正忙於處理其他問題。通常，必須首先處理其他緊急工作。任何或所有這些原因都可能導致無法處理的問題。CodeCatalyst 包含與名為 Amazon Q 的生成式 AI 助理的整合，可根據其標題及其描述來分析問題。如果您將問題指派給 Amazon Q，它會嘗試建立草稿解決方案供您評估。這可協助您和您的團隊專注於和最佳化需要您注意的問題，而 Amazon Q 則致力於解決您沒有資源可立即解決的問題。

注意

採用 Amazon Bedrock 技術： AWS 實作自動濫用偵測。由於 Amazon Q 開發人員代理程式的軟體開發功能建置在 Amazon Bedrock 上，因此為我建立內容摘要、建議任務、使用 Amazon Q 來建立或新增功能，以及將問題指派給 Amazon Q 功能，因此使用者可以充分利用在 Amazon Bedrock 中實作的控制項，以強制執行人工智慧 (AI) 的安全、安全性和負責任使用。

Amazon Q 在簡單問題和直接問題上表現最佳。為了獲得最佳結果，請使用純語言來清楚說明您想要完成的動作。以下是一些最佳實務，可協助您建立針對 Amazon Q 進行最佳化處理的問題。

重要

生成式 AI 功能僅適用於美國西部（奧勒岡）區域。

保持簡單。Amazon Q 最適合進行簡單的程式碼變更和修正，可在問題的標題和描述中加以說明。請勿指派模糊標題或過於開花或矛盾描述的問題。
請具體說明。您可以提供有關解決問題所需確切變更的資訊越多，Amazon Q 就越有可能建立解決方案來解決問題。如果可能，請包含特定詳細資訊，例如您想要變更的 APIs 名稱、想要更新的方法、需要變更的測試，以及任何其他您可以想像的詳細資訊。
在將問題指派給 Amazon Q 之前，請確定您擁有問題標題和描述中包含的所有詳細資訊。您無法在將問題指派給 Amazon Q 之後變更問題的標題或描述，因此在將問題指派給 Amazon Q 之前，請務必先擁有問題中所需的所有資訊。
僅指派需要變更單一來源儲存庫中程式碼的問題。Amazon Q 只能在 CodeCatalyst 的單一來源儲存庫中處理程式碼。不支援連結的儲存庫。確定問題只需要在單一來源儲存庫中進行變更，再將問題指派給 Amazon Q。
使用 Amazon Q 建議的預設值來核准每個步驟。根據預設，Amazon Q 需要您核准每個步驟。這可讓您在評論中與 Amazon Q 互動，不僅針對問題，也針對其建立的任何提取請求。這可提供更互動式的 Amazon Q 體驗，協助您調整其方法並精簡其建立的程式碼來解決問題。

注意
Amazon Q 不會回應問題或提取請求中的個別評論，但會在要求重新考慮其方法或建立修訂時檢閱它們。
請務必仔細檢閱 Amazon Q 建議的方法。一旦您核准其方法，Amazon Q 將開始根據該方法產生程式碼。請確定方法似乎正確，並包含您預期的所有詳細資訊，再告知 Amazon Q 繼續。
只有在您還沒有可能部署工作流程的現有工作流程時，才務必允許 Amazon Q 處理工作流程。您的專案可能已設定工作流程，以在提取請求事件上開始執行。如果是這樣，Amazon Q 建立的任何提取請求，包括建立或更新工作流程 YAML 可能會開始執行提取請求中包含的工作流程。最佳實務是，除非您確定專案中沒有工作流程會自動執行這些工作流程，否則請勿選擇允許 Amazon Q 處理工作流程檔案，再檢閱並核准其建立的提取請求。