~/guides/github-agentic-workflows-markdown-to-yaml

AI Agents

GitHub Agentic Workflows: как markdown-файл компилируется в Actions YAML

Новый формат из публичного превью — автоматизация на естественном языке вместо YAML, и на что обратить внимание при первых экспериментах.

11 июня 2026 года GitHub Agentic Workflows ушёл в публичное превью — способ описывать автоматизацию CI обычным текстом на естественном языке, а не YAML-синтаксисом с условиями и матрицами. Задача триажа issue описывается прозой в markdown-файле, а компилятор GitHub сам собирает из неё эквивалентный Actions YAML.

Как это выглядит на практике

# Triage new issues

Trigger: when an issue is opened

When a new issue is opened, analyze its content and apply
the most relevant labels from the repository's label list.
Do not close issues automatically.

Файл лежит в .github/workflows/ рядом с обычными .yml-файлами, но с расширением .md. При запуске GitHub компилирует текст в реальный workflow, который переиспользует те же runner-группы и политики, что и обычные Actions.

Чем это отличается от обычного workflow

Критерий Обычный .yml workflow Agentic workflow .md
Синтаксис Явный YAML с условиями и шагами Естественный язык
Кто пишет Инженер, знакомый с YAML Любой участник команды текстом
Компиляция Не требуется, YAML выполняется напрямую Компилируется в YAML перед запуском

На что обратить внимание в первых экспериментах

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

Практический совет для команд, внедряющих формат в нескольких репозиториях

Если организация начинает использовать agentic workflows сразу в нескольких репозиториях, стоит договориться о единообразной структуре файлов заранее — иначе разные команды будут писать текст по-разному, и предсказуемость компиляции пострадает.

Как проверить сразу несколько файлов перед реальным запуском

GitHub Agentic Workflow (.md) Validator проверяет базовую структуру сразу нескольких файлов одним проходом — до того, как ошибка формулировки обойдётся дороже уже в реальном CI.

Итоговый чеклист

Agentic Workflows компилируют markdown-текст на естественном языке в обычный Actions YAML, переиспользуя существующие runner-группы и политики.

Формат в публичном превью с 11 июня 2026 года — стоит следить за официальной документацией по мере выхода из превью.

Явная формулировка триггера и отсутствие противоречивых инструкций в тексте — главные факторы предсказуемой компиляции.