Agent Plugins 是 Agent Skills 的未來

Agent Plugins 是 Agent Skills 的未來 Agent Plugins 是一項開放、與供應商無關的標準，用來將 Agent Skills 以及它們所依賴的 MCP 伺服器封裝到同一個可攜式資料夾中，任何相容的客戶端都能載入。Google 將以 Core Maintainer 身分加入 Technical Steering Committee。發布文章涵蓋了公告內容，而規格則提供詳細資訊。以下是我們讓實際的 skill 採用這套標準後得到的心得。 Agent Skills 讓 Agent 能按需取得專業能力。它是一個由模型只在工作相符時才載入的指示資料夾，因此當你修正 CSS 錯誤時，context window 不會同時攜帶部署操作手冊。我們在 google/skills 程式庫，以及隨 Agents CLI 一起提供的七個 skill 中，都大量採用了這種方式。 Skills 始終沒有解決的是發佈與分發。 作者：@lavinigam，Google Cloud Developer Relations Engineer 展開畫面重點畫面標題為「Plugins are part of an ecosystem」，下方副標題為「Four independent layers」。左側標註「four independent layers」並以大括號涵蓋四個橫向長條區塊，每個區塊分為左側的動作標籤與右側的內容描述： Find it：Agentic Resource Discovery（底部帶有黃色裝飾線） Describe it：AI Catalog（底部帶有灰色裝飾線） Package it：Agent Plugins（藍色長條背景，搭配白色文字） Run it：MCP + Agent Skills（底部帶有綠色裝飾線） 最下方說明文字為「Adopting one never obligates you to the next」。 需要工具的 skill 會由兩個成品組成。指示放在 SKILL.md，工具則放在 MCP 伺服器中，但沒有任何東西能將兩者綁在一起。因此，綁定關係只能寫在 README 裡：把這個複製到這裡，再把那段 JSON 加到另一處，而且每個客戶端都要使用不同的片段。每個客戶端最後都自行發明 bundle 格式來解決這件事，於是作者只能先選一種格式，接著為下一種格式重新撰寫。 Agent Plugins 將這個封裝格式標準化。裡面的元件原本就具備可攜性。 當你的 skill 變成 plugin 後，會有以下變化；而且你其實已經完成了大部分工作： 你唯一缺少的那個檔案。你的資料夾結構本來就已經正確。 工具會和你的專業能力一起移動。mcp.json，以及能在移動後繼續運作的路徑。 元件會各自獨立失效。失效的伺服器不會拖垮你的 skill。 不需要分支，就能支援客戶端專屬行為。使用 extension namespace。 一個資料夾，所有客戶端都能使用。我們實際發布的內容，以及它真正能在哪裡執行。 你唯一缺少的那個檔案 如果你寫過 ADK skill，可以看看它目前的所在位置：skills//SKILL.md，底下再放 scripts/ / references/ / assets/。Agent Plugins 要求使用 skills//SKILL.md，並將該資料夾內部的內容交由 Agent Skills 規格處理。這是相同的樹狀結構。 以下是我們早已寫好的 skill，封裝時完全不需要修改： ` --- name: summarize-report description: Summarize a quarterly revenue report into an executive brief. Use when the user asks to summarize, condense, or brief a financial report. --- Summarize a revenue report Steps Fetch the report with the reports MCP server's fetch_report tool. Load references/house-style.md and follow its tone rules. Produce three sections: Headline, Numbers That Moved, Risks. Keep the brief under 300 words. Rules Never estimate a figure the report does not state. Quote every percentage with its comparison period. If a quarter is missing, say so rather than interpolating. ` 請注意 Steps 第 1 行的前提：MCP 伺服器必須正在執行。封裝要解決的正是這項相依性。 遷移只需要在根目錄新增一個檔案： `json { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "acme.reports" } ` 這兩個欄位都是必要欄位，而這就是最小需求。名稱長度必須介於 1 到 64 個字元之間，只能包含小寫英數字元、連字號和句點，且必須以英數字元開頭和結尾，也不能包含 -- 或 ...。因此 acme.reports 沒問題，但 My-Plugin、-start 和 has--double 都不符合規定。 準備好要發布，而不是只做測試時，manifest 也可以加入中繼資料。這個結構描述採封閉設計：只允許十個頂層欄位，不能有其他欄位（完整欄位參考）。 `json { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "acme.reports", "version": "1.2.0", "description": "Revenue reporting skills and the MCP server they call.", "author": { "name": "Acme Data", "url": "https://acme.example" }, "homepage": "https://acme.example/reports-plugin", "repository": "https://github.com/acme/reports-plugin", "license": "Apache-2.0", "keywords": ["reports", "finance", "bigquery"] } ` 這是十個欄位中的九個。最後一個是 extensions，用於放置客戶端專屬資料，稍後會再介紹。author 也可以選擇性加入 email。 version 應該使用 SemVer，license 則應該使用 SPDX；不過，如果字串格式不正確，客戶端不會因此拒絕你。JSON 型別錯誤則是另一回事：即使是選用欄位，該是字串的地方放了數字，也會造成致命錯誤。只有兩種結構描述違規不會造成致命錯誤：未知的頂層欄位，以及不是物件的 extensions 值。這兩者都會被回報並忽略，plugin 仍然可以載入。其他所有錯誤都是致命錯誤，客戶端會拒絕整個套件。 有一項規則常讓正在遷移大型 skill 程式庫的人踩雷。探索只會深入一層：客戶端會讀取 skills/ 的直接子資料夾，不會遞迴搜尋（探索規則）。如果你過去將 skill 分組放在分類資料夾中，那些 skill 在封裝後就會直接消失，而且不會有錯誤說明原因。 展開畫面重點畫面頂部標題：「You have already built most of one」 副標題：「A skill folder plus one manifest is a plugin」 左側方框內容：「Your skill folder」下方標示「skills/ + SKILL.md」，方框下方有綠色橫條。 中間有加號（+），接著是方框標示「plugin.json」，下方有黃色橫條。 右側有等號（=），接著是方框標示「An Agent Plugin」，下方有藍色橫條。 底部文字：「The migration is a single file.」…