審查你的第一個 Pull request

你將完成什麼

讀完這份教學後，你將完成：

前置條件：派送你的第一個代理已完成，且本工作區中已註冊的儲存庫上有一個開啟中的 pull request。進行檢閱步驟時，請挑一個不是你開啟的 PR——檢閱按鈕在你自己開啟的 PR 上會隱藏。合併在你自己撰寫的 PR 上仍然可用。

檢查點。 PR 會以分頁式工作台開啟——總覽、Diff、原始檔控制、聊天、動作——並聚焦於總覽：標題與動作、描述與活動時間軸，以及一個列出狀態、檢閱者、指派對象、檢查與變更檔案的側邊欄。點擊那裡的某個檔案，會跳至 Diff 分頁中的該檔案。除非有人要求 AI 檢閱，否則檢閱分頁不會開啟。

開啟 Diff 分頁。左側是可折疊的檔案樹，差異上方的長條帶有提交範圍選擇器——可將差異縮小到單一提交或一段提交——以及檔案數量與持續累計的新增和刪除行數。

差異工具列中的設定按鈕控制它的呈現方式：

將檔案標示為已檢視，即可在大型差異中追蹤你的進度。鍵盤導覽請見鍵盤快捷鍵。

將游標懸停在差異中的某一行——行號欄會出現一個小小的 + 膠囊按鈕
點擊它即可在該行留言，或先垂直拖曳它來選取一段範圍
輸入你的意見回饋。撰寫框提供兩種提交方式：
- 開始檢閱（若已有檢閱正在進行，則為加入檢閱）會將留言排入佇列。在你於步驟 4 提交判定之前，討論串會顯示待送出的檢閱。
- 新增單則留言會立即發佈到 GitHub。討論串會顯示正在發佈…，接著是已同步，並在發佈失敗時提供重試。

本教學請使用開始檢閱，讓留言隨判定一起送出。

判定_就是_按鈕。按下核准或要求變更後，按鈕會自行改標為已核准或請求的變更。留言判定則讓按鈕維持檢閱標籤。

檢查點。 若你選擇了前述兩者之一，按鈕會顯示「已核准」或「請求的變更」。

只要 GitHub 回報該 PR 可合併，合併按鈕就會出現——它並不以你自己的核准為前提。它的顏色代表的是就緒程度而非權限：必要核准與檢查全數通過時為主要色，仍有檢查在執行時為次要色，被要求的檢閱者尚未核准或某項檢查失敗時為破壞性色。

任何尚未解決的問題——「檢查失敗」、「有待處理的審查」——都會在確認前列在彈出面板中。

合併之後，會觸發一個 PrMerged 領域事件；分析與通知會取用它。其他監聽者請見領域事件。

Control Center 可以為開啟中的 PR 配置一條審查者管線，但只在你提出要求時才會：pr_review 範本只有手動觸發器，別無其他。

這條管線刻意不發佈到 GitHub——它在彙整後就結束。發佈是你自己另外執行的步驟，使用檢閱分頁上的發佈到 GitHub按鈕。請見使用 AI 審查。

你在工作台開啟了一個 PR、閱讀帶有語法高亮的差異、留下一則行內留言、提交了判定並合併——全程沒有離開應用程式。

下一步：建立你的第一條管線，自動化多步驟工作流程。