§4.05 Подключение агента-портного (Kimi)
Время: 45 мин чтение + 30 мин
В одном предложении: Человек думает, что Kimi — это просто ещё один чат, к которому можно обратиться, когда Claude занят, а на самом деле Kimi в IWE — это агент с определённой ролью, контекстом и протоколами, и если вы используете Kimi как «просто чат», вы не используете его возможности, а тратите энергию на повторное объяснение контекста.
Мем, который снимается. «Kimi — это китайский аналог Claude. Он дешевле, быстрее, но не такой умный. Я использую его для простых задач, а сложные — Claude.» На самом деле Kimi — не аналог и не конкурент. Kimi — это инструмент с другими характеристиками, и в IWE он подключён как агент с ролью Портного или Навигатора, с контекстом из AGENTS.md, с MCP-доступом, с протоколами коммитов. Сравнение «лучше/хуже» бессмысленно: вопрос не в том, какой агент умнее, а в том, какой агент подходит для какой роли в вашей системе.
Понятия. Kimi подключается в IWE как агент с ролью Портного или Навигатора. Особенности подключения: AGENTS.md — файл с контекстом для Kimi, содержащий правила работы, стиль кода, предпочтения пилота, ограничения; commit-template — шаблон коммитов с трейлером Co-Authored-By: Kimi noreply@moonshot.ai, который фиксирует участие агента; MCP — набор серверов, предоставляющих Kimi доступ к файловой системе, скриптам, базам данных; файловые блокировки через MCP — механизм, предотвращающий одновременное редактирование одних и тех же файлов несколькими агентами. Kimi работает в контексте IWE: видит Pack, знает структуру, следует протоколам. Пилот контролирует, агент предлагает. Kimi не действует самостоятельно: каждое действие требует подтверждения или явного разрешения.
Объяснение. Kimi как Портной — создаёт артефакты: пишет код, документы, спецификации. Его сильная сторона — скорость и объём контекста. Kimi как Навигатор — поддерживает траекторию: проверяет планы, ищет расхождения, предупреждает об отклонениях. Его сильная сторона — системное мышление и способность удерживать длинный контекст. Роль определяет, как использовать Kimi, а не модель. В роли Портного Kimy запрашивает подтверждение перед каждым изменением файла. В роли Навигатора Kimi не редактирует файлы, а только анализирует и рекомендует. Переключение ролей требует явного указания: «Ты в роли Портного» или «Ты в роли Навигатора». Без указания роли Kimi пытается угадать, что вы хотите, и угадывает плохо. Файловые блокировки — критически важный механизм. Когда Kimi редактирует файл, он блокирует его для других агентов. Это предотвращает конфликты: два агента не могут одновременно изменить один файл. Блокировка снимается после коммита или явного разблокирования. Без блокировок — хаос: агент A перезаписывает изменения агента B, и работа теряется.
На практике. Практика «Проверка настройки Kimi» (30 мин):
- Проверьте AGENTS.md: есть ли в нём раздел для Kimi? Содержит ли он контекст, роль, ограничения? (10 мин)
- Проверьте commit-template: есть ли трейлер Co-Authored-By? Используется ли он в коммитах? (5 мин)
- Проверьте MCP: какие серверы подключены к Kimi? Соответствуют ли они его роли? (10 мин)
- Проведите тестовое РП: попросите Kimi выполнить типовую задачу в его роли. Оцените: понял ли контекст? Следовал ли протоколам? (5 мин)
Типичный кейс. Программист использовал Kimi для написания кода без настройки AGENTS.md. Каждый раз он объяснял: «Мы используем TypeScript, строгие типы, функциональный стиль». Kimi генерировал код на JavaScript, с нестрогими типами, в императивном стиле. Программист тратил время на исправления. После настройки AGENTS.md: «TypeScript, strict mode, functional style, no classes». Kimi начал генерировать код, который требовал минимальных правок. Экономия времени — не потому, что Kimi стал умнее, а потому что контекст был задан один раз, а не объяснялся каждый раз.
Типичная ошибка. «Kimi — это просто инструмент. Не нужно ему объяснять контекст, он сам разберётся.» Kimi не разберётся. Он не знает вашего стиля, ваших предпочтений, ваших ограничений. AGENTS.md — это не избыточность, а инвестиция: потратьте время один раз, экономьте его потом. Другая ошибка: «Commit-template — это формальность. Главное — код.» Commit-template фиксирует авторство. Без него вы не знаете, кто что написал: вы, Kimi, или вы вместе. Это важно для отладки, для ревью, для обучения.
Степени мастерства:
- Объяснение. Могу объяснить, чем Kimi отличается от «просто чата» в контексте IWE. Критерий перехода: проверил настройку Kimi.
- Умение. Использую Kimi в рамках его роли с контекстом из AGENTS.md и соблюдением протоколов. Критерий перехода: десять коммитов с правильным трейлером.
- Навык. Системно поддерживаю Kimi: обновляю AGENTS.md, проверяю MCP, следую протоколам. Критерий перехода: коллега использовала вашу настройку Kimi для своей работы.
- Мастерство. Проектирую интеграцию нового агента по образцу Kimi: AGENTS.md, commit-template, MCP, блокировки. Критерий перехода: другой человект подключил нового агента по вашей схеме.
Проверка себя.
- Могу объяснить роль Kimi в моей IWE и показать AGENTS.md
- Все коммиты с участием Kimi содержат трейлер Co-Authored-By
- Kimi имеет MCP-набор, соответствующий его роли
- Проверял настройку Kimi за последний месяц
- Могу провести тестовое РП с Kimi и оценить качество по чеклисту
На практике. Откройте AGENTS.md. Найдите раздел для Kimi. Если его нет — создайте. Если есть — проверьте: актуален ли контекст? Соответствует ли текущей роли? Обновите, если нужно. Это займёт десять минут, но сэкономит часы в будущем.
См. also: Типология ролей — PD.GUIDE.3.S4.SS1, MCP — PD.GUIDE.3.S4.SS2, IntegrationGate — PD.GUIDE.3.S4.SS3.
Что дальше. Следующий подраздел — о взаимной проверке в контексте агентов: как агенты проверяют друг друга и защищают от ошибок.