製品コードの変更を読み、別リポジトリに文書草案を作るAI自動化が、開発ツールAspireで稼働している。書き込みは権限を限定した別ジョブに分離し、内容は技術者がレビューする。開発担当者の集計では、30日間に作成した文書の変更提案82件がすべてマージされた。
製品のマージを文書更新の起点にする
分散アプリケーション向け開発ツールAspireの開発担当者は、製品と文書を別々に管理する構成にAIによる文書生成を組み込んだ。製品コードはmicrosoft/Aspire、文書はmicrosoft/Aspire.devに置かれており、自動化はこの境界をまたいで動く。
処理の起点は、製品側のmainまたはrelease/*を対象とするプルリクエストのマージだ。単にプルリクエストを閉じただけでは起動せず、製品へ取り込まれた変更を文書更新の判断へ渡す。
更新先を確定してからAIに差分を渡す
文書をどのブランチへ反映するかは、エージェントの起動前に決める。製品側プルリクエストのマイルストーンを優先し、なければ関連Issueのマイルストーン、リリース用のベースブランチを順に調べ、いずれも使えなければmainを選ぶ。
更新先が決まると、エージェントはコード差分と関連Issueを読み、文書更新が必要かを判断する。必要な場合は文書リポジトリの作業領域で既存の執筆規約に沿って草案を作り、その内容を変更提案として渡す。
草案の生成とGitHubへの書き込みを分ける
この自動化を支えるGitHub Agentic Workflowsでは、エージェントがGitHubへ直接書き込まず、実行したい操作をJSONで出力する。書き込み要求はsafe outputsと呼ぶ仕組みで受け渡し、別の権限を限定したジョブが実際の操作を行う。
Aspireの構成では、GitHub Appの対象を製品と文書の2リポジトリに絞っている。文書のプルリクエストを作成できる更新先もmainまたはrelease/*に制限し、草案を生成する判断と、許可された場所へ反映する処理を分離している。
機能の承認者が確認し、82件をマージ
作成する文書プルリクエストはドラフトに固定し、自動マージは行わない。レビューは元の機能を承認した技術者に依頼し、従来のように文書担当者が変更を後から調べる流れから、AIが用意した草案を機能の承認者が確認する流れへ切り替えた。
Aspireの開発担当者の集計では、2026年5月3日から6月2日の30日間に作成した文書プルリクエスト82件は、すべてマージされた。製品側プルリクエストのマージから文書側のマージまでの時間は、中央値44.8時間だった。