Как научить ИИ-агента думать как Senior-разработчик

Недавно поймал себя на мысли: Claude и ChatGPT отлично пишут код, но когда дело доходит до планирования архитектуры или глубокого рефакторинга, они часто «плывут». Приходится по десять раз объяснять контекст, просить составить план и следить, чтобы нейронка не сломала половину проекта. Мэтт Покок, которого многие знают по курсам Total TypeScript, видимо, столкнулся с тем же самым и выложил репозиторий mattpocock/skills.

Это не просто библиотека, а набор «навыков» для ИИ-агентов (в первую очередь для Claude Code). По сути, это готовые промпты и сценарии, которые превращают чат-бота в полноценного напарника, умеющего проводить интервью, проектировать интерфейсы и даже следить за чистотой Git-истории.

Что это вообще такое

Проект представляет собой коллекцию скриптов, которые можно добавить в свой рабочий процесс одной командой через npx. Мэтт называет их «скиллами». Идея в том, что вместо того чтобы каждый раз объяснять ИИ, как писать PRD (Product Requirements Document) или как делать TDD, вы просто подгружаете нужный навык.

Интересно, что проект вырос из личных наработок Мэтта в папке .claude. Это чувствуется: здесь нет лишней шелухи, только то, что реально нужно в ежедневной разработке.

Планирование без боли

Самая сильная часть репозитория — инструменты для проектирования. Обычно мы либо пропускаем этап планирования, либо тратим на него часы. Здесь предлагается другой путь.

Например, навык write-a-prd запускает интерактивное интервью. Агент не просто генерирует текст, а задает вам вопросы, исследует кодовую базу и в итоге создает PRD прямо в GitHub Issues.

Если у вас уже есть описание задачи, но вы не знаете, с чего начать, поможет prd-to-plan. Он разбивает документ на «вертикальные срезы» (tracer-bullet slices). Это когда вы реализуете функционал по кусочкам, от базы данных до фронтенда, чтобы как можно раньше получить рабочую версию.

А мой любимый инструмент — grill-me. Если вы придумали дизайн системы, запустите этот скилл. Агент начнет «допрашивать» вас, пока не закроет все белые пятна в логике. Это отличный способ найти баги еще до того, как написана первая строчка кода.

Разработка в режиме TDD

Для тех, кто практикует (или хочет начать) Test-Driven Development, есть навык tdd. Он настраивает цикл «красный — зеленый — рефакторинг». Агент сам пишет тест, проверяет, что тот падает, пишет код для прохождения теста и причесывает результат.

Еще одна полезная штука — triage-issue. Если прилетел баг-репорт, этот скилл заставляет агента залезть в код, найти причину и составить план исправления на основе того же TDD. Это экономит кучу времени на контекстном анализе.

Полезные мелочи для терминала

Кроме тяжеловесных штук для архитектуры, в репозитории есть чисто утилитарные вещи:

• setup-pre-commit: быстро настраивает Husky, Prettier и линтеры.
• git-guardrails-claude-code: вешает хуки, которые запрещают ИИ выполнять опасные команды вроде git push или git reset --hard без вашего ведома.
• obsidian-vault: если вы ведете заметки в Obsidian, этот навык позволяет агенту искать по вашей базе знаний и создавать новые записи.

Как это использовать на практике

Все навыки добавляются через npx. Например, если вам нужно спроектировать интерфейс модуля, вы запускаете:

npx skills@latest add mattpocock/skills/design-an-interface

После этого ваш ИИ-агент (например, Claude Code) получает инструкции, как генерировать несколько радикально отличающихся вариантов дизайна параллельно.

Стоит ли пробовать

Проект mattpocock/skills точно пригодится тем, кто уже плотно интегрировал ИИ в свой воркфлоу и устал от однотипных промптов.

Кому особенно зайдет:

• Тимлидам, которым нужно быстро накидывать черновики документации.
• Разработчикам-одиночкам, которым не хватает «об кого подумать» (тут выручит grill-me).
• Тем, кто хочет автоматизировать рутину вроде настройки конфигов или миграции тестов.

Из минусов — проект заточен под экосистему Claude и TypeScript/JavaScript. Если вы пишете на Go или Python, часть навыков (например, миграция на shoehorn) будет бесполезна, но логика планирования и проектирования все равно останется актуальной.

В целом, это отличный пример того, как промпт-инжиниринг превращается в конкретные инструменты, которые можно потрогать руками и встроить в терминал. Ссылка на репозиторий: mattpocock/skills.