Агенты для кодирования

Lizard спроектирован так, чтобы им можно было управлять от AI-агентов для кодирования так же легко, как людьми. В CLI встроен встроенный навык (skill), который обучает агента всей платформе, а каждая команда самоописывается через --json, поэтому агентам никогда не нужно угадывать.

Встроенный навык

Авторитетное руководство по использованию находится внутри CLI и версионируется вместе с ним, поэтому оно всегда соответствует установленной версии. Агент читает его с помощью:

lizard skills get core --json

Это возвращает { name, frontmatter, content, … } — content является полным руководством (конвейер сборки, приоритет переменных окружения, аддоны, обнаружение, коды выхода). Связанные подкоманды:

lizard skills list        # available embedded skills
lizard skills get core    # the core guide
lizard skills path        # where skills are stored

Так как руководство поставляется в составе бинарника, lizard upgrade обновляет и инструкции агента.

Самоописывающиеся команды

Агенты обнаруживают точную форму флагов во время выполнения вместо того, чтобы полагаться на запомненный синтаксис:

lizard --help --json                # full command tree + exit codes
lizard <cmd> --help --json          # a specific command's schema

См. JSON и автоматизация.

Бутстраппинг в агенте

Типичный поток работы агента:

Загрузите руководство: lizard skills get core --json → прочитайте content.
Проверьте авторизацию оптимистически: выполните задачу пользователя; при коде выхода 2 запустите lizard login, передайте пользователю выведенный URL, затем повторите попытку.
Определите контекст перед мутацией: lizard status (связка cwd) и lizard ps --json (сервисы).
Действуйте с помощью руководства — add, up, secrets, domain и т.д., всегда с --json.

Если бинарник lizard отсутствует, сначала установите его:

npm install -g @lizard-build/cli

Соглашения, которым должны следовать агенты

Всегда передавайте --json при неинтерактивных вызовах.
Подтверждайте деструктивные действия (удаление сервиса, удаление аддона, перезапись секрета на уровне проекта, перезагрузка продакшена) с пользователем — встроенные подсказки CLI срабатывают только при наличии TTY.
Ограничивайте область действия секретов потребляющим сервисом по умолчанию; резервируйте --global для явно публичных значений. См. Переменные и секреты.
Не пишите Dockerfile без запроса — lizardpack автоматически определяет большинство стеков. Сначала попробуйте задеплоить. См. Конвейер сборки.
Не используйте lizard up для переключения git-базированного сервиса на загрузку — используйте service set + redeploy.

Интеграции с редакторами

Lizard Skill распространяется как публичный бутстрап, чтобы агенты в редакторах и ассистентах могли устанавливать и загружать его по требованию, а затем управлять тем же CLI, который описан во всей этой документации. CLI — единственный источник правды — отдельного API для агентов не существует.

Это относится и к AI IDE: они пишут и тестируют приложение, но не хостят его. См. развертывание приложения, созданного в Google Antigravity, где весь деплой выполняется из двух промптов.

См. также

lizard skills — полная справочная информация по командам.
JSON и автоматизация — вывод --json и обнаружение схем.
Переменные и секреты — соглашения об области действия секретов, которым должны следовать агенты.
Разверните ваше приложение из Claude Code — тот же бутстрап, представленный как пошаговое руководство, с промптами, которые его управляют.

Хостинг собственного MCP-сервера

Агент, использующий Lizard CLI, и приложение, предоставляющее MCP — это отдельные рабочие процессы. Команды CLI, описанные выше, не предоставляют MCP-транспорт. Чтобы развернуть собственный сервер с Streamable HTTP, следуйте руководству по удаленному MCP.

Панель приложения