skills от Matt Pocock

Набор навыков для AI-агентов, ориентированный на реальные инженерные практики, а не на быстрое прототипирование без контроля. Включает команды для выравнивания понимания задачи, улучшения архитектуры, тестирования и управления сложностью кодовой базы. Требует первоначальной настройки под проект и не заменяет осознанного проектирования.

Категория:

Набор навыков для AI-агентов, ориентированный на реальные инженерные практики, а не на быстрое прототипирование без контроля. Включает команды для выравнивания понимания задачи, улучшения архитектуры, тестирования и управления сложностью кодовой базы. Требует первоначальной настройки под проект и не заменяет осознанного проектирования.

Набор навыков для AI-агентов, созданный Мэттом Пококом, решает четыре типичные проблемы при разработке с использованием агентов: недопонимание задачи, избыточную многословность, неработающий код и стремительное усложнение кодовой базы. В отличие от подходов, которые берут на себя управление процессом, эти навыки остаются небольшими, адаптируемыми и композируемыми — они не отнимают контроль у разработчика.

Что входит в набор

Навыки разделены на две категории: инженерные (для ежедневной работы с кодом) и продуктивности (общие рабочие процессы). По способу вызова они делятся на пользовательские (вызываются явно, например /grill-me) и модельные (могут быть вызваны автоматически агентом при подходящей задаче).

Инженерные навыки

  • grill-with-docs — сессия «допроса», которая одновременно строит доменную модель проекта, уточняет терминологию и обновляет GLOSSARY.md и ADR.
  • triage — перемещает задачи по состояниям с помощью меток, настраиваемых при установке.
  • improve-codebase-architecture — сканирует кодовую базу на предмет возможностей для углубления модулей и представляет кандидатов в виде HTML-отчёта.
  • to-spec — превращает текущее обсуждение в спецификацию и публикует её в трекере задач.
  • to-tickets — разбивает план или спецификацию на тикеты с явными зависимостями.
  • implement и implement-spec — реализуют работу по спецификации или набору тикетов, с автоматическим запуском TDD и код-ревью.
  • tdd — разработка через тестирование с циклом red-green-refactor.
  • diagnosing-bugs — дисциплинированный цикл диагностики сложных багов и регрессий производительности.
  • code-review — двухосевая проверка изменений: на соответствие стандартам кода и на точность реализации спецификации.
  • ask-matt — роутер, подсказывающий, какой навык или поток лучше подходит для текущей ситуации.
  • setup-matt-pocock-skills — однократная настройка репозитория для инженерных навыков (трекер задач, метки, расположение документации).

Навыки продуктивности

  • grill-me — relentless-интервью по плану или дизайну до полного разрешения всех ветвей дерева решений.
  • handoff — упаковывает текущий диалог в документ для передачи другому агенту.
  • teach — обучает пользователя новому навыку или концепции за несколько сессий, используя текущую директорию как состояние.
  • wait-what — мгновенная команда, если сообщение агента непонятно; агент переформулирует его с использованием глоссария проекта.

Ключевые сценарии использования

  1. Выравнивание понимания. Перед началом любой работы запускается /grill-me или /grill-with-docs. Агент задаёт уточняющие вопросы, помогая разработчику глубже продумать задачу и зафиксировать договорённости в документации.
  2. Борьба с многословностью. Через /grill-with-docs формируется общий язык (глоссарий), который агент использует для именования переменных, функций и файлов. Это сокращает количество токенов на обдумывание и делает кодовую базу более навигабельной.
  3. Обеспечение работающего кода. Навыки /tdd и /diagnosing-bugs встраивают циклы обратной связи: красный-зелёный-рефакторинг для тестов и минимизация-гипотеза-инструментирование-исправление для багов.
  4. Предотвращение «ком грязи». /improve-codebase-architecture регулярно (раз в несколько дней) исследует репозиторий и предлагает кандидатов на углубление модулей, а /to-spec заставляет задуматься о затрагиваемых модулях перед созданием спецификации.

Ограничения

  • Навыки требуют первоначальной настройки через /setup-matt-pocock-skills (выбор трекера задач, меток, путей для документации). Без этого часть инженерных навыков не сможет работать.
  • Установка различается в зависимости от агента: для Claude Code, Codex и Copilot доступны автоматически обновляемые плагины, для Gemini CLI и других сред — ручная установка и обновление.
  • Навыки не заменяют инженерное мышление. Они предоставляют повторяемые практики, но не принимают архитектурные решения за разработчика.
  • Набор не является «серебряной пулей»: он помогает снизить энтропию, но не разгребает уже существующий запутанный код.

Навыки будут полезны разработчикам, которые используют AI-агентов для серьёзной разработки и хотят сохранить контроль над процессом, качеством кода и архитектурой проекта.