Проверить пакет и результаты
Средства из исходного кода: команды agentplugins author требуют соответствующей сборки. В текущем установщике их нет. Запускайте относительные примеры из родительской папки пакета и каждый раз выбирайте один точный корень.
Выполните статический цикл без сети
agentplugins author validate ./review-helper
agentplugins author inspect ./review-helper
agentplugins author test ./review-helperValidate проверяет стандартную конфигурацию и готовность пакета. Inspect показывает компоненты и недостающие требования. test без параметров исполнения статически проверяет конфигурацию, гигиену, Skills и MCP. Эти команды не запускают серверы и не исполняют инструкции Skill.
Читайте уровни отдельно
| Уровень | Что подтверждает | Что требует отдельной проверки |
|---|---|---|
| Соответствие | Сохранённые стандартные данные соответствуют встроенной схеме и профилю. | Полезное поведение в конкретном агенте. |
| Безопасность хоста | Входные данные проходят ограниченные проверки путей и хоста. | Разрешение пользователя на установку и запуск. |
| Готовность | Доступные сведения удовлетворяют проверяемой политике. | Одобрение публичного выпуска и принятие платформой. |
| Совместимость | Статическую поддержку выбранных компонентов и клиентов. | Реальное обнаружение и активацию в клиенте. |
| Инструменты | Ограниченные сведения о проекте, нативных и исполняемых файлах. | Получение зависимостей и успешный запуск. |
| Исполнение | Явно выполненная MCP-проверка показывает наблюдённые этапы. | Другие инструменты, клиенты, OAuth и непроверенные окружения. |
Соответствие схеме и общая готовность — отдельные результаты. Корректный манифест может сочетаться с неполными данными о компонентах или хосте. Сохраняйте «не проверено» вместо превращения этого состояния в успех.
Явно выберите клиенты
agentplugins author compat ./review-helper --target codex,claude
agentplugins author inspect ./review-helper --target codex,claude
agentplugins author doctor ./review-helper
agentplugins author capabilitiescompat принимает разные ID через запятую, но не all. Статические проверки не требуют установленных клиентов. Doctor читает ограниченные нативные данные и метаданные исполняемых файлов без процессов и сети. Capabilities описывает схемы, метаданные клиентов и команды данной сборки. Это не сертификация пакета и не доказательство публичного выпуска.
Явно проверьте исполнение MCP
Локальное исполнение stdio сейчас требует Linux, системный bubblewrap и Node в системных каталогах. До запуска должны пройти проверки изоляции процессов (включая делегированную cgroup v2) и пространств имён bubblewrap. Подробнее — в требованиях stdio. Streamable HTTP не использует эту изоляцию локального процесса, но требует явного разрешения сети.
Для пакета из руководства stdio отдельно установите распознанные зависимости по lock-файлу, затем выберите точное имя сервера из mcp.json:
agentplugins author test ./local-tools --runtime mcp --server local-toolsКоманда запускает выбранный процесс и проверяет инициализацию и список инструментов. Для вызова нужны одновременно --tool и --fixture. Файл аргументов задаётся путём относительно пакета и содержит JSON-объект с аргументами инструмента. Для шаблонного hello создайте fixtures/hello.json с содержимым {}:
agentplugins author test ./local-tools --runtime mcp --server local-tools \
--tool hello --fixture fixtures/hello.jsonДля Streamable HTTP явно разрешите сеть:
agentplugins author test ./docs-service --runtime mcp --server docs-service \
--allow-networkИспользуйте реальное имя сервера из пакета. Срок проверки по умолчанию — десять секунд; --deadline задаёт положительную длительность не более минуты. Читайте инициализацию, обнаружение инструментов, необязательный вызов и завершение раздельно. Такой результат не является запуском через установленный агент и не доказывает OAuth, другие инструменты или публичное развёртывание.
Повторяйте цикл разработки
agentplugins author dev ./local-tools --server local-toolsdev выполняет ограниченные MCP-циклы при изменении пакета; для остановки используйте Ctrl+C. --once выполняет один цикл и обязателен для JSON-вывода. Удалённому серверу нужен --allow-network; вызову инструмента — явная пара имени и fixture. Команда не устанавливает пакет в нативный клиент.
Сохраните проверяемый отчёт
agentplugins author validate ./review-helper --format json
agentplugins author inspect ./review-helper --format jsonДля обычного вывода есть --format human, для отключения цвета — --no-color. --include-root раскрывает выбранный корень: не передавайте ненужные закрытые пути. --release-policy добавляет ограниченные проверки качества выпуска, но не даёт разрешение на публикацию. У Skills меньше параметров; изучайте справку конкретной подкоманды.
Осознанно изменяйте JSON
Текущий исходный код планирует детерминированную нормализацию одного стандартного файла и записывает его только с --write:
agentplugins author normalize ./review-helper --document plugin.json
agentplugins author normalize ./review-helper --document plugin.json --writeВыберите mcp.json, если нужен именно он. Нативный импорт читает один явно указанный строгий JSON-файл Claude MCP, без поиска профилей. Импортируются только безопасные stdio-записи с command и необязательным args. HTTP/URL, env и дополнительные поля сервера пропускаются, даже если исходный клиент их принимает. Сначала проверьте план для нового отсутствующего абсолютного пути:
agentplugins author import native ./claude.json --from claude \
--output /absolute/path/to/new-plugin --name new-plugin \
--description 'Импортированный пакет Claude MCP'Изучите безопасные и пропущенные серверы, неподдерживаемые поля. Добавьте --write, чтобы сохранить проверенный пакет в новом месте. Небезопасные серверы и записи с учётными данными пропускаются; не предполагается перенос каждого исходного сервера. Импорт других клиентов здесь не предоставляется.
Соблюдайте границы команд
agentplugins validate ./review-helper читает пакет для установщика; agentplugins doctor проверяет управляемое установленное состояние. Это отдельные задачи. Область и параметры безопасности установщика не становятся параметрами author. Init создаёт реальные файлы; normalize и import применяют план только с --write. Далее — передача пакета.