← 返回首页

Agent Plugins 1.0 解説：AIエージェント間でのスキルとMCPサーバーのポータブル標準

名前：greet 説明：ユーザーに挨拶し、支援を提供します。 --- ユーザーに簡単に挨拶し、どのように支援できるかを尋ねます。プラグインにツールが必要な場合は、次を追加してください：プレーンテキスト mcp.json プラグインが必要です

发布于 2026年8月7日•general•GEO 评分: 0•8 次阅读

选择语言

العربيةDeutschEnglishEspañolFrançaisItaliano日本語한국어PortuguêsРусский中文
画像は「Agent Plugins 1.0 Explained」のプロモーション画像で、背景はダークカラーです。上部には「AGENT PLUGINS」のロゴがあります。左側には「AI AGENTS」があり、ChatGPT、Claude、Geminiなどが列挙されています。右側には「MCP SERVERS」があり、Files、Databaseなどのオプションがあります。中央には「AGENT PLUGINS 1.0」が強調表示され、その下のテキストは「A Portable Standard for Skills and MCP Servers Across AI Agents」です。下部には「Skills (Plugins)」タグがあり、Search、Code Runner、Data Analysis、Web Scraperなどのスキルアイコンが含まれています。この画像は、ドキュメントで紹介されているAgent Plugins 1.0の内容に合致し、その概念と応用を直感的に示しています。

名称：挨拶
説明：ユーザーに挨拶し、支援を提供する。

ユーザーに簡単に挨拶し、どのように支援できるかを尋ねます。


### 第4步：仅在需要时添加MCP

如果插件需要工具，请添加：

```Plaintext
mcp.json

插件仅仅为了有效而配置空的MCP并非必需。

缺少可选的组件位置不会被视作错误。

第5步：在兼容的客户端中测试

在您计划支持的每个客户端中测试便携式核心。

不要假设“代理插件兼容”意味着每个组件和传输方式都已实现。

客户端可以逐步采用组件。

带本地MCP服务器的插件示例

一个更有用的包可能如下所示：

reporting-plugin/
├── plugin.json
├── skills/
│   └── weekly-report/
│       └── SKILL.md
├── mcp.json
└── bin/
    └── reporting-server

清单：

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "reporting-plugin",
  "version": "1.0.0",
  "description": "便携式报告工作流程和工具。"
}

MCP配置：

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
  "mcpServers": {
    "reporting": {
      "type": "stdio",
      "command": "./bin/reporting-server",
      "cwd": "${PLUGIN_ROOT}"
    }
  }
}

一个符合标准的客户端可以发现：

  • 插件身份
  • 周报技能
  • 报告MCP服务器

无需作者为每个客户端将这些便携式组件放置在完全不同的结构中。

错误隔离使插件更具弹性

规范中一个深思熟虑的部分是，许多组件故障是局部性的，而不是灾难性的。

例如：

  • 无效的技能可以被跳过，而其他技能继续加载。
  • 一个无效的MCP服务器条目不一定禁用所有服务器。
  • 失败的MCP连接不应阻止独立的技能加载。
  • 客户端可以忽略不支持的组件类型。

这在真实的跨客户端生态系统中至关重要。

一个插件可以提供：

技能 A
技能 B
MCP服务器 A
MCP服务器 B
客户端扩展

如果某个客户端不支持特定的传输方式，在可能的情况下，有用的便携式其余部分仍应能正常工作。

否则，互操作性将变得脆弱：一个不受支持的可选功能将禁用整个插件。

符合标准的客户端可以逐步采用该标准

客户端不需要实现v1中的每个功能。

仅支持技能的客户端如果正确加载清单并实现相关技能行为，仍然可以符合标准。

支持MCP的客户端必须满足适用的传输规则。

这种增量模式降低了采用门槛。

较小的客户端可以从以下开始：

plugin.json
+
skills/

并在以后添加MCP。

较大的客户端可以实现完整的便携式核心以及自己的扩展命名空间。

该项目由社区治理，而非单一供应商控制

AIBase的标题描述的是OpenAI引入代理插件。

OpenAI显然是重要的参与者。

官方治理文件使所有权模式更加广泛。

代理插件自称是

作为一个由社区治理、供应商中立的项目。

其技术指导委员会由独立的核心维护者组成，而非预留企业席位。

章程规定：

  • 任何单一供应商不得控制核心维护者席位的多数。
  • 技术提案和讨论是公开的。
  • 项目参与按照明文规则开放。
  • 规范和文档材料默认使用 CC BY 4.0。
  • 模式、代码和软件材料默认使用 Apache 2.0。

项目主页目前列出的初始核心维护者代表来自：

  • Amazon
  • Cursor
  • Microsoft
  • OpenAI
  • Vercel

这种多供应商结构之所以重要，是因为当竞争性客户端有参与路径时，互操作性标准更具可信度。

该标准已有多个兼容客户端

官方兼容性页面目前列出：

  • VS Code
  • Cursor
  • GitHub Copilot
  • ChatGPT 与 Codex
  • Kiro

这比一个仅由其原作者支持的标准有更强的起点。

支持矩阵仍不完全相同。

例如，当前页面列出的几个客户端支持传统 SSE，而 ChatGPT 与 Codex 目前列出 stdio 和 Streamable HTTP。

重要的结果是，该包格式已经跨越了供应商边界。

插件作者现在可以针对一个共享核心，而不必假设每个代理环境都是一个完全独立的生态系统。

为什么随着代理成为长期运行系统，这一点更加重要

当代理执行实际工作时，插件碎片化问题更为突出。

一个简单的聊天机器人可以依靠小型固定工具列表运行。

一个严肃的代理可能需要：

  • 公司特定流程
  • 数据库访问
  • 浏览器自动化
  • 部署工具
  • 安全检查
  • 文档工作流
  • 可复用的领域指令
  • 专用脚本
  • 多个 MCP 服务

随着这些组件成倍增加，可移植性成为基础设施。

如果没有共享打包机制，每家公司都面临维护这样一个矩阵的风险：

能力 × 代理客户端 × 版本 × 平台

可移植的包格式减少了该矩阵的一个维度。

它并不能消除客户端特定的工作。

但它可以减少为保持可复用核心一致而需要的重复工作量。

代理插件、MCP 和代理技能解决不同的问题

这三个概念相关，但不应混为一谈。

标准 主要作用
代理技能 定义可复用的代理指令/工作流资产
MCP 定义 AI 客户端与外部工具/数据服务器之间的通信
代理插件 定义如何将技能和 MCP 配置以可移植方式打包在一起

一个有用的心智模型是：

技能
= 代理应该知道什么或应该如何工作

MCP
= 代理如何连接到外部能力

代理插件
= 这些可复用部分如何打包以适配兼容客户端

因此，代理插件是位于现有组件标准之上的一层，而非其替代品。

代理插件不解决什么

该标准的范围刻意保持狭窄。

它并不解决所有跨代理兼容性问题。

它不标准化

模型

同一个插件在不同的模型加载时，行为可能会有所不同。

它不统一权限界面

一个客户端可能在执行操作前要求确认，而另一个客户端则使用工作区级策略。

它不统一身份验证

OAuth 和凭据存储仍由客户端管理。

它不保证支持所有 MCP 传输方式

客户端可以实现不同的子集。

它在 v1 中不统一钩子或命令

这些仍由客户端自行定义。

它不创建统一的应用市场

分发仍不在核心规范范围之内。

它不沙箱化 MCP 进程

包路径的包含并不等同于运行时隔离。

它不保证行为完全一致

可移植性意味着客户端可以根据共享契约发现并加载组件。这并不意味着每个代理运行时都会以完全相同的方式推理或调用该组件。

插件作者的安全注意事项

可移植的插件可以扩大分发范围。

这也增加了安全默认配置的重要性。

機密情報を埋め込まない

以下の場所に認証情報を保管しないでください：

plugin.json
mcp.json ヘッダー
mcp.json 環境変数の値
パッケージ化されたファイル

クライアントが管理する認証を使用してください。

パッケージパスを制限する

プラグインのルートディレクトリの外に依存して任意のホストファイルにアクセスしないでください。

ローカルMCPサーバーを実行可能コードとして扱う

stdio サーバーはプロセスを起動できます。

ユーザーと企業管理者は、インストールする内容を理解する必要があります。

必要な権限を最小限にする

読み取り専用のプラグインは、書き込み操作を要求すべきではありません。

外部サービスを文書化する

リモートMCPサーバーには、明確な所有権、プライバシー、およびデータ使用ポリシーが必要です。

バージョン管理には注意する

ディレクトリ構造が有効なままであっても、サーバーの動作の変更は破壊的な変更となる可能性があります。

開発者が今すぐ行うべきこと

ステップ1：ポータブルな部分とクライアント固有の部分を区別する

現在のプラグインのどの部分が本当に再利用可能かを特定します：

スキル
MCPサーバー
共有メタデータ

クライアント固有の動作は、対応する拡張名前空間に移行します。

ステップ2：バージョン付きスキーマを追加する

plugin.json で Agent Plugins 1.0.0 を明示的に宣言します。

ステップ3：スキルの配置場所を標準化する

ポータブルなAgentスキルを以下の場所に配置します：

skills/<スキル名>/SKILL.md

ステップ4：MCP設定を標準化する

ルートレベルのファイルを使用します：

mcp.json

クライアントネイティブの設定ファイルのみに依存しないでください。

ステップ5：ポータブルな機密情報を削除する

認証情報を各クライアントの認証システムに移行します。

ステップ6：複数のクライアントでパッケージをテストする

相互運用性は、想定ではなく実際のデモンストレーションによって検証する必要があります。

ステップ7：仕様の更新を追跡する

現在の仕様はまだワーキングドラフトとしてマークされているため、プロジェクトリポジトリ、ディスカッション、スキーマ、および互換性ページの変更に注目してください。

確認済みの内容とさらなる説明が必要な内容

宣言 ステータス
Agent Plugins 仕様 1.0.0 が公開された 確認済み
この仕様はポータブルなスキルとMCPサーバーのパッケージング方法を定義する 確認済み
ルートの plugin.json が必須である 確認済み
skills/ が固定のスキル配置場所である 確認済み
ルートの mcp.json がMCP構成の配置場所である 確認済み
stdio と Streamable HTTP が標準のMCPトランスポートタイプである 確認済み
従来のSSEは認識されるが、クライアントにとってはオプションである 確認済み
クライアント固有の拡張機能は逆ドメイン名名前空間を使用する 確認済み
配布、インストール、権限、およびユーザーエクスペリエンスは標準化されている いいえ。意図的に範囲外
フックはポータブルなAgent Plugins v1 コンポーネントである いいえ。クライアント拡張機能にできる
OpenAI が Agent Plugins を独占的に所有または管理している いいえ
このプロジェクトはベンダーに中立でコミュニティによって運営されている 公式ガバナンスにより確認済み
1.0.0 は完全に凍結された最終標準である いいえ。仕様ページは現在ワーキングドラフトと表示されている
すべての互換クライアントがすべてのコンポーネントとMCPトランスポートをサポートする いいえ
ChatGPT、Codex、VS Code、Cursor、GitHub Copilot、Kiro が互換としてリストされている 現在の互換性ページで確認済み

よくある質問

Agent Plugins 1.0 とは何ですか？

Agent Plugins 1.0 は、再利用可能なAIエージェント拡張機能のためのオープンでベンダーに中立なパッケージ形式です。Agent Skills と MCP サーバー設定をポータブルなプラグインディレクトリに配置する方法を標準化します。

Agent Plugins は OpenAI 限定の標準ですか？

いいえ。OpenAI はこのプロジェクトに参加し、ChatGPT と Codex でこの形式をサポートしていますが、公式プロジェクトはコミュニティによって運営され、ベンダーに中立です。初期のコアメンテナーチームには、Amazon、Cursor、Microsoft、OpenAI、Vercel に関連する人々が含まれています。

Agent Plugin にはどのファイルが必要ですか？

各プラグインにはルートの plugin.json が必要です。スキルは skills/ に保存でき、MCP サーバーはルートの mcp.json で記述できます。クライアント固有の機能には名前空間拡張機能を使用できます。

Agent Plugins は MCP を置き換えますか？

いいえ。MCP は引き続きクライアントと MCP サーバー間のプロトコルを定義します。Agent Plugins は、MCP サーバー設定と他の再利用可能なエージェントコンポーネントをパッケージ化するためのポータブルな方法を定義します。

フックは Agent Plugins 1.0 の一部ですか？

ポータブルなコアコンポーネントとしては、いいえ。バージョン1はスキルとMCPサーバーを標準化します。フックは、サポートされている場所ではクライアント固有の拡張名前空間を通じて実装できます。

どのクライアントが Agent Plugins をサポートしていますか？

公式の互換性ページには現在、VS Code、Cursor、GitHub Copilot、ChatGPT と Codex、および Kiro がリストされています。サポートされるMCPトランスポートは異なるため、作成者はライブマトリックスを確認する必要があります。

Agent Plugin はすべてのクライアントで同じように動作しますか？

いいえ。この標準はパッケージの発見とポータブルコンポーネントを対象としており、モデル、権限インターフェース、認証フロー、マーケットプレイス、またはクライアント固有のランタイム動作には対応していません。プラグインはポータブルであっても、同じ実行動作を保証するものではありません。

Agent Plugins 1.0 は最終版と見なされますか？

1.0.0 は現在公開されているバージョンで、標準的なパターンを提供します。仕様ページは現在、プロジェクトのステータスを「ワーキングドラフト」と表示しているため、開発者は公開されたガバナンスとバージョン管理プロセスを引き続き監視する必要があります。

関連ツール

  • Agent Plugins：ポータブルなAgent Pluginsパッケージの公式ドキュメントサイト。
  • Agent Skills：Agentプラグインで再利用可能なスキルコンポーネントのためのオープン仕様。
  • Model Context Protocol：mcp.json でパッケージ化されたMCPクライアントとサーバーが使用するプロトコル。
  • ChatGPTプラグイン：OpenAIが現在ChatGPTとCodexワークフローで使用しているプラグインシステム。
  • VS Code Agentプラグイン：VS CodeでAgentプラグインを読み込むためのMicrosoftのドキュメント。
  • GitHub Copilotプラグイン：GitHubのプラグインパッケージとオープンプラグイン仕様サポートに関するドキュメント。

関連リンク

まとめ

Agent プラグイン 1.0 は、拡大を続ける Agent エコシステムにおける実際の課題を解決します。開発者が同じスキルと MCP 統合をクライアントごとに異なる方法で繰り返しパッケージングしているという問題です。

この仕様は、小型でポータブルなコアを定義します。必須の plugin.json、skills/ ディレクトリ内のスキル、mcp.json 内の MCP 設定、パッケージラッピングルール、バージョン管理されたスキーマ、名前空間付きクライアント拡張です。配布、マーケットプレイス、権限、認証、ユーザーインターフェースは引き続きクライアントが制御します。

このプロジェクトは、VS Code、Cursor、GitHub Copilot、ChatGPT と Codex、Kiro を含む複数の主要 Agent クライアントのサポートをリストアップしています。これにより、OpenAI がメンテナの一つであるものの、これは単なる OpenAI 固有のプラグイン形式ではありません。

バージョン 1.0.0 が現在リリースされているコントラクトですが、仕様ページは依然としてワーキングドラフトとしてマークされています。開発者は今すぐ採用できますが、公開されているガバナンスとバージョン管理プロセスを追跡する必要があります。

主な転換はシンプルです。開発者は各プラットフォーム向けに同じ Agent 拡張を書き直す代わりに、スキルと MCP 統合を統一されたパッケージ構造を持つポータブルなコンポーネントとして扱うことができます。