Скилы Matt Pocock: как превратить AI-кодинг из хаоса в инженерную дисциплину

Большинство провалов с AI-кодингом — не про модель. Модель стала сильной; проблема в том, как мы с ней работаем. mattpocock/skills — это набор небольших, компонуемых скилов от Мэтта Покока, которые приносят в работу с агентом (Claude Code, Codex и другими) настоящую инженерную дисциплину вместо «vibe coding».

Зачем ещё одни скилы

Подходы вроде GSD, BMAD или Spec-Kit пытаются помочь, забирая процесс целиком — но вместе с контролем вы теряете возможность понять и починить баг в самом процессе. Скилы Мэтта сделаны иначе: они маленькие, легко адаптируемые и компонуемые. Работают с любой моделью, опираются на десятилетия инженерного опыта — и каждый можно «взломать» под себя.

Скилы делятся ровно по одной оси — кто их вызывает:

• User-invoked — запускаете вы (например, /grill-me); их задача — оркестрация.
• Model-invoked — вызываются автоматически, когда задача подходит; в них живёт переиспользуемая дисциплина.

User-invoked скил может звать model-invoked, но никогда — другой user-invoked.

Четыре проблемы, которые они чинят

1. Агент сделал не то, что нужно

Это главный источник боли, и он старше AI. В The Pragmatic Programmer есть мысль: «Никто не знает точно, чего хочет». Лекарство — grilling session, дотошный допрос агента о том, что именно вы строите.

• /grill-me — для задач вне кода.
• /grill-with-docs — то же, но попутно строит доменную модель проекта (об этом ниже).

Это самые популярные скилы в репо. Используйте их каждый раз перед изменением.

2. Агент невыносимо многословен

В начале проекта разработчики и эксперты предметной области говорят на разных языках. Агент, брошенный в проект, вынужден разбираться в жаргоне на ходу — и тратит 20 слов там, где хватило бы одного. Лекарство из DDD — ubiquitous language: общий документ-словарь проекта.

Пример Мэтта из репо course-video-manager:

• Было: «Проблема, когда урок внутри секции курса становится "настоящим" (получает место в файловой системе)».
• Стало: «Проблема с materialization cascade».

Эта краткость окупается сессия за сессией: переменные и файлы получают согласованные имена, кодовую базу легче навигировать и агент, и человеку, а модель тратит меньше токенов на «размышления». Это встроено в /grill-with-docs — пожалуй, самая мощная техника во всём репозитории.

3. Код не работает

Даже когда все согласны, агент всё равно может выдавать мусор — если нет обратной связи. Нужны привычные петли: статика, доступ к браузеру и тесты. Для тестов критичен цикл red-green-refactor: сначала падающий тест, потом реализация.

• /tdd — встраивается в любой проект и направляет агента на хорошие тесты.
• /diagnosing-bugs — петля «воспроизвести → минимизировать → гипотеза → инструментировать → починить → регрессионный тест» для трудных багов и просадок производительности.

4. Мы построили шар из грязи

Агенты ускоряют кодинг — а значит, и программную энтропию. Кодовые базы усложняются с беспрецедентной скоростью. Скилы заставляют заботиться о дизайне на каждом слое:

• /to-spec — перед спецификацией допрашивает, какие модули вы затрагиваете.
• /improve-codebase-architecture — сканирует кодовую базу на «углубления» (deep modules из A Philosophy of Software Design), строит наглядный HTML-отчёт и прогоняет вас через выбранное улучшение. Мэтт рекомендует запускать его раз в несколько дней.

Установка за 30 секунд

Два пути — две философии. Ставить оба не надо: получите каждый скил дважды.

Claude Code — управляемый плагин

claude plugins install mattpocock-skills

Или прямо из сессии:

/plugin install mattpocock-skills

Плагин лежит в официальном маркетплейсе Claude Code и обновляется автоматически.

Codex и редактируемые файлы

npx skills@latest add mattpocock/skills

Инсталлятор спросит, какие скилы взять и для каких агентов ставить. Обязательно возьмите setup-matt-pocock-skills — без него остальное не настроится. Этот же способ подходит тем, кто хочет владеть файлами и править их руками; обновления — вручную через npx skills update.

Финальный шаг: /setup-matt-pocock-skills

Запустите его один раз на репозиторий. Он спросит:

• какой таск-трекер используете (GitHub, Linear или локальные файлы);
• какие метки вы вешаете на тикеты при триаже (их использует /triage);
• куда складывать создаваемые документы.

Краткий обзор ключевых скилов

User-invoked (оркестрация):

• /ask-matt — маршрутизатор: подскажет, какой скил или флоу подходит вашей ситуации.
• /to-spec — превращает текущий разговор в спеку и публикует в трекер, без интервью.
• /to-tickets — дробит план на tracer-bullet тикеты с явно прописанными блокирующими зависимостями.
• /implement — реализует работу по спеке/тикетам с TDD на согласованных швах и заканчивает code review.
• /wayfinder — планирует огромные куски работы как карту из investigation-тикетов, когда проект не лезет в одну сессию.
• /wizard — генерирует интерактивный bash-мастер для ручных процедур (настройка сторонних сервисов, разовые миграции) с открытием URL и записью .env.

Model-invoked (дисциплина):

• /prototype — одноразовый прототип, чтобы ответить на дизайнерский вопрос.
• /research — исследование вопроса по первичным источникам с сохранением в Markdown с цитатами.
• /domain-modeling — активно шлифует доменную модель, сверяя термины с глоссарием.
• /codebase-design — словарь для проектирования «глубоких модулей» с маленьким интерфейсом на чистом шве.
• /code-review — двухосевой ревью (стандарты + соответствие спеке) параллельными субагентами.
• /resolving-merge-conflicts — проходит конфликт ханк за хунком, никогда не прерывая операцию.

Как начать

1. Поставьте скилы одним из способов выше.
2. Запустите /setup-matt-pocock-skills в репозитории.
3. Перед первым изменением — /grill-with-docs, чтобы выровнять понимание и собрать общий язык.
4. Раз в несколько дней — /improve-codebase-architecture.

Фундаментальные принципы разработки важнее, чем когда-либо. Скилы Мэтта — это честная попытка свернуть их в повторяемые практики и помочь вам сделать лучшее приложение в карьере.