Перейти к содержанию

Скил для автоматической публикации релизнотов✦

Зачем нужен скил для релизнотов✦

На онбординг-докладе про скилы (Сергей Будяев, Яндекс — отвечает за продуктовое развитие внутренних кодинговых агентов) публикация релизнотов приведена как показательный пример: рутинная экспертиза, которую стоит «скилизовать». По замеру докладчика выгода такая:

  • вручную — около 1,5 часов;
  • ad-hoc с агентом (вручную «тюкая» его на каждом шаге) — 15–20 минут;
  • со скилом — порядка 5 минут: достаточно дать ссылку на релизный тикет, и дальше агент работает сам.

Что автоматизирует скил✦

Релизноты — это не один шаг, а целая процедура, и при ручном прогоне легко что-то упустить (например, проверку грамматики) или забыть, куда класть JSON. Скил инкапсулирует весь флоу:

  1. пройти по таск-трекеру и собрать релизные тикеты;
  2. отобрать только пользовательские (отбросить технические);
  3. переформулировать в терминах пользователя, проверить грамматику и пунктуацию;
  4. перевести на английский (продукт многоязычный);
  5. собрать JSON с релизнотами прямо в коде, придумав ключи, и продублировать английскую версию;
  6. закоммитить, запушить и создать PR.

Как это устроено✦

В демо SKILL.md описывает последовательность: получить git log → прочитать инструкцию по выгрузке тикетов → взять шаблон релизнота (лежит рядом в md-файлах) → запустить скрипт публикации. Ключевая особенность — постепенная загрузка контекста (progressive disclosure): при старте агента в контекст попадает только имя и описание скила, при срабатывании — тело SKILL.md, а шаблоны и скрипты подтягиваются только в момент обращения. Это контрастирует с MCP, где все определения тулов грузятся сразу. Подход подтверждается и официальной документацией Anthropic: метаданные (~100 токенов на скил) всегда в системном промпте, тело SKILL.md — при активации, а бандл-файлы и скрипты — по необходимости; код скрипта при запуске через bash вообще не попадает в контекст, агент видит только его вывод. Благодаря тому, что способ запуска скрипта описан в SKILL.md, агенту не нужно его читать или гадать, как вызывать.

Сделать самому или взять готовое✦

Общая рекомендация внешних источников для релизнотов из Jira — поставить готовое маркетплейс-приложение (например, Released, которое «пишет черновик за секунды»). Но наш операционный вывод из доклада другой: самодостаточный скил поверх собственной интеграции с трекером кодирует именно наши сценарии, поля и нюансы (например, что теги MCP проставлять не умеет — их пишут в тело задачи), чего коробочный продукт не знает. Скил стоит заводить там, где есть своя рутинная экспертиза.

Источники✦