Настройка Kodik через агента

Kodik добавляет одну строку Kodik configuration в раздел Environment запросов родительского чата, включая Orchestrator. Субагенты получают контекст конфигурации только тогда, когда родительский агент передаёт его в задании. В строке указаны глобальный каталог и каталог профиля для сессии (и корень workspace, если он отличается от рабочего каталога) и путь к встроенному skill kodik-configuration, а также просьба прочитать этот skill перед созданием или изменением skills, правил, MCP-серверов, субагентов, хуков или настроек Kodik. Skill сопоставляет каждый путь назначения (skills, команды, правила, память, хуки, определения субагентов, файлы настроек MCP, плагины и настройки редактора) с этими корнями; агент читает его только тогда, когда задача касается конфигурации, поэтому остальные сессии не несут эти детали в промпте. Строка доступна даже при выключенном автообнаружении skills и без подключённых MCP-серверов.

Попросите агента установить skill для текущего проекта или для всех проектов. Новые ресурсы под управлением Kodik по умолчанию создаются в строчных каталогах .kodik выбранного workspace; запрос «для всех проектов» использует глобальный каталог. Если workspace не открыт, по умолчанию используется глобальный уровень. Явно указанные совместимые пути .agents учитываются, но такие ресурсы остаются доступными только для чтения в настройках Kodik.

Агент получает пути именно запущенной установки. Production обычно использует ~/.kodik, development — ~/.kodik-dev, portable-установка — выбранный дом на носителе. Пользовательские настройки редактора и MCP могут принадлежать другому каталогу активного профиля. Искать эти пути агенту не требуется.

Оба встроенных skill показаны в карточке Встроенные в разделе Settings → Skills. Их можно открыть и выключить из автообнаружения моделью; встроенные файлы не изменяются и не удаляются, а skill рабочей области или глобальный skill с тем же именем имеет приоритет над встроенным. Если выключить skill kodik-configuration, в строке остаётся только каталог конфигурации Kodik.

Два встроенных skill загружаются по необходимости: kodik-configuration описывает пути назначения, форматы, владельцев, объединение изменений и активацию; skill-installer описывает установку из репозитория и содержит необязательный скрипт Python 3 для загрузки полных каталогов skills из GitHub-архива. Скрипт требует явно указать каталог назначения и не перезаписывает существующие пакеты. Если Python недоступен, агент может использовать доступные shell-инструменты или загрузку файлов с тем же каталогом назначения.

После установки проверьте Settings → Skills или список слеш-команд. Если обнаружение ещё не обновилось, выполните Developer: Reload Window. Для MCP также нужно проверить подключение сервера и появление инструментов. Знание конфигурации не включает инструменты, не меняет режим и не отменяет разрешения или настройки Harness.

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

Семейства промптов

Корректное значение promptFamily (openai, claude, deepseek или default) в конфигурации модели важнее определения по её ID. Некорректные значения диагностируются и игнорируются. Метаданные производителя независимы. Выбор одинаков для родителя, исполнителя и предпросмотра Harness.

Каждый промпт объединяет общую основу с одним независимым семейством: OpenAI, Claude, DeepSeek или стандартным. Стандартное семейство используется для остальных моделей и не является родителем именованных семейств. Указания каждого семейства можно менять независимо.

ID моделей DeepSeek, включая ID с префиксом провайдера, например deepseek/deepseek-v4-flash, выбирают семейство DeepSeek. Для собственного псевдонима без узнаваемого ID задайте promptFamily: "deepseek" в конфигурации модели. DeepSeek получает общие инструкции о продолжении задания и собственные краткие указания для доступных инструментов работы с файлами и терминалом. Отключённые инструменты в эти указания не попадают. Явное значение promptFamily: "default" выбирает стандартное семейство даже для ID DeepSeek.

Стандартное семейство используется для ID, которые не выбирают OpenAI, Claude или DeepSeek, включая неизвестные псевдонимы пользовательских моделей. Его указания Code требуют полностью выполнить запрос, сохранить совместимость с затронутыми вызовами и проверять запрошенный публичный API: точные имена, значения по умолчанию, ошибки и момент их возникновения, значимые сочетания параметров и порядок вызовов в жизненном цикле, включая восстановление состояния, отмену и очистку. Новые утверждения в тестах должны опираться на запрос и существующие публичные контракты. Субагенты с инструментами редактирования файлов получают те же указания; исполнители только для чтения и остальные режимы основного агента их не получают. DeepSeek независимо использует четыре строки о полноте реализации, устранении неопределённости без сужения задания, проверке публичного API и обоснованных утверждениях. OpenAI и Claude сохраняют более короткие инструкции Code, а OpenAI также получает указания для доступного apply_patch.

Инструкции Code всех семейств запрещают менять тесты или фикстуры только ради успешной проверки реализации. Ожидаемые результаты можно менять, если этого требует запрошенное поведение; агент поясняет существенные изменения вместо перечисления каждого изменённого значения.

Краткие указания DeepSeek для инструментов поясняют префиксы и диапазоны строк, использование актуального содержимого перед правками, точные замены, создание новых файлов, усечённые результаты поиска, коды завершения команд и значимые фоновые результаты. Базовый синтаксис поиска и способы проверки результатов для конкретной среды остаются в схемах инструментов. Серверы и наблюдатели могут продолжать работать после успешных проверок запуска; ненужные фоновые команды можно остановить доступным инструментом управления терминалом.

Все семейства получают общую инструкцию кратко переформулировать запрос перед существенной работой. Общая основа ставит в приоритет экономию времени и токенов при правильном выполнении запроса и обязательных проверок. Она поясняет, что каждый ход заново отправляет текущий разговор, поэтому независимые вызовы инструментов с известными входными данными и без конфликтов за файлы или ресурсы следует выполнять вместе; зависимые вызовы ждут нужных данных. Следующий абзац разрешает выполнять полезную независимую работу или ждать, пока завершатся фоновые задачи. Если события завершения приходят автоматически, завершение хода для ожидания не прекращает задачу: событие запускает следующий ход.

Общая основа также просит избегать лишней работы и пояснений, повторно использовать актуальные сведения и повторять или расширять проверки только тогда, когда это оправдано запросом, инструкциями проекта, существенными изменениями, сбоями или конкретными пробелами. Список отложенных инструментов напоминает сначала загрузить схемы аргументов через tool_search: догадки об аргументах могут привести к ошибке инструмента.