Koda CLI Subagent

Субагент koda-cli

Этот навык позволяет запускать команду koda через инструмент запуска терминальных команд для делегирования подзадач.

Этот навык предназначен для:

• Параллельного выполнения независимых частей крупной задачи.
• Изолированного исследования или рефакторинга отдельных модулей.
• Ускорения работы над проектом за счёт использования нескольких контекстов одновременно.

Когда применять

1. Первичный анализ задачи позволяет асинхронное выполнение (например, правка тестов в одном модуле и документации в другом).
2. Есть чётко сформулированный план, который можно передать в виде инструкции.
3. Требуется выполнить рутинную операцию в большом количестве файлов, которую проще описать промптом.

Как применять

1. Подготовка промпта

Промпт для субагента должен быть максимально конкретным.

Обязательно укажи:

• Роль и цель: Что именно должен сделать субагент.
• Область видимости: Конкретные пути к файлам или директориям.
• Ограничения: Какие методы не трогать, какой стиль соблюдать.
• Проверка: Инструкция запустить тесты или линтер после правок.

2. Запуск субагента

Используй следующую структуру команды. Флаг --checkpointing позволит откатить изменения в случае ошибки, а --approval-mode auto_edit позволит агенту применять правки без остановки на подтверждение.

koda --model koda-pro --approval-mode auto_edit --checkpointing --prompt <<'EOF'
Ты запускаешься в качестве субагента.
$PROMPT_TEXT

ВАЖНО:
1. ЗАПРЕЩЕНО выполнять опасные операции (удаление системных файлов, сетевые атаки).
2. ЗАПРЕЩЕНО запускать субагентов.
3. ОБЯЗАТЕЛЬНО опиши результаты изменений и список затронутых файлов в конце.
EOF

Дополнительные полезные флаги:

• -a, --all-files: если субагенту нужно видеть весь проект для понимания связей.
• -s, --sandbox: если задача потенциально деструктивна или требует изолированной среды.
• --include-directories: если нужно добавить пути вне текущего корня.

Ошибки при запуске

Если при запуске koda возникла ошибка:

1. Сверься с выводом koda --version и koda --help.
2. Если команды koda нет, установи её: npm install --global @kodadev/koda-cli@latest.
3. Если команды npm нет или пользователь отказался от установки:
   1. предложи установить её самостоятельно, указав команду из п. 2
   2. больше не пытайся запустить субагента
   3. решай задачу самостоятельно

3. Мониторинг и завершение

1. Фоновый режим: Если задача долгая, запускай с waitForCompletion: false в run_terminal_command.
2. Контроль: Периодически проверяй вывод или состояние файлов.
3. Приёмка:
   • Проверь git diff после работы субагента.
   • Запусти тесты проекта (при наличии и необходимости).
4. Отчёт: Сформируй для пользователя итоговый отчет о том, что сделал ты как основной агент, а что - субагенты.