Подробное описание Agent Plugins 1.0: переносимый стандарт для навыков и MCP-серверов между ИИ-агентами

Название: Приветствие
Описание: Поприветствовать пользователя и предложить помощь.

Кратко поприветствовать пользователя и спросить, чем можно помочь.

### Шаг 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	Определяет коммуникацию между ИИ-клиентом и внешними инструментами/серверами данных
Агентные плагины	Определяют, как упаковывать навыки и MCP-конфигурации в переносимом виде

Полезная ментальная модель:

Навыки
= что агент должен знать или как он должен работать

MCP
= как агент подключается к внешним возможностям

Агентные плагины
= как эти переиспользуемые части упаковываются для совместимых клиентов

Таким образом, агентные плагины — это слой поверх существующих стандартов компонентов, а не их замена.

Что агентные плагины не решают

Область действия стандарта намеренно узкая.

Он не решает все проблемы межклиентской совместимости.

Он не стандартизирует

модели

Один и тот же плагин может вести себя по-разному при загрузке в разные модели.

Он не унифицирует интерфейсы разрешений

Один клиент может запрашивать подтверждение перед действием, а другой использовать политику на уровне рабочей области.

Он не унифицирует аутентификацию

OAuth и хранилища учётных данных остаются под управлением клиента.

Он не гарантирует поддержку всех MCP-транспортов

Клиенты могут реализовывать разные подмножества.

Он не унифицирует хуки или команды в v1

Они остаются на усмотрение клиента.

Он не создаёт единый маркетплейс приложений

Распространение остаётся за пределами основной спецификации.

Он не изолирует MCP-процессы в песочнице

Включение пути пакета не означает изоляцию во время выполнения.

Он не гарантирует полностью идентичное поведение

Переносимость означает, что клиенты могут обнаруживать и загружать компоненты по общему контракту. Это не означает, что каждая агентная среда будет рассуждать о компоненте или вызывать его совершенно одинаково.

Вопросы безопасности для авторов плагинов

Переносимые плагины могут расширить охват распространения.

Это также повышает важность безопасных настроек по умолчанию.

Не встраивайте конфиденциальную информацию

Избегайте размещения учётных данных в следующих местах:

plugin.json
заголовок mcp.json
значения переменных окружения в mcp.json
упакованные файлы

Используйте аутентификацию, управляемую клиентом.

Ограничивайте пути пакета

Не полагайтесь на выход за пределы корневого каталога плагина для доступа к произвольным файлам хоста.

Относитесь к локальным MCP-серверам как к исполняемому коду

Серверы stdio могут запускать процессы.

Пользователи и администраторы предприятий должны понимать, что они устанавливают.

Минимизируйте требуемые разрешения

Плагины, которым нужны только права на чтение, не должны запрашивать операции записи.

Фиксируйте внешние сервисы

У удалённых MCP-серверов должны быть чёткая принадлежность, политика конфиденциальности и использования данных.

Будьте осторожны с управлением версиями

Даже если структура каталогов остаётся действительной, изменения в поведении сервера могут считаться критическими изменениями.

Что разработчикам делать сейчас

Шаг 1: Разделите переносимые и клиент-специфичные части

Определите, какие части вашего текущего плагина действительно переиспользуемы:

навыки
MCP-серверы
общие метаданные

Перенесите поведение, характерное только для клиента, в соответствующие пространства имён расширений.

Шаг 2: Добавьте схему с версией

Явно укажите Agent Plugins 1.0.0 в plugin.json.

Шаг 3: Стандартизируйте размещение навыков

Помещайте переносимые навыки агента в:

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 — это открытый, нейтральный к поставщикам формат пакета для переиспользуемых расширений ИИ-агентов. Он стандартизирует, как размещать навыки агента и конфигурации 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-клиентами и серверами, упакованными через mcp.json.
• Плагины ChatGPT: текущая система плагинов OpenAI для рабочих процессов ChatGPT и Codex.
• Плагины агента VS Code: документация Microsoft по загрузке плагинов агента в VS Code.
• Плагины GitHub Copilot: документация GitHub о пакетах плагинов и поддержке открытой спецификации плагинов.

Связанные ссылки

• Спецификация Agent-плагинов 1.0.0: полные нормативные ограничения текущего переносимого формата.
• Создание Agent-плагинов: официальный минимальный учебник по плагинам и руководство по структуре пакетов.

org/compatible-clients): Текущая матрица поддержки для VS Code, Cursor, GitHub Copilot, ChatGPT и Codex, а также Kiro.

• Репозиторий спецификации плагинов агентов: публичные схемы, управление, вопросы, обсуждения и исходный код спецификации.
• Управление плагинами агентов: устав сообщества и нейтральные по отношению к поставщикам правила.
• Лицензия на плагины агентов: условия лицензирования спецификации, документации, схем и кода.
• Плагины OpenAI в ChatGPT и Codex: документация OpenAI уровня продукта о плагинах, приложениях, навыках и контроле рабочей области.

Резюме

Agent Plugins 1.0 решает реальную проблему в растущей экосистеме агентов: разработчики повторно упаковывают одни и те же навыки и интеграции MCP по-разному для каждого клиента.

Спецификация определяет небольшое переносимое ядро — обязательный plugin.json, навыки в каталоге skills/, конфигурацию MCP в mcp.json, правила упаковки, версионированную схему и расширения клиентов с пространствами имён. Распространение, маркетплейсы, разрешения, аутентификация и пользовательский интерфейс остаются под контролем клиента.

Проект заявляет о поддержке нескольких основных клиентов агентов, включая VS Code, Cursor, GitHub Copilot, ChatGPT и Codex, а также Kiro. Это делает его не только форматом плагинов, специфичным для OpenAI, хотя OpenAI является одним из участвующих сопровождающих.

Версия 1.0.0 — текущий опубликованный контракт, хотя страница спецификации всё ещё помечает её как рабочий черновик. Разработчики могут внедрять её уже сейчас, но должны следить за публичными процессами управления и версионирования.

Основной сдвиг прост: разработчикам больше не нужно переписывать одни и те же расширения агентов для каждой платформы — вместо этого навыки и интеграции MCP можно рассматривать как переносимые компоненты с единой структурой пакета.