AI 工作實務
GitHub Copilot 審查可用 API 管理:Skills、MCP 與政策來源怎麼追溯?
GitHub 新增 Copilot code review API 管理與來源歸屬資訊。核對企業、組織與儲存庫權限差異,建立能追溯 Skills、MCP、人工決定與測試結果的審查紀錄。

GitHub 2026 年 11 月 6 日更新 Copilot code review,讓企業、組織及 Repository 管理者可以透過 REST 與 GraphQL API 管理部分審查設定,並取得評論所回報使用的 Skills、MCP servers 與自訂指令等來源資訊。這項改變值得關注,但有來源標示不等於完成獨立稽核,更不能取代人工審查與程式測試。
專題編輯:Iris Hsieh · 資料截止 2026.11.08

一、程式審查正從「按一個按鈕」走向跨組織的管理制度
企業最早導入 AI 程式審查時,常把它當成拉高程式碼品質的一項新工具。工程師建立 Pull Request,邀請 AI 提出問題,接著由人工判斷是否修改。當專案只有一兩個儲存庫,這個做法很直覺;但在大型企業裡,不同組織、不同專案甚至不同分支都有不同安全要求,若沒有一致設定與可追溯結果,審查流程容易變成各做各的。
GitHub 的新公告指出,Copilot code review 現在可以透過 REST 與 GraphQL API 管理部分設定,從 Enterprise 政策延伸到 Organization 和 Repository;評論結果也加入更明確的歸屬資訊,能辨認 Copilot 的審查及評論、在有該資料時讀取審查努力程度,並查看 Copilot 回報其評論使用哪些 Skills、MCP server 或 custom instructions 作為資訊來源。
這改變了企業治理的可行性。以前管理者可能需要逐一檢查各儲存庫的網頁設定,現在部分條件可以納入自動化盤點與政策比較。更重要的是,當 AI 留下一則程式碼建議,管理者有機會知道哪些團隊規範或外部上下文曾被帶入該評論,進一步理解審查依據是否符合預期。
但這項能力仍然有邊界。API 能讀取或設定某些政策,不代表企業可以用一條指令完整設定 GitHub 上所有與程式碼治理相關的功能;評論有來源標示,也不意味 AI 真正理解了所有來源、完成全數檢查,或產出的判斷必然正確。
二、政策分三層:Enterprise、Organization、Repository 不能混成一份設定表
依 GitHub 公告,企業管理者可在 Enterprise 層啟用或停用程式審查,或交由各組織自行決定。組織管理者在上級政策允許範圍內,可以控制審查是否啟用、預設 review effort,以及 runner 設定;若某項設定由上級 Enterprise 管理,下級便不能覆蓋。Repository 管理者則可調整審查努力程度,以及是否使用自訂指令與 MCP 工具。
因此,導入自動化之前應先建立一份「設定優先順序」表。對每個功能標出擁有者、可設定層級、上級是否鎖定、API 能否讀取、API 能否寫入、例外如何審核。例如同一組織內有高風險金融系統、內部測試工具與公開說明文件,可能需要不同的 review effort 和資料存取限制,但某些最低安全要求應由上級政策統一維持。
如果資訊部門只寫一支批次腳本,把所有儲存庫設定成同一模式,可能破壞原本合理的權限分工。較佳做法是先讀取現況,產生差異報告,由政策擁有者核准,再對可被下級調整的範圍進行修改。修改後保留前後設定快照,遇到問題才能回復,並知道設定是何時、由誰、因什麼理由改變。
GitHub 也說明了 API 認證限制。Enterprise 和 Organization 設定端點,以及 Organization runner 端點,不支援 GitHub Apps 或 fine-grained personal access tokens;Repository 設定端點則支援相關方式,但讀取及寫入需要適當的 Administration 權限,classic PAT 也須符合 Repository 管理權限條件。這是實際部署前必須核對的權限契約,而非單純的 API 實作細節。
三、Skills、MCP 與自訂指令各自提供什麼,誰負責維護?
Copilot code review 可以使用儲存庫中的 Agent Skills、自訂指令,以及連接外部系統的 MCP servers。三者的作用並不完全相同。自訂指令適合描述穩定的程式撰寫原則與審查要求;Skills 可以將特定工作程序、檢查要點與工具整合整理成可複用能力;MCP 則可在適當授權範圍內提供外部文件、議題追蹤或服務目錄等上下文。
GitHub 的文件說明,Repository 可用 .github/copilot-instructions.md 描述整體規範,以 AGENTS.md 交代專案架構與開發背景,亦可在 .github/skills 中設置和審查相關的 Skills。MCP servers 則須在可用的 Repository 設定中配置。不同機制能提升上下文品質,也同時帶來維護責任:文件可能過時、外部系統資料可能有權限限制,Skill 自身可能出現過度寬鬆或和組織政策牴觸的指令。
對企業來說,重點不是把所有文件、MCP 工具都接上去,而是讓每個來源有身份、有版本、有維護人、有適用範圍。若某個 Skill 描述已經適用舊架構,審查模型即使正確讀取這份 Skill,也可能提出不合時宜的建議。這不是 AI 是否聰明就能獨力解決的問題,而是知識治理問題。
此外,GitHub 早前公告,Copilot code review 的 MCP 工具呼叫限制為唯讀。這降低了審查時由外部連接器直接修改資料的風險,但唯讀並不等於沒有風險。工具仍可能回傳敏感資訊、過時文件或經第三方控制的惡意內容;因此,企業仍需規劃資料範圍、來源信任和輸入內容的處理規則。
四、有 Attribution 就等於可以稽核嗎?需要分辨三種證據深度
第一種是結果可辨識。審查留言可以辨識為 Copilot 產生,且某些欄位能回報 review effort 與資訊來源。這有助於記錄「誰做了評論、當時有什麼設定」。第二種是過程可追溯,例如能透過可用的審查 session logs 或相關紀錄,查看呼叫了哪些 MCP 工具、接收哪些上下文、是否有失敗。第三種才是判斷可驗證,也就是人類能根據程式碼、測試及證據確認審查結論合理。
這三種證據不能互相替代。若評論標示引用某個 Skill,最多只能說 Copilot 回報使用了該 Skill,不能因此認定 Skill 內容完整、引用版本符合規範,或 AI 的安全判斷已獲獨立確認。某些來源標註甚至可能因產品、存取權限、API 欄位或審查模式而有差異。正式稽核仍須確認特定資料是否真正在所需的審查範圍內被檢視。
企業可為 AI 審查建立一份最小證據包:PR 編號與 Commit SHA、程式碼差異、審查設定快照、AI 審查的時間與識別欄位、可用的來源歸屬、AI 建議內容、人工處置與後續測試結果。若某些項目無法取得,要註明「未提供」或「無權存取」,而非用空值推定流程已完成。
這種作法尤其適合高風險系統。金融交易、身分驗證、醫療資料或大量個資處理的程式碼,即使經 AI 審查,也應保留人工審批及必要安全測試。可追溯的目的不是替模型建立免責理由,而是讓企業知道一項判斷從何而來、由誰接受、若出錯如何追蹤和修正。
五、新版 Review Overview 更精簡,如何避免主管只看漂亮摘要?
GitHub 也調整了程式審查的概覽格式,將努力程度及部分回饋資訊移到更精簡的位置,未審查的檔案集中在 Files not reviewed 類別,可能包含排除原因。這能改善閱讀體驗,但它也提醒管理者:審查摘要不是全量覆蓋證明。若某些檔案因規則、排除或其他限制未被檢視,不能把 PR 顯示完成審查直接當成「程式庫通過安全驗證」。
GitHub 同期更新了使用率資料 API,提供更細的程式審查評論處理率資訊。例如在可用的 repository-level 報表中,可以分辨哪些評論被評估、哪些被開發者採取行動,也可以依嚴重程度、評論型態和自訂來源類別切分。這些指標有助於管理者比較不同審查方式,但「有採取行動」也不是缺陷一定被修復的同義詞。
最具管理價值的方式,是抽查高風險評論從提出到解決的完整鏈路。假設 Copilot 指出一處輸入驗證問題,工程師可能選擇修改程式、補測試、在留言提出反證或列入後續工作。每一種處置都應有理由,並在必要時由指定人員確認結果。若只算已關閉的評論數,可能鼓勵團隊快速消除提示,而不是改善真正的缺陷。
六、如何把 Copilot Code Review 放入企業既有的 SDLC 治理?
建議把流程拆為五個關卡。需求關卡先定義功能與安全驗收條件;開發關卡使用對應的專案規範與 Skills;PR 關卡自動或按需啟動 Copilot review;人工關卡依風險處理 AI 建議並決定是否合併;部署關卡留存 CI、測試、變更記錄與回滾條件。這些關卡都不是新工具特有的制度,而是讓 AI 能被納入可管理的開發生命週期。
在具 GitHub Enterprise 的企業中,應由平台管理者制定最小政策基線,系統負責人管理專案特例,資安部門抽查高風險程式庫。對於大型跨團隊專案,也可以指定 Code Owners,配合既有 Branch Protection 與 PR 核准制度。AI 建議並不應被當成直接取代核准者的簽章,除非適用的制度及風險允許另行設計自動化流程。
導入初期,不宜一次把所有儲存庫自動升級成最高審查強度。不同成本、覆蓋率與團隊需求需要衡量。先挑 2 至 3 個可控專案,記錄既有審查時間與缺陷類型,再比較新流程是否能讓團隊更早發現問題,並檢查誤報與重工是否增加。這是建議的試驗設計,不代表 GitHub 已驗證某個通用最佳值。
七、給企業 IT 與資安部門的 API 管理落地清單
第一步,建立完整的 Enterprise、Organization、Repository 管理清單與實際權限,辨識哪些端點能透過目前憑證存取。第二步,將主要審查設定輸出為版本化快照;異動必須連結變更申請與核准紀錄。第三步,盤點自訂指令、Skills、MCP 的負責人和更新日期;資料來源涉及機密或客戶資料時建立明確存取範圍。
第四步,設立 PR 審查證據的最小保存規格,避免原始資料過度蒐集。第五步,挑選幾個既有缺陷或測試案例,評估 AI 提出建議的適切性、人工處置、誤報及漏報。第六步,在發布前確認所用 API 的認證限制,避免將不支援的 token 類型寫成部署預設;同時確認治理設計不會超越現有 GitHub 權限。
若沒有權限直接存取 Enterprise 設定,應先與管理員協作,而不是繞過政策或要求開發者提供個人權杖。越是想把審查流程自動化,越需要把最小權限、服務帳戶、憑證輪替與稽核紀錄規劃在最前面。這也是為什麼程式碼審查的治理不是只寫一份 Skill 就會完成。
八、真正有價值的下一步:從 AI 評語走到可驗收的工程事實
這次 GitHub 更新代表的方向,是把 AI 從個人輔助提升為可以被企業政策管理、可以部分追溯資訊來源的組織工具。然而任何 AI 審查工具都只是品質管理流程中的一個環節。程式是否正確、是否符合需求、權限是否安全、測試是否涵蓋異常流程,仍要以可重現的工程事實回答。
對主管而言,最該追問的不是「這個 Repository 有沒有開 Copilot review」,而是「哪些規則實際生效、哪些資料被使用、哪些檔案沒有審查、哪些建議被接受、修改之後如何證明問題已解決」。當這些問題有證據,AI 才從令人印象深刻的功能,成為可以持續使用的管理制度。
核心觀點:能透過 API 設定政策,是治理的起點;能把每則 AI 建議連回規範版本、人工決定和測試結果,才是可追溯的程式審查。
可複用的「AI 程式審查證據表」
建議欄位包括:Repository、PR、Commit SHA、review effort、政策來源層級、審查起訖時間、Skills/MCP/自訂指令來源、未審查檔案、評論分級、人工處置人、修正 Commit、測試結果及例外批准。不能取得的欄位標示不可取得,不以推定值填補;涉及安全資訊的紀錄按企業內部分類保存。
把自訂規範當作受控資產,而不是任何人都可改寫的提示詞
企業常把程式碼風格、例外處理與安全要求放進一份通用指令,但一旦審查工具會引用這些內容,指令檔就具備與程式碼設定相近的治理重要性。應為 .github/copilot-instructions.md、AGENTS.md、.github/skills 與相關 MCP 設定指派維護人,採版本控制和 PR 審查程序。對於不同專案共用的標準,應說明來源版本、適用範圍及失效條件。不能讓單一工程師在尚未審查的分支自行加入寬鬆的例外規定,便期待它成為可依賴的組織政策。
尤其要注意 GitHub 官方文件說明,Copilot 程式碼審查會參考待合併分支中的某些指令與 Skills。這意味審查規則本身也可能跟著 PR 改變。團隊要把「變更安全規則」與「變更應用程式」區分,要求對高風險規範異動進行額外人工確認,並在稽核時保留實際使用的 Commit SHA。單靠看到檔案名稱,無法知道某次審查讀到的是哪個版本。
MCP 來源管理則應加入外部系統所有權、資料分類、認證方式、工具清單、讀取權限、服務停用與逾時處理。即使工具呼叫為唯讀,取得資料的範圍仍需符合最小權限原則;若外部服務短暫不可用,審查流程應標記上下文缺漏,而不是讓沒有取得關鍵資料的 AI 評論看起來與完整審查相同。對嚴格法遵的團隊,這項限制應出現在證據包中。
最後,以季度演練確認制度不是紙上談兵:挑一個已知的程式缺陷,觀察自訂規範是否被正確引用、AI 是否提出可檢查的警示、人工審查能否辨認可能的誤報、修正後的測試是否會通過。演練要保留實際 PR 和測試紀錄,不以模型生成的摘要當作測試證據。這樣才能衡量制度是否有實際防護價值。
評估是否擴大部署的三個門檻
擴大 AI 程式碼審查之前,先確認三項門檻。第一,關鍵程式庫是否已有穩定的 Branch Protection、PR 流程與人工責任人;若沒有,AI 評論就很難被落實。第二,團隊是否能辨認評論的來源、缺失與不確定性;若只看審查完成的圖示,便容易高估覆蓋範圍。第三,產出的建議能否連結到實際修改、測試與部署回執;若只有大量評論而缺少修正證據,應先改善流程而非提高用量。
持續治理比一次設定更重要
當 Repository 新增外部 MCP 工具、Skill 升級或組織合併時,應重新檢查原本的政策假設是否仍成立。能在上線第一天通過稽核,不代表半年後仍符合權限與資料範圍要求。建議每季至少抽查重要儲存庫的設定差異,確認失效連結、維護人異動與例外批准是否已清理,並將抽查發現轉為具負責人和完成日期的改善任務。
來源與限制
- GitHub Changelog,2026 年 11 月 6 日,Copilot code review: API management and review overview updates:https://github.blog/changelog/2026-11-06-copilot-code-review-api-management-and-review-overview-updates/
- GitHub Docs,Configuring code review by GitHub Copilot:https://docs.github.com/en/copilot/how-tos/copilot-on-github/set-up-copilot/configure-code-review
- GitHub Changelog,2026 年 7 月,Agent skills and MCP generally available:https://github.blog/changelog/2026-07-31-copilot-code-review-agent-skills-and-mcp-now-generally-available/
- GitHub Changelog,2026 年 11 月 5 日,Usage metrics API:https://github.blog/changelog/2026-11-05-usage-metrics-api-adds-code-review-details-and-addressed-rate/
- GitHub Docs,Using GitHub Copilot code review:核對指令與 Skills 取自 PR head branch。
本文以 GitHub 公開文件為依據,未曾取得特定企業的程式碼、審查紀錄或內部 API 回應。所列審計資料表是管理建議,非官方保證所有欄位皆可在單一端點取得。封面為抽象流程插畫,非實際 GitHub 介面截圖。
延伸閱讀
內容提供:TARAISG。專題編輯為天地人 AI 虛擬角色;文章由 AI 產製及協助查核。封面為 AI 概念插畫,非新聞現場或產品操作畫面。本文未宣稱經具名人工或專業法律審核。
本文由 TARAISG(TIANDIREN AI SOLUTION GROUP)使用 AI 模型產生正文、整理來源並設計實務工具。方法依據與限制列於文末;案例為明確標示的教學假設。未有具名紀錄時,不宣稱經人工或專家審核。
查看內容製作與更正說明