GitHub Agentic Workflow (.md) Validator
Проверить сразу несколько .github/workflows/*.md файлов агентских workflow перед компиляцией в Actions YAML.
Как это работает
11 июня 2026 года GitHub Agentic Workflows вышел в публичное превью — новый способ описывать автоматизацию не в YAML, а обычным markdown-текстом на естественном языке, который GitHub сам компилирует в стандартный Actions YAML. Задача триажа issue или анализа CI-фейла описывается прозой, а не YAML-синтаксисом с условиями и матрицами. GitHub Agentic Workflow (.md) Validator online проверяет сразу несколько таких файлов на структурные проблемы, прежде чем полагаться на автоматическую компиляцию в реальном репозитории.
Формат буквально появился шесть недель назад, поэтому официального линтера для него ещё нет ни у кого, а команды, начинающие внедрять agentic workflows сразу в нескольких репозиториях организации, быстро упираются в вопрос — как проверить десяток .md файлов на согласованность структуры, не открывая каждый по отдельности и не дожидаясь реального запуска в CI, где ошибка обнаружится дороже.
Инструмент принимает несколько файлов сразу (разделёнными пустой строкой, как и другие batch-инструменты сайта) и проверяет базовую структуру каждого: наличие заголовка с описанием задачи, чёткую формулировку триггера выполнения, и отсутствие противоречивых инструкций внутри одного файла — то, что реально мешает предсказуемой компиляции в Actions YAML.
Частые вопросы
Чем GitHub Agentic Workflows отличается от обычного .github/workflows/*.yml?
Обычный workflow пишется прямо в YAML с явным синтаксисом условий, шагов и матриц, а agentic workflow описывается на естественном языке в markdown, и GitHub сам компилирует этот текст в эквивалентный YAML — человек не пишет YAML руками вообще.
Проверяет ли инструмент, что markdown реально скомпилируется без ошибок?
Нет, это не полноценный компилятор, а проверка базовой структуры и распространённых проблем формулировки, реальную компиляцию стоит всё равно проверить через официальный механизм GitHub перед боевым использованием.
Зачем проверять сразу несколько файлов batch-режимом?
Организации, внедряющие agentic workflows сразу в нескольких репозиториях или командах, обычно хотят единообразную структуру файлов, а не проверять каждый вручную по отдельности — пакетная проверка сразу показывает, какие файлы выбиваются из общего паттерна.
Формат ещё меняется, стоит ли полагаться на такую проверку сейчас?
Формат находится в публичном превью, а не в стабильном релизе, базовые структурные требования, которые проверяет инструмент, вряд ли кардинально изменятся, но стоит следить за официальной документацией GitHub по мере выхода из превью.