<span id="coding-agents" />

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

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

<span id="the-embedded-skill" />

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

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

```bash
lizard skills get core --json
```

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

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

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

<span id="self-describing-commands" />

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

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

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

См. [JSON и автоматизация](https://lizard.build/ru/docs/cli/json).

<span id="bootstrapping-in-an-agent" />

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

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

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

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

```bash
npm install -g @lizard-build/cli
```

<span id="conventions-agents-should-follow" />

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

- **Всегда передавайте `--json`** при неинтерактивных вызовах.
- **Подтверждайте деструктивные действия** (удаление сервиса, удаление аддона, перезапись секрета на уровне проекта, перезагрузка продакшена) с пользователем — встроенные подсказки CLI срабатывают только при наличии TTY.
- **Ограничивайте область действия секретов потребляющим сервисом** по умолчанию; резервируйте `--global` для явно публичных значений. См. [Переменные и секреты](https://lizard.build/ru/docs/variables#scoping).
- **Не пишите Dockerfile без запроса** — lizardpack автоматически определяет большинство стеков. Сначала попробуйте задеплоить. См. [Конвейер сборки](https://lizard.build/ru/docs/concepts/build-pipeline).
- **Не используйте `lizard up` для переключения git-базированного сервиса на загрузку** — используйте `service set` + `redeploy`.

<span id="editor-integrations" />

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

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

Это относится и к AI IDE: они пишут и тестируют приложение, но не хостят его. См. [развертывание приложения, созданного в Google Antigravity](https://lizard.build/blog/google-antigravity-how-to-deploy-your-app-to-production#deploy-an-antigravity-app-to-production-without-typing-a-command), где весь деплой выполняется из двух промптов.

<span id="see-also" />

## См. также

- [`lizard skills`](https://lizard.build/ru/docs/cli/skills) — полная справочная информация по командам.
- [JSON и автоматизация](https://lizard.build/ru/docs/cli/json) — вывод `--json` и обнаружение схем.
- [Переменные и секреты](https://lizard.build/ru/docs/variables#scoping) — соглашения об области действия секретов, которым должны следовать агенты.
- [Разверните ваше приложение из Claude Code](https://lizard.build/blog/deploy-from-claude-code#deploy-from-claude-code-in-3-steps) — тот же бутстрап, представленный как пошаговое руководство, с промптами, которые его управляют.

<span id="hosting-your-own-mcp-server" />

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

Агент, использующий Lizard CLI, и приложение, предоставляющее MCP — это отдельные рабочие процессы. Команды CLI, описанные выше, не предоставляют MCP-транспорт. Чтобы развернуть собственный сервер с Streamable HTTP, следуйте [руководству по удаленному MCP](https://lizard.build/ru/docs/guides/deploy-mcp-server).