# Koda CLI Subagent

> Навык делегирования подзадач субагенту koda-cli. Используй его, чтобы быстрее решить комплексные задачи из множества шагов благодаря параллельному запуску субагента. Запусти субагента, когда требуется множество изменений.

- Skill: `xcode-nlp/koda-cli-subagent` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xcode-nlp/koda-cli-subagent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xcode-nlp/koda-cli-subagent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: XCode-NLP (https://skillmd.com/u/xcode-nlp)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xcode-nlp/koda-cli-subagent

---


# Субагент koda-cli

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

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

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

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

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

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

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

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

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

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

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

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

```bash
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. **Отчёт**: Сформируй для пользователя итоговый отчет о том, что сделал ты как основной агент, а что - субагенты.