Koda cli subagent

Skill XCode-NLP/KodaSkills/skills/koda-cli-subagent

Навыки для KodaCode

Install

npx -y skills add XCode-NLP/KodaSkills --skill koda-cli-subagent

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

13 stars13 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

5.1 KB, as published. Nobody here has run it

Субагент koda-cli

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

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

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

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

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

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

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 возникла ошибка:

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

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

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