AIFlowTime 最新文章列表
最新技巧與應用

· Agent Skills · 權限 · 工作流

技能可共用,權限不跟著走

GitHub 在 11 月 12 日說明,以 SKILL.md 為核心的目錄可以跨 agent 帶走,工具、憑證與權限仍由宿主提供。三個客戶端要各自打包。靜態 diff 檢查不執行程式。這和本站的 Quick 週報技能不是同一篇操作。

GitHub Blog 這篇文章的主視覺:Mona 走在粉綠藍的像素路徑上。這是裝飾插圖,不是技能設定畫面。
圖片來源:GitHub

Andrea Griffiths 在 GitHub Blog 標的日期是 2026 年 11 月 12 日。文章寫,這個題目她在 GitHub Universe 2026 和 Procore 的 Shishir Tewari 一起講過。Tewari 的職稱是 Senior Manager, Data Engineering。這是一份實作指南,不是 11 月 14 日才發明的技能規格,也不是當天新上線的產品。

本文沒有把指南安裝到 Claude Code、Cursor 或 GitHub Copilot,也沒有使用任何真實倉庫的憑證或清單。

本站已有 把例行工作存成 Quick 技能。那篇是 AWS Quick 裡怎麼寫週報、測試、發布與分享。這篇不重寫那些點擊。這裡看的是:目錄可以帶走,工具、模型、專案脈絡、憑證與權限留在宿主。

十一月十二日的指南

文章署名:Andrea Griffiths,日期 November 12, 2026。
圖片來源:GitHub

標題是 “Build once, run on any agent”。正文第一段同時寫:指示可以跨 agent 分享,環境仍要提供工具、憑證與權限,技能才做得到那些事。

any agent 是標題與分享範圍的說法。它不是「每一個 agent 拿到同一個資料夾,都不用改就能跑」。文章後面也寫,客戶端的模型、工具、憑證與權限可以不相同。

技能不帶宿主的權限

指南定義:技能是以 SKILL.md 為核心的有版本目錄;它可以描述怎麼查資料庫,但不會因此授予資料庫權限。
圖片來源:GitHub

技能是一個有版本的目錄,核心是 SKILL.md。指南寫它說明 when and how,也寫技能最好有清楚的工作、輸入與輸出。文末要你寫下它需要什麼、在哪裡停、審閱者看到什麼。這些是說明文字。目錄不會因此取得宿主的工具、憑證或權限。

它可以描述怎麼查詢資料庫。那份描述不會因此取得資料庫的存取。工具、憑證與權限仍要由當時的環境提供。模型與專案脈絡也是宿主的事,不是目錄裡附帶的授權。

規則、清單、路徑分開

指南用 Data Forge 舉例:共同判斷放在技能,專案名稱、儲存與平台放在一份 manifest。相關技能再共用一條資料平台路徑。下面的圖與空表都是示例。空表是本文為了對照分法而寫的,不是一份能安裝的檔,也不是讀者的倉庫。

指南的示例清單:專案名稱 support-desk,引擎 duckdb,管線 spark_python。
圖片來源:GitHub

圖上的 support-desk、duckdb、spark_python 是指南自己的 support-desk 示例。指南寫,清單可以選擇引擎,但不能安裝 DuckDB 的命令列工具,也不能授予資料庫權限。那兩件事仍是環境與使用者的設定。清單選引擎,宿主提供存取。

指南還寫,forge-dbx 這份技能讀同一份清單,再選 Databricks 或 DuckDB 的 adapter,讓其他技能不用各自再寫一套連線。本文沒有跑過這條路徑。

發現到的專案細節,和團隊標準要分開。指南說,倉庫裡看到的模式不會自動變成必須保留的規則;需要業務判斷的地方,要讓人確認或改掉。

下面這張表是編輯示例。名稱是假的,沒有憑證、沒有真實路徑、沒有帳號。

放在哪裡 編輯示例放什麼
技能 週會紀錄裡,什麼句子算決定,什麼要標成未決;紀錄打不開就停止
清單 專案的顯示名稱、欄位名稱
宿主 模型、工具、憑證、權限,以及實際打得開的資料

可以照這個順序整理。整理完仍要在你自己的客戶端檢查,不是存檔之後就會生效。

  1. 選一件經常重複、輸入與輸出都說得清楚的工作。
  2. 共同判斷寫進技能。
  3. 專案名稱、欄位與資料位置寫進清單。
  4. 相關技能走同一條讀取路徑。
  5. 依客戶端分別打包。
  6. 檢查客戶端認不認得出技能、會不會載入 references、能不能用到需要的工具、交出來的結果有沒有證據。

第 6 步是指南寫的檢查,不是本文做過的跨平台測試。

三個客戶端分開打包

指南的打包句:以 skills 目錄為來源,分別產生 Claude Code、Cursor 與 GitHub Copilot 的檔案。
圖片來源:GitHub

指南把 skills/*/SKILL.md 當作來源,用 packaging script 產生客戶端自己的檔:

客戶端 指南寫的路徑
Claude Code .claude-plugin/plugin.json
Cursor .cursor-plugin/plugin.json
GitHub Copilot .github/agents/*.agent.md

這三條路徑不相同。指南沒有說每一個 agent 都吃同一條路徑。文章也寫了檢查模式:node scripts/package.mjs --check。那是示例裡的指令。本文沒有執行它。

裝好之後,指南要你看四件事:客戶端在預定任務裡認得出這份技能、載入它的 references、用得到需要的工具、交回技能要求的證據。本文沒有做這四項測試。

驗證只拿要求與差異

指南的 Proof Agent:verifier 只拿原始要求與程式差異,要附變更檔證據;Action 不執行程式、不跑測試。
圖片來源:GitHub

Proof Agent 的示例用另一個 verifier。GitHub Action 給它原始要求與程式差異,不給寫程式那個 agent 的自我評估。結果是 PASS、FAIL 或 PARTIAL,而且要引用變更檔裡的證據。

這個 Action 做的是靜態 diff review。它不執行程式,也不跑測試。

示例把 block-on-fail 設成 false,那些發現是建議性的。指南接著寫:預設情況下,FAIL 會讓這項檢查失敗;若倉庫規則把這項檢查設成必要,才會擋住合併。測試結果與合併條件,要放在倉庫自己的 CI 與規則裡。

指南裡「先核准」是寫給工作流程的指示。它不會因此變成權限系統已經擋下。要擋合併或部署,仍要在倉庫規則裡把該檢查設成必要。

自評不能代替獨立檢查

指南把這句放在 Proof Agent 的中心:self-verification is not verification。
圖片來源:GitHub

指南把 “self-verification is not verification” 放在 Proof Agent 的中心。這是作者的方法:不要讓寫程式的同一份說明充當驗證。它不是一份科學證明,也不能推出「換一個 agent 就一定正確」。判定仍要有變更檔上的證據。上一節的 PASS、FAIL、PARTIAL 都要附那些證據。

五種情況改做成應用

指南寫:需要穩定介面、共享狀態、audit trail、長時間控制,或在模型之外強制權限時,做成應用更合適。
圖片來源:GitHub

指南寫,技能適合有邊界、可重複、能重用判斷的工作,例如清單、發布、遷移或指標管線。若工作需要穩定介面、共享狀態、audit trail、長時間控制,或在模型之外強制權限,做成應用更合適。

這五種情況是作者建議改做應用的理由,不是本文量過的門檻。

和 Quick 那篇分開看。Quick 文是在一個產品裡建立技能、測試、發布,再分享給人或群組。這篇是目錄可攜、清單與技能分開、三個客戶端各自打包,以及驗證與權限的邊界。兩篇都沒有宣稱已經替讀者跑過一套自動化。

想成為 AI 高手?即刻搵 Jacob
看更多最新文章