AI

AspireでAIが文書草案を自動作成、82件を人のレビューで反映

この記事のポイント

  1. 実現したこと

    開発ツールAspireでは、製品変更から別リポジトリの文書草案を自動作成できるようになった。

  2. 実現の仕組み

    コード差分と関連Issueをエージェントが読み、事前に決めた更新先へ文書草案を用意する。

  3. 得られた結果

    開発担当者の30日間の集計では、作成した文書の変更提案82件がすべてマージされた。

  4. 従来との違い

    文書担当者が変更を後から調べる流れから、AIの草案を元の機能の承認者が確認する流れへ切り替えた。

明るい作業机で、コード変更と関連Issueを表す書類からノートPCを通じて別の文書バインダーへ草案が渡り、技術者が鉛筆を持って内容を確認している編集イラスト。
AI生成画像

製品コードの変更を読み、別リポジトリに文書草案を作る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時間だった。