Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал

Каталог навыков и плагинов

Статус: действует Область: публичная, текущее состояние Последняя проверка: 2026-08-12 Владелец: среда выполнения AX Code

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

Меню / по умолчанию — плоскость управления (/plan, /review, /debug, /status, /model). Более старые встроенные навыки остаются только для агента (инструмент навыка). Пакет надёжности сервера также перечислен как команды со слэшем.

Встроенные навыки (поставляются в `packages/ax-code/skills/`)

Навык	Назначение	Слэш
`debug-n-fix`	Сначала отладка, затем исправление с проверкой	Используйте `/debug`
`debug-only`	Расследование без изменений кода	Только для агента
`improve-overall`	Широкие улучшения качества	Только для агента
`improve-security`	Улучшения с упором на безопасность	Только для агента
`mcp`	Руководство по настройке MCP	Используйте `/mcp`
`run`	Запуск и наблюдение за приложением	Только для агента
`simplify`	Ужесточить недавно изменённый код	Только для агента
`verify`	Отчёт проверки среды выполнения	Только для агента
`verified-change`	Править только после неуспешного сигнала, затем снова выполнить ту же проверку	`/verified-change`
`safe-db-migration`	Изменения схемы: расширение, заполнение назад и сужение, с заметками об откате	`/safe-db-migration`
`api-contract`	Эволюция публичного API и схемы, сначала аддитивно	`/api-contract`
`incident-observability`	Диагностика инцидента по свидетельствам до заплатки	`/incident-observability`
`auth-boundaries`	Аутентификация и авторизация, изоляция арендаторов, отрицательные тесты	`/auth-boundaries`
`queue-worker`	Идемпотентные изменения очереди и работника и повторная доставка	`/queue-worker`
`ruby-on-rails`	Соглашения Rails без запуска процесса Rails	Только для агента

Навыки используют SKILL.md с frontmatter YAML (name, description, необязательные paths, allowed-tools).

Навыки проекта

Поместите навыки в любой из каталогов:

.ax-code/skill/<name>/SKILL.md или .ax-code/skills/<name>/SKILL.md
.agents/skills/<name>/SKILL.md (совместимость с Agents и Codex)
.claude/skills/<name>/SKILL.md (совместимость с Claude Code)
.opencode/skills/<name>/SKILL.md

Список и проверка:

ax-code            # TUI skill dialog
# or use the skill tool from a session

Управление вызовом

AX Code читает эти необязательные средства управления при обнаружении навыка:

Место	Поле	Эффект
frontmatter `SKILL.md`	`disable-model-invocation: true`	Сохранить явную команду `/skill-name`, но исключить навык из обнаружения моделью и прямой загрузки инструмента модели.
frontmatter `SKILL.md`	`user-invocable: false`	Убрать навык из команд со слэшем. Вызов моделью остаётся доступен, если его не отключили отдельно.
Соседний `agents/openai.yaml`	`policy.allow_implicit_invocation: false`	Требовать явный вызов слэшем, в том числе для навыков, импортированных через `.agents/skills`.

Используйте булевы значения YAML true и false. Отсутствующие средства сохраняют значения по умолчанию. Если несколько источников расходятся, побеждает ограничивающее объявление. Неверный тип средства или повреждённая политика sidecar отключает оба режима вызова и даёт диагностику вызова в инвентаре навыков и журналах среды выполнения. Исправьте метаданные, прежде чем пользоваться навыком. Необязательный sidecar должен быть меньше 64 КиБ. Разделители документов YAML и псевдонимы там не поддерживаются.

Эти средства управляют вызовом навыка независимо от уже существующих прав агента. Упоминание навыка только для ручного вызова обычным языком не даёт модели права его загрузить. Вызовите его команду со слэшем. Объявленные allowed-tools остаются инструкциями рабочего процесса и прав не дают.

Ограниченное обнаружение

Сначала модель получает сводки навыков, а не полные инструкции. Каждый блок метаданных навыка в системном промпте и описании инструмента имеет бюджет 8 000 символов. Описания укорачиваются, прежде чем записи опускаются. Рекомендации по совпадению файла получают приоритет, если список всё ещё превышает бюджет. Замечание об опущении объясняет, как получить больше сводок. Это предел символов, а не счётчик токенов и не гарантия производительности.

У инструмента skill два взаимоисключающих режима:

{"name":"api-contract"} загружает навык через существующую проверку права.
{"query":"database"} ищет подходящие имена и описания, не загружая тела навыков.
{"query":"","offset":20} продолжает список, используя точный nextOffset из предыдущего результата.

Поиск буквальный и без учёта регистра. Пустые запросы перечисляют подходящие навыки. Следуйте nextOffset, пока его нет. Навыки только для ручного вызова и навыки с отказом в праве исключены из обнаружения моделью. Слишком большие отдельные записи метаданных пропускаются с замечанием. Имена и приоритет источника не меняются.

Плагины

Настройте плагины в ax-code.json:

{
  "plugin": ["file:///absolute/path/to/plugin.js"]
}

Плагины реализуют хуки @ax-code/plugin (tool.execute.before, tool.execute.after, shell.env, аутентификация и так далее).

Время жизни обратного вызова

Фабрики плагинов получают необязательный lifecycle во входе. lifecycle.signal прерывается, когда экземпляр освобождён или плагин выведен из обращения. Регистрируйте таймеры, наблюдатели и подписки через lifecycle.onDispose(cleanup). Возвращённая функция снимает эту очистку. Регистрации выполняются не больше одного раза. Регистрация после освобождения сразу начинает очистку. Обратные вызовы очистки стартуют в обратном порядке регистрации, каждый с бюджетом в одну секунду, и могут завершаться параллельно.

Хуки преобразования получают необязательный третий аргумент { signal }. Хуки конфигурации и событий получают его вторым аргументом. Этот сигнал отменяет работу, пока обратный вызов ожидает. Для работы, которой владеет плагин дольше одного обратного вызова, используйте lifecycle.signal. Передавайте сигналы прерываемым операциям. У обратных вызовов инициализации, конфигурации, событий и преобразования срок 15 секунд. Тайм-аут выводит плагин из обращения для этого экземпляра и прерывает его время жизни. Существующие фабрики и хуки преобразования с двумя аргументами продолжают работать. Выполнение собственных инструментов и интерактивная аутентификация сохраняют свои контракты выполнения.

Входы преобразования — наблюдения обычных данных только для чтения. Меняйте черновик вывода и дождитесь всех изменений перед возвратом. Успешные изменения вывода становятся видимыми в порядке регистрации. Неуспешные или поздние изменения отбрасываются. Изменения нагрузки события никогда не публикуются. Отказ в праве остаётся отказом, а неуспешные или выведенные хуки прав требуют вопроса, если отказа ещё нет.

Массивы и обычные объекты отсоединены от состояния среды выполнения. Схемы, функции и экземпляры классов сохраняют личность, и к ним нужно относиться как к данным только для чтения. Плагины остаются доверенным JavaScript, работающим в процессе среды выполнения: отмена кооперативна и не может остановить синхронные бесконечные циклы или отменить внешние эффекты.

Пакеты хуков

См. Хуки для пяти официальных пакетов жизненного цикла (format-after-edit, block-force-push, require-tests-on-stop, protect-env-files, log-bash-commands).

Обвязка оценки

Запустите набор шлюза агентной среды выполнения и набор политики ансамбля нескольких режимов:

cd packages/ax-code
pnpm exec vitest run test/harness/agentic-runtime-eval.test.ts
pnpm exec vitest run test/harness/multi-mode-ensemble-eval.test.ts

См. также режимы выполнения для локального, облачного, гибридного, council и arena.