Поручить агенту подключение GitHub, бриф, скиллы Matt Pocock, трекер и файл инструкций и проверить настройку новой сессией.
Чему научишься
•Поручать агенту настройку проекта через результат, а не через команды.
•Хранить один набор скиллов и инструкций в проекте и подключать к нему выбранного агента.
•Проверять настройку новой сессией агента.
Содержание · 8ОткрытьСкрыть
В этом материале разберём, как поручить агенту подготовку проекта вместе с harness и как убедиться, что новая сессия найдёт всё сама.
Зачем поручать настройку агенту
Подготовка проекта состоит из множества мелких действий. Нужно создать репозиторий и связать его с папкой, сохранить бриф, установить скиллы, настроить трекер и записать инструкции. Детали зависят от твоей системы и выбранного агента. Агент выяснит их сам: какая у тебя операционная система, где лежат нужные папки и как твой агент подключает скиллы. От тебя нужно назвать результат и проверить его. Поэтому команды набирать не нужно, достаточно попросить агента.
Начни с пустой папки проекта и запусти агента в ней. От папки запуска зависит, где появится настройка.
Как подключить GitHub
С GitHub агент удобнее всего работает через GitHub CLI. Попроси агента подключить GitHub целиком, например так:
Подключи GitHub: войди в мой аккаунт через GitHub CLI, создай репозиторий
ai-dev-platform и свяжи с ним эту папку.
Если GitHub CLI не установлен, агент может установить его сам. При входе он покажет одноразовый код и ссылку на страницу GitHub. Код и подтверждение ты вводишь в браузере. Если GitHub CLI спросит, входить ли с ним и в Git, соглашайся, чтобы агент смог отправлять в GitHub все изменения, включая настройку CI. Пароли, коды и токены в чат не вставляй, потому что агенту они не нужны. После входа агент сам создаёт репозиторий, задачи и pull request.
Бриф в проекте
Бриф заказчика содержит требования, по которым ты строишь платформу. Скачай бриф по ссылке из задания и передай агенту:
Вот техническое задание, которое я получил. Сохрани его в проекте,
чтобы дальше мы работали по нему.
Агент сам выберет место, например docs/brief.md. Важно, чтобы бриф лежал в репозитории, тогда его найдёт любая сессия, а не только та, которой ты его показал.
Скиллы Matt Pocock
Matt Pocock выложил в открытый доступ набор скиллов для разработки с агентом. Набор покрывает весь путь работы: агент расспрашивает тебя о том, что нужно сделать, пишет спецификацию, то есть описание согласованного результата, и делит её на задачи в трекере и выполняет их. Дальше ты работаешь по этому набору. Каждый скилл отвечает за один шаг, поэтому его удобно прочитать и понять отдельно от остальных.
Скиллы и инструкции я держу в каждом проекте, а не в одной огромной системе на все проекты. Так каждый проект получает только то, что ему нужно, и правка одного проекта не ломает другие.
Одна папка для разных агентов. Разные агенты ищут скиллы в разных папках. Многие, например Codex, читают общую папку .agents/skills, а у некоторых есть своя: Claude Code ищет скиллы в .claude/skills. Чтобы не держать две копии, скиллы кладут в общую папку, а в папке своего агента ставят ссылку на неё. Тогда агенты, которые читают общую папку или ссылку на неё, работают с одним набором. Попроси агента так:
Установи скиллы Matt Pocock из github.com/mattpocock/skills в этот проект,
а не в мои глобальные настройки. Возьми опубликованные engineering и
productivity, включая setup-matt-pocock-skills, без папки in-progress.
Положи скиллы в общую папку .agents/skills, а если ты читаешь скиллы
из своей папки, сделай в ней ссылку на общую. Запиши источник и коммит.
У набора есть свой установщик, и агент запустит его сам. Для Claude Code набор есть и плагином, то есть дополнением, которое агент устанавливает целиком. Но плагин обновляется сам и в проекте не лежит, поэтому нужна копия в файлах проекта. Если плагин у тебя уже стоит, попроси агента удалить его, иначе каждый скилл окажется в двух экземплярах. На Windows ссылки в Git работают плохо, поэтому там вместо ссылки подойдёт копия.
Запись об источнике может выглядеть так:
Источник: https://github.com/mattpocock/skills, ветка main, коммит d81f3a1 от 29.09.2026.
Скопированы скиллы из skills/engineering и skills/productivity. Файлы не менялись.
Обновление: заменить папки копией с нового коммита, записать его здесь, посмотреть git diff.
По такой записи через месяц понятно, что именно стоит в проекте и чем оно отличается от свежей версии набора. Записывай коммит, а не ветку или номер релиза, потому что ветка со временем меняется. Установщик набора записывает в файл skills-lock.json источник и контрольную сумму файлов, но не коммит. Поэтому коммит набора всё равно запиши отдельной строкой.
Набор устанавливают целиком, но изучать каждый скилл сразу не нужно. Сейчас ты вручную запускаешь setup-matt-pocock-skills для настройки трекера. А writing-for-agents агент подключает при работе над файлом инструкций. Остальные скиллы понадобятся в задании «Заложи основу проекта».
Трекер задач
Трекер хранит описание и состояние задач. Скиллам набора нужно знать, где он находится. Для этого в наборе есть скилл setup-matt-pocock-skills. Скилл помечен для запуска вручную, поэтому вызываешь его ты. В Claude Code для этого есть команда /setup-matt-pocock-skills, в Codex $setup-matt-pocock-skills. Скилл изучит репозиторий, предложит варианты и задаст несколько вопросов:
Где вести задачи. Выбери GitHub Issues этого репозитория.
Оставить ли стандартные пометки задач. Соглашайся. Пометки (labels) показывают состояние задачи: например, задача ждёт уточнения или готова для агента.
Какой файл инструкций создать. Выбери AGENTS.md. Скилл спросит об этом, только если файла инструкций ещё нет.
Скилл запишет в docs/agents/ настройку трекера, пометок и места для документов проекта. Скилл triage разбирает задачи и назначает им пометки. Если установлен triage и ты согласовал пометки, setup-matt-pocock-skills создаст недостающие пометки в GitHub. После настройки проверь с агентом, что пометки из настройки есть в репозитории, например ready-for-agent. Если создание не удалось, попроси завершить его. В файл инструкций setup-matt-pocock-skills допишет раздел ## Agent skills со ссылками на эти настройки. Если в проекте есть CLAUDE.md, скилл допишет раздел в него, а не в AGENTS.md.
Файл инструкций
AGENTS.md читают почти все агенты, поэтому он служит точкой входа. Агент начинает с него и по указателям находит остальное. Файл короткий, потому что агент читает его в каждой сессии и всё лишнее только занимает контекст. Пока в файле достаточно трёх сведений: что это за проект, где лежат бриф и скиллы и кто что решает. Требования брифа задаёт заказчик, а инженерные решения принимаешь ты вместе с агентом. Такое разделение стоит записать, иначе агент может принять формулировки брифа за готовые технические решения. Попроси агента применить writing-for-agents и проверить каждую строку. Если её удалить, изменится ли работа агента? Такой вопрос помогает оставить только нужные указания. Файл может выглядеть так:
# Платформа командной разработки
Создаём платформу, на которой компания работает с агентами по общим правилам.
Бриф заказчика лежит в docs/brief.md, читай его перед планированием.
Требования в брифе задаёт заказчик. Технологии, архитектуру и хранение данных
выбираем мы и записываем решения в проекте.
Скиллы лежат в .agents/skills, источник и версия в .agents/skills/UPSTREAM.md.
## Agent skills
(раздел, который дописал setup-matt-pocock-skills: трекер, пометки задач, документы)
Команды запуска и проверки в файл писать не нужно, потому что агент найдёт их в скриптах проекта.
Отдельный файл для своего агента не нужен. Codex и большинство других агентов читают AGENTS.md сами. Claude Code тоже читает его сам, начиная с версии 2.1.277, но только если ни в папке проекта, ни в папках выше нет CLAUDE.md, .claude/CLAUDE.md или CLAUDE.local.md. Личный ~/.claude/CLAUDE.md этому не мешает. Если в проекте есть CLAUDE.md, Claude Code читает его вместо AGENTS.md. Тогда в CLAUDE.md должна быть одна строка:
@AGENTS.md
Claude Code подставит на место этой строки содержимое AGENTS.md. Просьба словами «прочитай AGENTS.md» не обеспечивает загрузку файла в начале сессии. Для этого в CLAUDE.md используют импорт @AGENTS.md. Так правила живут в одном файле, и при смене агента их не придётся переписывать.
После всей настройки проект может выглядеть так. Названия папок зависят от выбранного агента.
ai-dev-platform/
├── AGENTS.md # инструкции для любого агента
├── .agents/
│ └── skills/ # копия набора скиллов
│ ├── grill-with-docs/
│ ├── to-spec/
│ ├── ... # остальные скиллы
│ └── UPSTREAM.md # откуда и с какой версии сделана копия
├── .claude/
│ └── skills # ссылка на .agents/skills для Claude Code
└── docs/
├── brief.md # бриф заказчика
└── agents/ # настройки набора: трекер, пометки задач, документы
Как проверить настройку
Агент проверяет настройку и в текущей сессии, но этого мало. Он только что всё настроил и помнит, где что лежит. Новая сессия этого разговора не знает и должна найти настройку по файлам и ссылкам.
Поэтому закрой текущую сессию и открой новую в папке проекта. Спроси агента, что это за проект, где лежит бриф и где вести задачи. Скиллы проверь списком команд агента, например в Claude Code набери /. Сравни ответ с тем, что вы с агентом настроили.
Если агент чего-то не нашёл, обычно в инструкциях нет ссылки на нужный файл или ссылка ведёт не туда. Попроси его исправить инструкции и повтори проверку в новой сессии. Настройка готова, когда новая сессия называет всё перечисленное без подсказок из чата.
Проверьте понимание
В проекте есть AGENTS.md и бриф в docs/brief.md. Новая сессия в папке проекта на вопрос «где лежит бриф» отвечает, что брифа в проекте нет. Что поправить, чтобы его находила любая следующая сессия?
1.
Указать путь к брифу в AGENTS.md.
2.
Указать путь к брифу в первом запросе новой сессии.
3.
Указать путь к брифу в сессии, которая всё настроила.
В задании «Заложи основу проекта» ты впервые ведёшь по этим скиллам работу от вопросов до слитого pull request. В главе 2 по ним идёт первая версия платформы.