⚡️ Спека, которая наведёт порядок в ваших скиллах и проектах
На прошлой неделе делал разбор рекомендаций Антропиков по работе с пятым поколением Claude. Если кратко, то там довольно много системных изменений, которые было бы неплохо накатить на свои проекты.
Что я и сделал.
Не могу сказать, что сразу вышло всё идеально, но последняя версия спеки вроде как реально улучшает работу.
Короче, можно отдавать в общее тестирование.
Спека (спецификация) — это обычная текстовая инструкция. Кладёте файлик в папку с проектом (или просто кидаете линк), говорите нейромозгу «прочитай и сделай план по этой спецификации», дальше ассистент шуршит сам, читает ваши скиллы, инструкции, субагентов и формирует отчёт, что в них не так.
✦ ЧТО ОН ИЩЕТ
— Правила, которые противоречат друг другу. В одном файле «пиши подробно», в соседнем «не разводи воду», ассистент читает оба и выбирает сам, а вы потом гадаете, почему результат пляшет
— Одну инструкцию, продублированную трижды. Раньше так делали намеренно, чтобы модель не забыла, сейчас это только сбивает
— Запреты, доставшиеся от старых моделей. Они писались, когда нейронка реально косячила без присмотра
— Ссылки в никуда: файл переименовали, а упоминание осталось
— Куски инструкций, которые грузятся при каждом запуске, хотя вообще не нужны
✦ КАК ПОЛЬЗОВАТЬСЯ
① Сохраните проект. Под гитом хватит закоммитить несохранённое, без гита просто скопируйте папку. Файл и сам попросит, но лучше подстраховаться.
② Попросите сначала ПЛАН, а не правки. По умолчанию стоит режим разбора. Ассистент не трогает ни одного файла, пока вы прямо не разрешите. Молчание разрешением не считается.
③ Прочитайте полученный отчёт. Он начинается разделом «простыми словами», без терминов. Первая строка — что получилось и проверялось ли это вживую. Дальше то, что чинить первым, и что изменится лично для вас. Некоторые находки будут вами отклонены, это нормально.
④ Вот теперь накатывайте. Каждая правка идёт со своим номером и точным текстом «было → стало», ассистент тормозит и ждёт, какие номера вы одобрите. Применяет по одному, способ отката пишет в отчёт сразу. Режима «делай всё сам» здесь нет намеренно.
❗️Сразу оговорюсь, что на микроскилле в тридцать строк он вам ничего толком не найдёт, там и так всё на виду. Смысл появляется, когда инструкций уже много и они начали жить своей жизнью.
Ну и держите в голове, что это всё не более чем тест. Резких изменений в спеку я специально не закладывал, только мягкие улучшения по рекомендациям Антропиков. Никакой жёсткой хирургии.
👉 Забирайте спеку туточки: https://github.com/TimurUgulava/claude-skills/tree/main/skill-revision-spec
Как погоняете у себя — расскажите, что получилось. Стало лучше, хуже, где ассистент понял не так? Будет полезно.
#ClaudeCode