Об этом проекте

Skills for Real Engineers — это репозиторий Мэтта Покока, содержащий агентные навыки, используемые для повседневной разработки ПО с помощью ИИ-агентов. Он публикуется из каталога .agents автора и спроектирован как небольшой, адаптируемый, компонуемый и независимый от модели. Автор отличает их от более крупных подходов, владеющих процессом, таких как GSD, BMAD и Spec-Kit, утверждая, что те отнимают контроль у разработчика; эти же навыки, напротив, стремятся встроиться в существующие рабочие процессы. Установка предлагает два пути: плагин Claude Code устанавливает полный набор как управляемый, доступный только для чтения пакет, который обновляется автоматически, тогда как установщик skills.sh копирует редактируемые файлы навыков в проект, чтобы пользователи могли их изменять. После установки навык setup (setup-matt-pocock-skills) запускается один раз на репозиторий для настройки трекера задач (GitHub, Linear или локальные файлы), меток триажа и расположения документации. Заявленная мотивация репозитория — исправление распространённых режимов отказа кодирующих агентов: - Рассогласование между тем, что хочет пользователь, и тем, что строит агент, решается сессиями допроса, которые проверяют план до начала работы (grill-me, grill-with-docs). - Многословный вывод агента решается построением общего доменного языка, документируемого в CONTEXT.md и ADR, чтобы агенты рассуждали и общались более лаконично. - Код, который не работает, решается через циклы обратной связи: статические типы, доступ к браузеру и автоматизированные тесты, включая навык TDD red-green-refactor и поэтапный цикл diagnosing-bugs. - Деградация архитектуры решается через навыки, ориентированные на проектирование, которые поощряют глубокие модули и регулярные обзоры архитектуры кодовой базы. Навыки организованы в две основные категории: Инженерные навыки включают команды, вызываемые пользователем, такие как ask-matt (маршрутизатор по навыкам), grill-with-docs, triage, improve-codebase-architecture, to-spec, to-tickets, implement и wayfinder. Инженерные навыки, вызываемые моделью, включают prototype, diagnosing-bugs, research, tdd, domain-modeling, codebase-design, code-review, resolving-merge-conflicts и wizard. Навыки, вызываемые моделью, могут вызываться агентом автоматически, когда это уместно; навыки, вызываемые пользователем, оркестрируют рабочие процессы и могут вызывать навыки, вызываемые моделью. Навыки продуктивности, применимые за пределами кодинга, включают команды, вызываемые пользователем, такие как grill-me, handoff, teach, to-questionnaire и wait-what, а также переиспользуемый примитив интервьюирования grilling и writing-for-agents для создания документации, читаемой агентами, такой как AGENTS.md и CLAUDE.md. Автор предлагает рассылку для отслеживания изменений в навыках. Репозиторий также документирует проектные решения, включая одно о поставке в виде плагина Claude Code, в каталоге ADR. В целом это практичная библиотека повторяемых инженерных практик, закодированных в виде слэш-команд и навыков, вызываемых агентом, предназначенная для разработчиков, которые хотят больше контроля над тем, как ИИ-агенты пишут программное обеспечение.