Два репозитория и агент: автодоки Aspire через GitHub Agentic Workflows

Агент читает diff в продуктовом репозитории и создаёт черновик pull request с документацией в отдельном docs-репозитории.

За релизы Aspire 13.3 и 13.4 команда из десяти человек смержила 82 pull request с документацией — медиана от продуктового PR до черновика на aspire.dev составила 44,8 часа. Каждый черновик ревьюил инженер, который принимал фичу; отдельного техписа на каждый апдейт не потребовалось.

Раньше цикл был предсказуемым: фича уезжает, техпис через недели открывает закрытый PR, пингует автора — тот уже на следующей задаче. Кросс-репозиторная автоматизация буксовала на безопасности: широкие токены на весь org не пройдут ревью. GitHub Agentic Workflows от GitHub Next описывают workflow в markdown с промптом, компилируют в обычные Actions, а агент на рантайме в GitHub напрямую не пишет.

Запись через safe-outputs

Агент отдаёт JSON с намерением — какие pull request, issues и комментарии создать. Отдельный job safe-outputs handler материализует это через GitHub App с узкой областью: только репозитории aspire и aspire.dev, ветки main и release/*. Файлы вроде AGENTS.md и манифестов заблокированы. Если создание PR падает — фреймворк заводит issue, чтобы намерение не пропало.

Workflow pr-docs-check

Срабатывает на смерженный pull request в main или release/* в microsoft/aspire.
Bash по milestone PR или связанным issues выбирает целевую ветку docs — например release/13.4.
Агент читает diff и решает, нужна ли пользовательская документация; если да — черновит в checkout aspire.dev.
Safe-output создаёт draft PR с префиксом [docs] и лейблом docs-from-code; ревьюер — тот же SME, что одобрял фичу.

За 30 дней workflow отработал 396 раз — по одному на каждый смерженный продуктовый PR. 82 раза появился черновик документации, в остальных ~300 агент ответил «доки не нужны» — рефакторинги, CI, зависимости. Все 82 docs-PR дошли до мержа: 38% — в сутки, 96% — за неделю. Первую версию фильтра пришлось ужесточить: 9 из 69 PR закрыли без мержа (~13%), когда агент тянул доку на внутренние правки.

Источник: Automating cross-repo documentation with GitHub Agentic Workflows.