Обмен практиками в команде

В любой команде есть человек, у которого агент «почему-то работает лучше». Обычно секрет в мелочах: удачная формулировка задачи, правило в AGENTS.md, навык для типовой работы, привычка проверять определённое место. Если эти мелочи остаются в его личных сессиях, команда их теряет. В этом уроке — как превратить личные находки в общие практики и не утонуть в коллекции устаревших промптов.

Что агент увидит, а что нет

Знание о работе с агентом бывает двух видов, и хранить их надо по-разному.

Знание для агента — правила, команды, соглашения, навыки. Его место в репозитории: AGENTS.md, .agents/skills/, docs/. Команда OpenAI формулирует жёстко: то, чего агент не видит в репозитории, для него не существует — решение, принятое в чате, ему так же недоступно, как новичку, который придёт через три месяца (Harness engineering).

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

Частая ошибка — смешивать: класть в AGENTS.md советы людям или держать правила для агента в вики, где он их не прочитает.

Путь находки: от сессии к стандарту

Работающий цикл выглядит так:

1. Разработчик замечает: агент снова ошибся в одном и том же, или нашёлся приём, который сильно помог.
2. Он записывает это коротко в общий канал по формату карточки практики (ниже).
3. На еженедельном разборе команда решает, во что это превратить: правило в AGENTS.md, навык, проверку в CI или просто совет людям.
4. Решение оформляется через MR с владельцем.

Пункт 3 важен: не каждая находка должна стать правилом. Документация Codex советует добавлять правила после повторяющихся ошибок, а не на всякий случай (best practices).

Карточка практики

Короткий единый формат помогает и писать, и искать:

# E2E-тест формы заявки с моком CRM

Задача: покрыть форму заявки e2e-тестом без отправки в боевую CRM.

Что сработало:
- Указать агенту готовый мок CRM: tests/e2e/mocks/crm.ts
- Попросить сначала тест, который падает без мока
- Запретить менять код формы в этой задаче

Где агент ошибался:
- Ждал ответа по таймауту вместо ожидания элемента на странице

Во что превратили:
- Правило в tests/e2e/AGENTS.md: «ожидания — только по элементам»
- Навык .agents/skills/e2e-form-test/

Автор, дата.

Карточки — материал для людей. То, что из них превратилось в правила и навыки, живёт в репозитории, а карточка лишь объясняет, откуда правило взялось.

Разбор раз в неделю

Полчаса на команду. Формат:

• одна-две удачные сессии: что за задача, как ставили, что получилось;
• одна неудача: где агент свернул не туда и почему этого не поймали раньше;
• решения: что добавить в стандарт, что удалить как устаревшее.

Показывать стоит реальную сессию, а не пересказ: именно в деталях — как сформулирован запрос, когда человек остановил агента — и прячется практика.

Между проектами и командами

В агентстве много проектов на похожем стеке, и одно и то же изобретается заново. Что помогает:

Общий репозиторий навыков. Навыки, полезные многим проектам — «посадочная из блоков», «миграция плагина», «e2e на форму», «релизная заметка», — живут в отдельном репозитории во внутреннем GitLab. Навыки можно распространять плагинами, а источником плагинов может быть git-репозиторий: в CLI есть команда codex plugin marketplace add с адресом репозитория (plugins). Учтите, что плагины работают в ChatGPT desktop и CLI, но не в расширении для IDE. Подробнее — в уроке «Плагины».

Эталонный проект. Один проект, где стандарт — AGENTS.md, навыки, ворота качества — доведён до хорошего состояния. Новые проекты копируют с него и адаптируют.

Обмен между направлениями. У веба, мобайла и QA разные задачи, но общие приёмы: как писать карточки, как проверять тесты агента, как строить ревью. Раз в месяц — общий разбор с одним докладчиком от направления.

Предостережение: копирование чужой конфигурации — не обмен опытом. Биргитта Бёкелер замечает, что делиться конфигурацией контекста агента получается лучше внутри команды, чем между незнакомыми людьми, а скопированные чужие инструкции часто переусложняют контекст и противоречат уже имеющимся (martinfowler.com). Переносите идею и проверяйте её на своём проекте, а не копируйте файлы целиком.

Роль проводников

На каждом проекте полезен человек, который чуть глубже разбирается в работе с агентом: следит за стандартом, отвечает на вопросы, приносит находки на разбор. Это не отдельная должность и не «главный по ИИ», а роль, которую можно передавать. Хорошие кандидаты — участники пилота, причём не только энтузиасты: скептик, разобравшийся в ограничениях агента, объясняет их лучше.

Чистка

Коллекция практик гниёт быстрее кода. С новыми моделями часть приёмов становится лишней, часть правил — вредной. Раз в квартал владелец стандарта проходит по карточкам, правилам и навыкам и удаляет то, что больше не нужно. Хороший вопрос для каждого правила: «что сломается, если его убрать?» Если ответ «ничего» — убирайте.