google-agents-cli-scaffold

Навык google-agents-cli-scaffold описывает проектное создание и изменение приложений на Google ADK через команду agents-cli. Он нужен, когда требуется создать новый агентский проект, начать ADK-проект, добавить в существующий проект развёртывание или CI/CD, либо обновить уже созданный проект. В исходном SKILL.md отдельно указано, что этот навык занимается командами scaffold create, scaffold enhance и scaffold upgrade, а для написания кода агента и для непосредственных операций развёртывания предназначены другие навыки из набора Google ADK. Такое разделение важно: scaffold подготавливает структуру и инфраструктурные заготовки, но не заменяет разработку логики агента и не является самостоятельным деплой-инструментом. Перед созданием нового проекта навык требует уточнить задачу: что должен делать агент, какие инструменты и API ему нужны, а также нужен ли прототип или полноценное развёртывание. Для создания используется agents-cli scaffold create с именем проекта и параметрами шаблона, цели развёртывания, региона и, при необходимости, режима prototype. Имя проекта ограничено 26 символами и может содержать только строчные латинские буквы, цифры и дефисы. Каталог заранее создавать нельзя: create должен сам создать его, иначе команда может перейти в режим работы с существующим каталогом или завершиться ошибкой. Для Codex и других OpenAI-инструментов имя файла с рабочими указаниями выбирается как AGENTS.md; для других IDE навык перечисляет соответствующие варианты. В наборе указан один шаблон агента — adk. В зависимости от задачи можно выбрать prototype без заготовок CI/CD и Terraform, Agent Runtime через deployment-target agent_runtime, Cloud Run через cloud_run или GKE через gke; также предусмотрен вариант none без цели развёртывания. Для существующего проекта применяются scaffold enhance и параметры deployment-target или cicd-runner. Если код агента расположен не в app/, его путь нужно явно передать через agent-directory, иначе enhance может не найти нужные файлы. Для обновления предусмотрены scaffold upgrade, предварительный режим --dry-run и автоматическое применение неконфликтных изменений через --auto-approve. Навык также фиксирует практические ограничения процесса. Команды работают в строгом программном режиме и требуют явных флагов, поэтому нельзя рассчитывать на интерактивный выбор параметров. Перед CI/CD и добавлением развёртывания следует согласовать runner и target; в исходной документации отдельно упомянут выбор между GitHub Actions и Google Cloud Build. Для быстрого прототипа рекомендуется сначала scaffold create с --prototype, затем итерация над кодом и только после этого scaffold enhance. В сгенерированном проекте нельзя без необходимости переписывать manifest, deployment-конфигурации, Makefile и служебные файлы runtime/A2A; они связывают проект с agents-cli и обслуживанием. README репозитория описывает agents-cli как набор команд и навыков для построения, оценки и развёртывания ADK-агентов, а не как сам агент. CLI можно установить через uvx или подключить навыки через npx skills add; после scaffolding документация предлагает загрузить workflow разработки, запускать agents-cli run для короткой проверки, а оценку проводить через eval generate и eval grade. В итоге этот навык полезен как контролируемый вход в каркас проекта: он уменьшает риск неверной структуры и неподходящих флагов, но не отменяет уточнение требований, проверку сгенерированных файлов и отдельную валидацию приложения перед реальным развёртыванием.