Режимы

Агент Kodik работает в одном из пяти режимов. Режим определяет, что агент может делать, а также набор доступных инструментов. Значение "act" нормализуется до "code" для обратной совместимости.

Code (по умолчанию)

Code — режим выполнения задач. Это режим по умолчанию для всех новых задач.

Поведение: агент использует все доступные инструменты для понимания кодовой базы, внесения изменений, запуска команд и проверки результатов. Работает в видимом рабочем дереве задачи. Если задача неоднозначна, может один раз вызвать ask_questions перед началом работы.

Доступные инструменты: shell, command_status, read_file, codebase_search, edit_file, edit_files, edit_notebook, rg, glob, ask_questions, read_lints, web_fetch, todo_write, sub_agent, memory

Plan

Plan — режим только для чтения. Агент исследует код, задаёт уточняющие вопросы при необходимости и сохраняет финальный план через инструмент generate_plan.

Поведение: агент не редактирует файлы, не создаёт их и не выполняет команды, изменяющие состояние рабочего пространства. Строит пошаговый план, отмечает риски и открытые вопросы. При необходимости добавляет диаграмму Mermaid в generate_plan. Вопросы задаются только через ask_questions — не в виде обычного текста.

Доступные инструменты: read_file, glob, rg, codebase_search, read_lints, web_fetch, sub_agent, ask_questions, generate_plan, memory

Ask

Ask — строгий режим только для чтения. Предназначен для вопросов о кодовой базе: архитектура, поведение, трейдоффы.

Поведение: агент отвечает на вопросы, читая релевантный код перед ответом. Не выполняет команды и не редактирует файлы. Если пользователь просит что-то реализовать, агент объясняет, что Ask-режим предназначен только для анализа, и предлагает переключиться в Code.

Доступные инструменты: read_file, glob, rg, codebase_search, read_lints, web_fetch, sub_agent, ask_questions, memory

Debug

Debug — режим отладки с гипотезами. Разделяет диагностику и фикс.

Поведение: агент следует строгому рабочему процессу:

Формулирует 3–5 точных гипотез о причине проблемы.
Добавляет целевую инструментацию для их проверки.
При необходимости просит пользователя воспроизвести проблему.
Собирает доказательства из логов, вывода команд и тестов.
Классифицирует каждую гипотезу: ПОДТВЕРЖДЕНА, ОПРОВЕРГНУТА или НЕОПРЕДЕЛЁННО.
Реализует минимальный фикс, подтверждённый доказательствами.
Верифицирует фикс и удаляет временную инструментацию.

Агент никогда не объявляет проблему исправленной без реальных доказательств из среды выполнения.

Educator

Educator — режим обучения только для чтения. Строится на базе Ask с добавлением инструмента check_understanding.

Поведение: агент объясняет концепции постепенно, опирается на реальный код, использует примеры и простые ментальные модели. При необходимости может вызвать check_understanding с 1–3 вопросами, чтобы адаптировать дальнейшее объяснение. Неверные ответы воспринимаются как диагностический сигнал, а не как ошибка.

Доступные инструменты: все инструменты Ask плюс check_understanding