GitHub CLI 新增 gh event listen 與團隊 Copilot 外掛預設:終端機即時等 PR、團隊一鍵共用外掛
GitHub 推出兩項開發者工作流更新:GitHub CLI v2.105.0 支援 Event Streams 與 gh event listen 免輪詢等待 PR 事件,同時 Copilot Business 與 Enterprise 團隊可設定共用的預設外掛。
無論是人類工程師還是越來越普及的 AI 寫程式代理,在送出 Pull Request(PR)之後,最常做的事情之一就是「等結果」,例如等 CI 自動化測試跑完、等同事送出審查意見,或是確認有沒有合併衝突。
為了讓終端機與代理腳本不必再寫迴圈反覆查詢,GitHub 於 2026 年 11 月 18 日推出 gh event listen 指令,讓 gh 命令列工具原生支援 GitHub Event Streams 即時事件串流。
過去要在終端機裡等這些 PR 狀態更新,工程師或代理通常得寫一個迴圈每隔幾秒就呼叫一次 API,這種做法在軟體工程上稱為「輪詢」。
輪詢不只浪費 API 呼叫額度、腳本寫起來很繁瑣,還常常因為間隔太長而反應慢半拍,或是間隔太短而觸發平台的速率限制。
在同一天,GitHub 也宣布 Copilot 團隊自訂功能 正式全面開放給 Copilot Business 與 Copilot Enterprise 團隊使用。
這項更新解決了另一個日常摩擦:過去團隊好不容易挑出幾套好用的 Copilot 代理外掛,新成員加入時卻還是得自己手動設定一遍,而全公司強制套用又太缺乏彈性。
透過 gh event listen 與團隊共用外掛這兩項更新,開發者與 AI 代理在終端機等待任務與團隊同步工具鏈時,都能大幅減少重複勞動。
告別無止盡的 API 輪詢:gh event listen 怎麼運作?
在軟體工程中,「輪詢」就像是每隔五分鐘跑去信箱看一次信來了沒;而「事件串流」則是直接跟郵局約好,信一到就立刻按門鈴通知你。
GitHub CLI 從 v2.105.0 版本開始正式支援 GitHub Event Streams(目前為預覽功能)。
開發者或 AI 代理只需要在終端機執行單一指令 gh event listen,並指定目標 Pull Request 的網址以及關心的事件類型,工具就會在背景自動建立訂閱並開啟串流連線。
每當符合條件的事件發生時,終端機就會在第一時間將事件內容以單行 JSON 格式印在標準輸出上,完全不需要開發者自己撰寫計時器或重試迴圈。
預設收到一個事件就結束,專為腳本與代理迴圈設計
gh event listen 有一個非常實用的預設行為:只要收到第一筆符合條件的事件,指令就會自動結束並回傳結果。
這讓它能像普通同步指令一樣,直接插進 Shell 腳本或 AI 代理的執行迴圈裡面。
舉例來說,當 AI 代理送出一個 Pull Request 之後,它只要接著執行 gh event listen,就能安靜地停在原地等待,直到自動化測試全部跑完或審查者送出意見才繼續下一步,省下大量無意義的思考步驟與 API 呼叫。
當然,如果你的需求不只是「等一次事件就收工」,指令也提供了幾組實用的旗標參數來應付不同情境:
--count:指定總共要等待的事件數量,適合需要收集多個狀態回報或連續檢查點的情境。--follow:持續保持串流連線監聽後續事件,不會在收到第一筆後自動結束,方便即時監控整段 PR 生命週期。--timeout:設定最長等待時間上限,避免自動化腳本或代理在沒有事件發生時無限期卡住。--jq或--template:直接從回傳的 JSON 事件資料中萃取出真正需要的欄位,例如只印出檢查結果的最終結論,省去另外接一支解析腳本的麻煩。
支援哪些 PR 事件與訂閱管理指令?
根據 GitHub 官方更新說明,目前 gh event listen 已經支援監聽四類最核心的 Pull Request 事件:
- 審查者已送出 Code Review
- Pull Request 狀態變更或來源分支頂端有新的提交推送
- 系統偵測到分支之間發生合併衝突
- CI 檢查套件執行完畢並回報結果
如果你想更細緻地管理背後的事件訂閱,而不只是隨用隨聽,也能直接使用 gh event subscription create、list、view 與 delete 等子指令,來手動建立、列出、查看或刪除既有的訂閱項目。
現有指令也會主動引導 AI 代理切換過去
這項更新還有一個特別針對 AI 代理生態設計的巧思:GitHub CLI 讓現有的常用指令主動擔任「引導員」。
在升級到新版本之後,當人類開發者或 AI 代理執行 gh pr create、gh pr view、gh run view、gh run watch 或 gh api 時,CLI 工具現在會主動提示建議改用 gh event listen 來取代傳統輪詢。
這意味著即使開發者沒有特別去修改系統提示詞,具備終端機操作能力的 AI 代理也能自己發現這項新指令,進而自動切換到更省資源的即時等待模式。
實務指令怎麼下?從單次等待到指定欄位輸出
在實際的終端機操作或自動化腳本裡,gh event listen 的參數組合相當簡潔直覺,幾個核心用法就能應付多數開發場景。
如果開發者或代理剛建立一個 Pull Request,只想安靜等到有人送出審查意見就繼續下一步,只需要將 --resource 指向該 PR 的網址,並透過 --event 指定審查送出事件,指令就會在收到第一筆事件後立刻結束。
如果需要長時間監控同一個 PR 的多次狀態變化,例如每次推送新程式碼後都要追蹤 CI 檢查套件是否完成,則可以加上 --follow 保持串流開啟,或是用 --count 限制接收幾筆事件後就停止。
搭配 --timeout 設定最長等待秒數,能確保自動化流程在無人回應時準時退場,不會無限期卡住終端機。
最後,只要加上 --jq 或 --template 參數,就能直接從雲端事件格式(CloudEvents)的 JSON 輸出裡抽取出關鍵欄位,例如只印出檢查結果是通過還是失敗,讓後續的自動化判斷邏輯乾淨俐落。
延伸閱讀:GitHub 與 Microsoft 公開 MDASH 試行:9,791 筆 AI 資安發現,為何只送出 99 份報告?

團隊共用 Copilot 外掛正式登場:補齊個人與企業之間的缺口
同一天宣布的另一項正式版更新,則是 GitHub Copilot 團隊自訂功能,主要適用於 Copilot Business 與 Copilot Enterprise 兩大商業方案。
在過去管理 Copilot 的代理外掛時,工程組織往往會陷入兩難的局面。
如果完全交由每位工程師各自摸索安裝,團隊內部的工具鏈就會變得五花八門,新人報到時還得重新對照一堆文件手動設定;反過來說,如果由企業管理員在全公司層級統一規定,不同職能團隊(例如前端組、基礎設施組與資料工程組)真正需要的外掛其實大不相同,全公司共用一套反而顯得僵化。
這次正式上線的團隊自訂功能,正好在「個人自由調整」與「全組織強制政策」之間搭起了一座橋樑,讓團隊維護者與組織擁有者可以為特定團隊挑選一組共用的預設代理外掛。
三步驟設定團隊預設外掛,三大開發介面自動同步
團隊維護者設定這套共用清單的流程相當直覺,只要登入 github.com 並開啟所屬的組織團隊頁面,切換到 Customize Copilot 分頁就能完成:
- 瀏覽並挑選外掛:你可以直接從 Copilot 內建市集、企業內部市集,或是團隊自行加入的市集裡瀏覽現有外掛,將經過驗證與核准的代理外掛加入該團隊清單。
- 掛載團隊自訂市集:如果團隊自己維護了一套內部專用外掛,只要把外掛市集存放在 GitHub 儲存庫中,就能直接從這個設定頁面加入該儲存庫作為市集來源,接著再勾選要啟用的個別外掛。
- 跨環境預設啟用:儲存設定後,被選中的外掛就會自動成為該團隊「直接成員」的預設啟用項目,適用範圍涵蓋 VS Code、GitHub Copilot App 以及 Copilot CLI 三大開發表面。
值得一提的是,這項功能在權限邊界上保留了很合理的彈性:子團隊不會自動繼承上層團隊的預設外掛,避免大型組織架構層層繼承造成意料之外的套件衝突。
同時,團隊預設外掛被定位為「建議性的共同起點」而非死板規定,只要企業政策允許,團隊成員依然可以在自己的 Copilot 客戶端中手動關閉不需要的外掛。
組織與企業安全政策依然具備最高優先權
對於大型企業的資安與合規團隊來說,把部分外掛配置權下放到團隊維護者手上,最擔心的就是會不會有人不小心繞過公司原本的安全管控。
GitHub 在官方公告中特別強調,企業與組織層級的安全政策永遠優先於團隊選擇。
換句話說,如果企業管理員已經規定只允許使用特定白名單市集、強制所有人都必須開啟某個稽核外掛,或是明確封鎖了特定高風險外掛,各個 Copilot 客戶端依然會嚴格執行這些上位規範,團隊層級的預設清單絕對無法覆蓋或繞過組織與企業級的管控措施。
企業、團隊與個人三層治理怎麼分工?
把這項更新放進整個 GitHub Copilot 的管理架構來看,三層權限的分工變得非常清楚。
最上層的企業與組織負責劃定安全底線,決定哪些外掛市集可以信任、哪些合規外掛必須強制安裝、哪些工具全面禁止。
中間的團隊維護者則負責效率最佳化,針對前端、後端或資安等不同職能挑選實用的團隊預設清單,省去新人重複設定的麻煩。
最下層的個別開發者則保有彈性空間,只要不違反企業強制政策,依然可以針對個人習慣開關團隊預設外掛,或補充自己偏好的開發輔助工具,在統一標準與個人手感之間取得平衡。
延伸閱讀:GitHub Copilot App 新增瀏覽器操作與 Azure DevOps:預覽功能怎麼開、權限怎麼管?
常見問題(FAQ)
1. 我已經升級到 gh v2.105.0 了,為什麼還是無法使用 gh event listen?
gh event 系列指令與背後的 GitHub Event Streams 目前都處於預覽階段。除了本機命令列工具需要升級至 v2.105.0 或更新版本外,你的 GitHub 帳號或所屬組織也必須先登記 Event Streams 等候名單並取得預覽資格,才能正常建立事件串流訂閱。
2. AI 寫程式代理要怎麼知道可以使用 gh event listen?需要寫進提示詞嗎?
除了主動寫進專案開發規範或提示詞外,最新版的命令列工具本身已經內建引導機制。在 v2.105.0 以上版本中,當代理執行 gh pr create、gh pr view、gh run view、gh run watch 或 gh api 等常見指令時,輸出訊息會主動建議改用 gh event listen 來替代輪詢等待。
3. 設定團隊預設 Copilot 外掛後,成員如果不想用其中某一個可以關掉嗎?
可以,前提是組織或企業政策沒有把該外掛設定為強制啟用。GitHub 將團隊預設外掛定位為共享的起跑點而非強制鎖死,只要上位安全政策許可,開發者仍可在自己的 VS Code、GitHub Copilot App 或 Copilot CLI 裡個別切換開關。
4. 子團隊會自動套用母團隊設定的 Copilot 預設外掛嗎?
不會。根據 GitHub 官方說明,團隊預設外掛只會對該團隊的「直接成員」生效,子團隊成員不會自動繼承這些外掛設定,如果子團隊需要相同的外掛配置,必須由該子團隊的維護者另行設定。
5. gh event listen 的預覽資格該怎麼申請?
目前 GitHub Event Streams 正在 GitHub.com 進行預覽測試,開發者或組織管理員可以前往官方的 Event Streams 等候名單頁面登記申請。一旦帳號取得預覽權限並將本機 GitHub CLI 升級至 v2.105.0 以上版本,就能立即使用 gh event listen 與 gh event subscription 系列指令,或透過 gh event --help 查詢完整手冊,同時也可以在 GitHub Community 討論區回報實務使用上的建議與問題,協助官方團隊持續打磨事件串流體驗。
總結
GitHub 在 2026 年 11 月 18 日帶來的這兩項更新,分別從「自動化等待效率」與「團隊工具一致性」切入工程團隊的日常痛點。
在終端機端,gh event listen 用即時事件串流取代低效的迴圈輪詢,讓人類與 AI 代理都能用一行指令安靜等待 PR 審查與測試結果;在團隊管理端,共用 Copilot 外掛預設則在不削弱企業資安防線的前提下,大幅縮短團隊成員對齊工具鏈的設定時間。
如果你平常大量依賴命令列腳本或代理自動化流程,現在就可以將本機 gh 更新到 v2.105.0 以上並申請 Event Streams 預覽資格;若你是 Copilot Business 或 Enterprise 的團隊負責人,也不妨立刻前往團隊頁面的 Customize Copilot 分頁,替團隊建立第一份共用的外掛標準清單。