Litmus — 話題のニュースを、深く読み解く。 RSS
ソフトウェア

GitHubのIssueに、版管理された文書を直接添付できるようになった

GitHubが2026年10月28日、Issueに名前・専用URLと消えない版履歴を持つ文書を添付できる「Issueアーティファクト」を公開プレビューで追加した。コメントに埋もれず、計画書も自動で残る仕組みを確かめた。

ノートパソコンでコードを表示しながら、付箋にメモを書き込む手元

イメージ写真 記事の内容を撮影したものではありません。Photo by Olha Ruskykh on Pexels

この記事には Amazon アソシエイトのリンクを含みます。

コーディングエージェントにIssueで実装計画を書かせると、同じ主題のまま少しずつ内容が変わりながら、新しいコメントとして何度も投稿される。3回目の修正が終わったころには、どのコメントが「今の計画」なのか、スクロールして探すことになる。この面倒に対する機能が、2026年10月28日にGitHubの公式changelogで公開プレビューとして発表された。「Issueアーティファクト」と呼ばれる、名前と専用URL、編集履歴を持つ文書をIssueに直接添付できる機能だ。コメントの山に埋もれない置き場所がどんな仕組みでできているのか、使う上で今どこに注意すればよいのかを確かめた。

コメント欄との違い

Issueのコメントに計画書を貼るのと何が違うのだろうか。

コメントは投稿するたびに下へ積み上がり、同じ主題の最新版を探すにはスクロールが要る。Issueアーティファクトはこれと違い、1つの文書に名前と専用URLが付く。GitHub公式ドキュメントは「Issue artifacts are named pieces of content attached to an issue.」と定義している。コメントのように下へ積まれるのではなく、Issueのページから直接開き、リンク1つで他の人と共有できる独立した対象になる。

似た名前のGitHub Actionsの実行結果「Actionsのartifact」とは別物だ。GitHub CLIのマニュアルもそう注記している。取得するコマンドも分かれており、Actionsの成果物はgh run download、Issueアーティファクトはgh issue artifact downloadを使う。

では、この文書は具体的に何種類あり、誰がどう作るのだろうか。

四種類の文書と操作手段

では、具体的にどんな文書を作れるのか。

GitHub公式ドキュメントは4種類を定義している。

種類用途
generic調査メモや設計ドキュメントなど、汎用の文書
planMarkdownで書く実装計画
linkSlack・Teamsのスレッドや外部資料への名前付きリンク
embedded_htmlインタラクティブな図やプロトタイプなど、HTMLで作る文書

このうちembedded_htmlだけは注意が要る。添付したHTMLは、そのままブラウザで実行してプレビューする仕組みになっている。公式ドキュメントによると、プレビューを開くと利用者が持ち込んだコードが実行され、内容が外部サイトへ送信される可能性があるという警告が表示される。見た目を確かめるだけのつもりで開くと、想定より踏み込んだ操作になる。

操作する手段は1つに絞られていない。

  • Web画面: Issueのページから直接作成・編集・削除できる
  • CLI: gh issue artifactのcreate・edit・list・view・download・deleteで操作する。公式ドキュメントは「Issue artifact commands require GitHub CLI 2.103.0 or later.」と、必要なバージョンを明記している
  • REST API: /repos/{owner}/{repo}/issues/{issue_number}/artifactsを起点に5つのエンドポイントがあり、APIリファレンスで確認できる
  • MCPサーバー: GitHub公式のMCPサーバーからも同じ操作ができる

人の手だけでなく、この4つの経路はAIエージェントからも使える設計になっている。実際、GitHubはこの機能をどうエージェントに使わせようとしているのだろうか。

エージェントとの関わり

ここまでは人が操作する場面を見てきたが、AIエージェントとはどう関わるのか。

GitHub公式changelogによると、GitHub AppでIssueの作業をコーディングエージェントにまかせることができる。セッション中に作った成果物は、そのIssueへ自動的に添付される。実装計画や根本原因分析、過去の経緯の要約といった具体的な文書を作るよう、セッションへ指示することもできるという。エージェントが残すメモが、コメント欄の奥ではなく、名前の付いた文書として直接Issueに積み重なっていく。

ただし、embedded_html型の作成と表示は、GitHub App側ではまだ使えない。changelogは「coming soon」と明記している。エージェントに図やプロトタイプを作らせたい場合は、今のところMarkdownの計画書やリンクにとどめる必要がある。

では、エージェントや自分がこの文書を書き直したとき、前の内容はどう扱われるのだろうか。

版はどう変わるのか

たとえば、エージェントが実装計画を3回書き直し、2回目の内容のほうが良かったので戻したくなったとする。このとき、前の版はどう扱われるのか。

公式ドキュメントは、編集するたびに版が1つ増えると説明している。ここまでは予想どおりだろう。ただし、Web画面からは昔の版に戻せない。公式ドキュメントは「You cannot restore a version in the web interface.」と明記しており、復元はCLIからしかできない。

自分はここで一度立ち止まった。「復元」という言葉から、過去の状態に上書きして戻る動作を想像していたからだ。実際の挙動は逆だった。公式ドキュメントは、復元すると古い版の名前と内容が「a new version」として保存され、完全な履歴が保たれると説明している。古い版の内容を複製した新しい版が一番新しい位置にもう1つ追加されるだけで、過去の版の位置や内容は書き換わらない。

v1v2v3v4v2の内容を複製

つまり、版は編集でも復元でも増え続けるだけで、過去の版の位置や内容が書き換わることはない。

この一方向にしか増えない設計を踏まえると、今の段階で気をつけておきたい点も見えてくる。

今気をつけたいこと

公開プレビューの段階にある今、使う前に何を確認しておくべきか。

  • 仕様が変わる可能性: 公式ドキュメントは「This feature is in public preview and is subject to change.」と明記している
  • Pull Requestには未対応: Issueアーティファクトは今のところIssue専用で、Pull Requestには付けられない。この点を尋ねられたGitHubの担当者は、Community Discussionsで「Artifacts on PRs are on our roadmap.」と回答しており、対応時期は示されていない
  • プランや環境ごとの違いは未記載: 対応プランやEnterprise環境での扱いは、今回確認した公式ドキュメント・changelogのいずれにも記載がなかった。社内で使う前に、自分のリポジトリのIssueページに実際に機能が表示されるかを確かめるとよい

まとめ

Issueアーティファクトは、名前と専用URL、消えない版履歴を持つ文書をIssueに直接添付できる機能で、2026年10月28日に公開プレビューとして始まった。generic・plan・link・embedded_htmlの4種類があり、Web画面・CLI・REST API・MCPサーバーから操作できる。コーディングエージェントがセッション中に作った計画書も、自動でそこに残る。

編集しても復元しても版が1つ増えるだけで、過去の版が上書きされることはない。公開プレビューのため仕様は変わる可能性があり、Pull Requestにはまだ対応していない。それでも、コメント欄を長く遡らなくても、今の計画書に専用URLから直接たどり着けるようになった。

この記事の先を読む本を探す

特定の本を勧めるものではありません。検索結果から、いまの版と目次を確かめて選んでください。

コメント

気づきや感想をどうぞ

記事への補足や、読んで考えたことをお寄せください。個人情報や、他の人を傷つける内容の投稿はお控えください。

コメントを読み込んでいます…

    ほかの記事

    最新の記事 →