跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

koda-cli-subagent

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

koda · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

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

技能说明


name: koda-cli-subagent description: "Навык делегирования подзадач субагенту koda-cli. Используй его, чтобы быстрее решить комплексные задачи из множества шагов благодаря параллельному запуску субагента. Запусти субагента, когда требуется множество изменений." license: MIT metadata: author: koda version: "1.0.0"

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