Глубокое погружение в ИИ

Глубокое погружение в навыки от Matt Pocock: небольшие агентские навыки для реальной инженерной работы

Репозиторий `skills` от Matt Pocock — это компактная коллекция навыков агента для практической инженерной работы: составление плана, написание документации, выполнение TDD, диагностика багов, улучшение архитектуры, приоритизация задач, разбиение работы на задачи, создание PRD, передача дел и настройка проекта.

Обновлено в июне 2026 г.
Главное изображение руководства по навыкам Matt Pocock с компактными карточками инженерных навыков для TDD, диагностики, документации, архитектуры, сортировки, PRD и передачи дел

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

Get the latest on AI, LLMs & developer tools

New MCP servers, model updates, and guides like this one — delivered weekly.

Редакционная заметка

Эта статья основана на GitHub репозитории, README, файлах навыков, скриптах настройки, документации, текущих issue и PR, списке skills.sh, ссылке на рассылку и публичных метаданных GitHub, собранных 2 июня 2026 года. Точные счетчики популярности опущены, так как они быстро меняются.

1. skills в одном предложении

Репозиторий `skills` от Matt Pocock — это набор небольших, адаптируемых навыков рабочего процесса AI-агента с лицензией MIT для реальных задач разработки ПО, таких как TDD, диагностика, уточнение продукта, документирование, улучшение архитектуры, приоритизация задач и передача дел.

ОбластьДеталиПочему это важно
Репозиторийmattpocock/skillshttps://github.com/mattpocock/skills
Основной языкShellОсновной язык GitHub на момент исследования.
ЛицензияMITПри необходимости отдельно проверьте лицензии встроенных или бинарных компонентов.
Создано3 февраля 2026 г.Во время исследования релизы GitHub не найдены; основная ветка и issues активны.

2. Почему это важно

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

Вместо одной огромной методологии эти навыки представляют собой узкоспециализированные инструменты. Вы можете запустить `/grill-with-docs` перед реализацией функции, `/tdd` во время реализации, `/diagnose` при работе с багом, `/improve-codebase-architecture` после накопления энтропии и `/handoff` при необходимости передачи контекста.

Инженерный подход также примечателен: README отвергает расплывчатое «vibe coding» и подчеркивает фундаментальные основы, такие как общий язык, red-green-refactor, маленькие шаги, обратная связь, глубокие модули и ответственное проектирование.

3. Архитектура и ментальная модель

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

ОбластьДеталиПочему это важно
Установщик`npx skills@latest add mattpocock/skills`Основной путь настройки README через skills.sh.
Настройка навыка`setup-matt-pocock-skills`Фиксирует трекер задач, метки и расположения документации, используемые другими навыками.
Планирование`grill-with-docs`, `grill-me`, `to-prd`, `to-issues`Уточняет намерения, предметные термины, решения, PRD и фрагменты задач.
Реализация`tdd`, `diagnose`, `prototype`Улучшает циклы обратной связи, дисциплину отладки и исследовательское проектирование.
Архитектура`improve-codebase-architecture`, `zoom-out`Находит проектное давление, возможности для углубления и более широкий контекст кода.
Операции`triage`, `handoff`, `git-guardrails-claude-code`, `setup-pre-commit`Поддерживает состояние задач, передачу контекста и более безопасные рабочие процессы в репозитории.
ДокументацияФорматы `CONTEXT.md`, `docs/adr/`, `grill-with-docs`Общий язык и записи о принятых архитектурных решениях являются первоклассными объектами.
Скрипты`scripts/link-skills.sh`, `scripts/list-skills.sh`Локальные помощники оболочки для перечисления и связывания навыков.

4. Минимальная end-to-end настройка

Команды ниже взяты из документации репозитория и сверены с текущим исследовательским снимком. Используйте их как отправную точку, а затем прочитайте связанную README перед установкой в production.

# Install through skills.sh
npx skills@latest add mattpocock/skills

# In your agent, select the skills you want.
# Include setup-matt-pocock-skills.

# Then run the setup skill once per repository:
/setup-matt-pocock-skills

Небольшая первая задача должна подтвердить интеграцию, прежде чем подключать ее к критичным данным или большим рабочим пространствам.

# Clarify a feature and update docs/ADRs
/grill-with-docs

# Build the change with a red-green-refactor loop
/tdd

# Diagnose a hard bug
/diagnose

# Break a plan into independently grabbable issues
/to-issues

# Hand off a session to another agent or future context
/handoff

5. Технический разбор

5.1 Навык настройки — это тихая зависимость

В README сказано выбрать `/setup-matt-pocock-skills` во время установки и запустить его перед остальным инженерным рабочим процессом. Это не пустая работа. Он записывает выбор трекера задач, метки сортировки и расположение документации, чтобы такие навыки, как `to-issues`, `triage` и `grill-with-docs`, могли работать предсказуемо.

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

5.2 Grilling — это инструмент формирования требований

`grill-me` и `grill-with-docs` построены на простом наблюдении: пользователи часто не знают точно, чего они хотят, пока им не зададут вопросы. Этот навык заставляет агента задавать конкретные вопросы перед написанием кода.

`grill-with-docs` расширяет это до общего языка и ADR. Это особенно полезно в реальных продуктах, поскольку доменные термины сокращают многословные объяснения и улучшают имена, тесты и заголовки задач.

before coding:
  ask hard questions
  define domain terms
  record decisions
  narrow scope
  then implement

5.3 TDD и диагностика создают циклы обратной связи

`/tdd` подталкивает агентов к red-green-refactor и меньшим вертикальным срезам. `/diagnose` подталкивает к воспроизведению, минимизации, выдвижению гипотез, инструментированию, исправлению и регрессионному тестированию.

Эти навыки сами по себе не делают модель умнее. Они меняют цикл взаимодействия с моделью, чтобы она получала более качественные данные перед внесением правок и лучше проверяла результат после них.

5.4 Работа с архитектурой рассматривается как ответственное проектирование.

`improve-codebase-architecture` предназначен для кодовых баз, которые становится сложно изменять. В README он связывается с такими идеями, как глубокие модули, предметно-ориентированный язык и ежедневные инвестиции в проектирование.

Это правильный уровень амбиций для навыка агента: не «переписать приложение», а проанализировать нагрузку на дизайн, уточнить интерфейсы и создать конкретные возможности для углубления архитектуры.

5.5 Репозиторий намеренно не является монолитом.

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

Текущая поверхность PR и задач показывает, что границы все еще формируются: разделение команд и навыков, улучшение вывода `/teach`, документация вне рабочих деревьев, поведение при декомпозиции задач и настройка частоты вывода.

6. Реальные паттерны: неверно vs верно

НеверноВерноПричина
Установите все навыки и надейтесь, что агент знает ваш репозиторий.Запустите `/setup-matt-pocock-skills` и настройте систему отслеживания задач, метки и пути к документации.Некоторые навыки зависят от локальных соглашений.
Используйте `/tdd` в качестве метки для написания тестов постфактум.Используйте его для red-green-refactor на небольших вертикальных срезах.Ценность заключается в цикле обратной связи, а не только в тестовых файлах.
Запрашивайте улучшение архитектуры без документации по домену.По возможности сначала создавайте общий язык и ADR.Анализ архитектуры улучшается, когда агент понимает язык продукта.
Рассматривайте их как полноценный агентный фреймворк.Рассматривайте их как компонуемые инструменты процесса.Репозиторий намеренно сделан небольшим и адаптируемым.

7. Частые ошибки и текущие проблемы

Issue tracker важен, потому что эти репозитории молоды и быстро меняются. В статье issues используются как сигналы риска, а не как доказательство непригодности проекта.

ОбластьДеталиПочему это важно
Команды против навыковPR #291 отслеживает разделение навыков на команды и навыки.Семантика упаковки все еще дорабатывается.
Обучение навыкуВ Issue #296 запрашивается улучшенное руководство по дереву и иерархическим диаграммам.Некоторые навыки в процессе разработки все еще развиваются.
Расположение документацииВ Issue #294 запрашивается документация вне рабочего дерева для `grill-with-docs`.Рабочие процессы с документацией между рабочими деревьями требуют осторожности.
Декомпозиция задачВ Issue #292 говорится, что родительские задачи остаются доступными для выбора после декомпозиции.Рабочие процессы `to-issues` могут потребовать ручной очистки.
Передача архитектурыВ Issue #290 запрашивается добавление кнопок передачи на страницах сгенерированной архитектуры.Сгенерированные отчеты становятся артефактами рабочего процесса.
Частота выводаВ Issue #284 рассматривалась частота вывода `grill-with-docs`.Навыки проведения интервью требуют темпа, соответствующего пользователю.

8. Заметки о производительности, масштабировании и стоимости

Эти навыки в основном связаны с текстом и процессами, поэтому стоимость выполнения зависит от агента и размера репозитория, а не от тяжелой локальной сборки. Основные затраты токенов приходятся на длительные сессии опроса, анализ архитектуры, декомпозицию задач и многократное чтение кодовой базы.

Практический способ контроля расходов — выбор узкоспециализированных навыков. Используйте `/diagnose` для одного бага, `/tdd` для одного фрагмента, `/to-issues` для одного плана и `/handoff` для случаев, когда контекст необходимо сжать.

Ценность репозитория растет: общий язык, ADR, фрагменты задач и передача результатов уменьшают будущую неопределенность, что может сэкономить больше токенов, чем затраты на начальную сессию.

9. Для кого это

Используйте, еслиПропустите, если
Вам нужны агентские рабочие процессы, которые сохраняют инженерную дисциплину.Вам нужен автономный фреймворк, который берет на себя весь процесс целиком.
Вы используете Claude Code, Codex или совместимые агенты, понимающие навыки.Ваш инструментарий не может загружать или адаптировать рабочие процессы `SKILL.md`.
Ваша команда ценит TDD, дисциплину отладки, ADR и порядок в задачах.Вам нужно только быстрое однократное создание кода.
Вам удобно адаптировать небольшие навыки под соглашения вашего репозитория.Вам нужен полностью хостируемый, строго структурированный продукт для управления проектами.

10. Сигнал сообщества

Самый сильный сигнал сообщества — это существующая аудитория мейнтейнера в области TypeScript и AI-инженерии. README направляет людей через skills.sh и большую аудиторию рассылки AI Hero, что обеспечивает репозиторию мгновенное распространение.

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

Концепция репозитория приятно приземленная: он утверждает, что при работе с агентами основы важны как никогда.

11. Вердикт: стоит ли использовать?

Наш вывод

Используйте навыки Matt Pocock, если вам нужны небольшие, компонуемые рабочие процессы агентов, которые делают планирование, тестирование, диагностику, архитектуру, сортировку задач и передачу дел более дисциплинированными. Пропустите их, если вам нужен автономный фреймворк «в один клик» или репозиторий, скрывающий инженерный процесс за одной командой.

12. Общая картина

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

По мере того как AI-кодинг ускоряется, «узким местом» становятся суждения, ограничения, обратная связь и удобство сопровождения. Подобные небольшие навыки — один из способов внедрить эти инженерные привычки непосредственно в рабочий процесс агента.

13. Частые вопросы

В: Как установить навыки Matt Pocock?

В README рекомендуется `npx skills@latest add mattpocock/skills`, затем выбор нужных навыков и запуск `/setup-matt-pocock-skills`.

В: Работают ли они только с Claude Code?

Они написаны как агентные навыки и могут быть адаптированы для совместимых кодинг-агентов, поддерживающих навыки. Точное поведение при установке зависит от вашего агента и поддержки skills.sh.

В: С какого навыка мне начать?

Начните с `/setup-matt-pocock-skills`, затем используйте `/grill-with-docs` для новых функций, `/tdd` для реализации и `/diagnose` для исправления ошибок.

В: Что делает `/grill-with-docs`?

Он задает подробные вопросы о планируемых изменениях, формирует общий предметный язык, а также может обновлять контекстную документацию и ADR.

В: Является ли `/tdd` просто генерацией тестов?

Нет. Это рабочий процесс red-green-refactor для реализации небольших вертикальных срезов с четким циклом обратной связи.

В: Являются ли они заменой управлению проектами?

Нет. Такие навыки, как `/to-issues`, `/triage` и `/to-prd`, могут интегрироваться с рабочими процессами по задачам, но они не заменяют суждения команды или ответственность за процессы.

14. Глоссарий

ОбластьДеталиПочему это важно
НавыкПовторно используемый рабочий процесс `SKILL.md` для агента.Основной артефакт репозитория.
Глубокий опросСтруктурированное анкетирование перед реализацией.Используется для уменьшения двусмысленности требований.
Общий языкСпециализированная предметная лексика проекта.Хранится в документах, таких как `CONTEXT.md`.
ADRЗапись архитектурных решений (Architecture Decision Record).Фиксирует важные технические решения.
Red-green-refactorНапишите неработающий тест, добейтесь его прохождения, улучшите дизайн.Основной цикл TDD.
Глубокий модульМодуль с простым интерфейсом и значительной внутренней глубиной.Концепция качества архитектуры.
Передача (Handoff)Структурированная передача контекста для будущей сессии или агента.Снижает потерю контекста.

15. Все источники и ссылки

Внутренние ссылки

16. Таблица атрибуции источников

ОбластьДеталиПочему это важно
READMEПозиционирование, процесс установки, основные формулировки проблем, карта навыков.Первоисточник.
Файлы навыковКонкретное поведение для настройки, гриллинга, TDD, диагностики, архитектуры, проблем и передачи задач.Первичный источник.
Скрипты и документацияЛокальное связывание, листинг, контекстная документация, форматы ADR.Источник структуры репозитория.
Issues и PRУпаковка команд, путь к документации, обучение, декомпозиция задач и примечания по настройке.Сигнал актуальности.
skills.shКанал распространения и описание установки.Официальный источник экосистемы.

Related Guides