Skills исправляют привычки MCP исправляет память

Я долго пытался решить одну проблему Claude Code в разных сессиях ведет себя поразному и это иногда просто ломает логику ^[1] работы

сначала думал что дело в промптах потом начал думать что проблема в контексте но в итоге стало понятно что все немного глубже

.

Что именно ломалось

больше всего бесило то что модель сама начинала “улучшать” код даже когда ее об этом вообще не просили

она могла убирать тесты потому что так якобы чище или менять архитектуру которая уже нормально работала и это выглядело странно

вторая проблема это память ^[2] между сессиями мы вроде договорились как должен выглядеть проект но через день это уже просто забывается

третье это MCP инструменты которые постепенно превращаются в кашу и потом уже непонятно где логика а где данные

Я разделил систему на две части

сначала я пытался просто улучшать промпты но это довольно быстро перестало работать

тогда я разделил систему на Skills которые отвечают за поведение ^[3] и MCP которые отвечают за память и инструменты

Skills и первая ошибка

Skill это просто SKILL.md ^[4] файл и на первый взгляд это звучит очень просто

я сначала написал правило типа ship fast dont overthink и выглядело это нормально

но потом оказалось что модель начинает следовать этому слишком буквально

она начинала убирать тесты и упрощать код даже там где этого делать нельзя

Пришлось добавлять ограничения

после этого стало понятно что без явных ограничений это просто не работает нормально

я добавил правило Do NOT use when payments auth irreversible operations и только после этого стало хоть как то контролируемо

Баги которые меня реально удивили

один из первых багов был с asyncio и web сервером когда я просто соединил два подхода к event loop и все просто упало и сначала вообще непонятно было почему

потом была история с env переменными где ADMIN_IDS выглядели как обычная строка через запятую но pydantic ожидал json и все ломалось

самый неприятный баг был во Flutter когда длина строки считалась в символах а Google Drive ожидал байты и в итоге кириллица просто тихо обрезалась без ошибок

MCP и что там пошло не так

memory kit это просто SQLite с FTS5 чтобы можно было хранить и искать память локально идея простая но на удивление рабочая

skills server внезапно начал ловить проблему с параллельными запросами когда один skill дергается много раз одновременно и GitHub просто не выдерживает

пришлось добавить asyncio Lock чтобы это не разлеталось

github MCP сначала вообще не имел нормальной валидации и потом стало понятно что repo строку можно сломать через странный input

telegram MCP я сначала хотел делать с передачей токена как параметра но потом понял что это плохая идея и теперь токен живет только в env и вообще не попадает в модель

Проект пока сырой

я не пытаюсь делать вид что это какой то готовый фреймворк это скорее набор экспериментов который еще постоянно меняется

skills будут допиливаться MCP тоже будет меняться и возможно часть решений вообще окажется неправильной

Что дальше

планируется добавить – docs writer skill, test writer skill, новые MCP сервера и возможно mcpm как визуальный менеджер для всего этого

Итог

главное что я понял это то что проблема не в том что модель плохая а в том что у нее нет нормальных стабильных границ поведения ^[5] и памяти

skills и MCP это просто попытка эти границы хоть как то зафиксировать

GitHub https://github.com/DarkenAmber/claude-kit ^[6]