本文へスキップ

オープンソースに届くAIのプルリクエストには、文脈が足りない

November 19, 2026

6 min read

提案されたコードと接続されたソフトウェア構成の間に、手がチェックリストと依存関係図を置き、オレンジ色の経路をつないでいる。

GitHubでマージされたプルリクエストは、2023年1月の月間2,500万件から2026年3月には月間9,000万件に増えました。GitHubは、この急増をエージェントを使ったワークフローと結びつけています。オープンソースのレビュー待ちキューに届くPRの多くには、メンテナーが受け入れを判断するための文脈がありません。たとえば、その変更がプロジェクトのルールに従っているのか、すでに誰かが送った修正と重複していないか、といった情報です。

Fatih Kadir Akınは、そうしたキューをよく知っています。GitHubで17万5,000以上のスターを集める公開プロンプトライブラリprompts.chatを作り、AutomatticのWordPressチームでデベロッパーアドボケイトを務めています。The Mergeに出演したFatihは、問題の所在をHendrik Krackにこう説明しました。

コード自体は粗悪かもしれないし、とてもよいコードかもしれません。問題は、エージェントを動かしている人が、うまく制御できていないことです。

足りないのは文脈です。エージェントも、それを使う人も文脈を示さないため、メンテナーがレビューの中で組み立て直さなければなりません。

エージェントが書いたPRに欠けているもの

prompts.chatのリポジトリにはプロンプトデータベースのCSVコピーがあり、ワーカーが毎日そのファイルを生成し直しています。CSVを手作業で編集しても、Fatihがマージした後でさえ、1日以内に変更が消えてしまいます。PRテンプレートにもCONTRIBUTING.mdにも、そのファイルを編集しないよう書かれています。それでも、エージェントはCSVを編集するPRを送り続けます。Fatihは率直に、「エージェントは気にしないんです」と言います。

AutoGPTも同じ壁にぶつかりました。貢献者向けのガイドラインやドキュメントを改善しても、何も変わりませんでした。エージェントは、参照先を示されない限り、自分からドキュメントを探しにいかないからです。

重複も問題を悪化させます。Fatihは、多くの貢献者がエージェントに未解決のIssueを示し、修正を送るよう指示しているだけではないかと考えています。その結果、すでに開かれているPRを確認しないエージェントが、一つのバグに何度も修正を送り、メンテナーはそのすべてを読むことになります。

エージェントが読む場所にルールを置く

メンテナーは、エージェントが見落とせないルールと、回避できない制限で対応しています。

  • コードのそばに指示を置く

    AutoGPTは、ルールの対象となるコードのそばにAGENTS.mdを置き、CLAUDE.mdからそのファイルを参照するようにしました。そのディレクトリで作業するエージェントが指示を読み込めるようにするためです。

  • エージェント向けの貢献ガイドを用意する

    Jesse Vincentは、SuperpowersのCLAUDE.mdとAGENTS.mdに貢献ガイドを書きました。Hendrikによると、それを無視したPRは自動的に却下されます。

  • AI利用方針を明文化する

    Home AssistantのAI利用方針は、補助としてのAIを歓迎する一方、エージェントが独自に作成したPRやIssueはクローズするとしています。プロジェクトリードのFranck Nijhofは、問題を率直に説明しています。AIによって貢献を生み出すコストは下がっても、メンテナーは一つひとつ検証しなければなりません。

  • キューに上限を設ける

    GitHubでは現在、メンテナーがPRの作成をコラボレーターに限定したり、オープンにできるPR数に上限を設けたりできます。上限の対象は、書き込み権限のないユーザーです。

Fatihは、prompts.chatに生かすため、Superpowersがどう対処しているのか詳しく調べるつもりです。現状を混乱と呼びながらも、モデルが改善されれば、エージェントもプロジェクトのルールにもっと従えるようになると期待しています。

最後にマージを承認するのはメンテナー

ルールを用意しても、誰が承認するかは変わりません。prompts.chatでは、すべてのPRをまずCodeRabbitがレビューし、大変な作業の大半を担います。Copilotが追加で確認することもあります。それでもFatihは、何かをマージする前に必ずコードを読みます。「一番の問題は、人間が承認者にならなければいけないことです。インターネット上で動くものにマージするのですから、慎重であるべきです。」

その最後の確認は、prompts.chatのPR数でも疲れる作業です。より大きなプロジェクトには、さらに多くのPRが届きます。Ryan VogelがThe Mergeに出演した当時、OpenCodeには1日あたり約200件の新しいPRが届いていました。curlのメンテナーで、長年AIが生成した報告について書いてきたDaniel Stenbergは、中には本物の欠陥を見つけるものもあるため、単に無視するわけにはいかないと言います。

量が増えることで、善意もすり減ります。PRが殺到したある時期、Fatihはコメントを残さずにPRをクローズしました。無言で閉じることが、失礼に受け取られないかと気にしています。

文脈を伝えるのは貢献者の仕事

Fatihの助言は、PRを送る側に向けられています。今、開発者が学ぶべきことを聞かれると、すぐにコミュニケーションを挙げました。以前は、どうやってChatGPTに思いどおりのことをさせるのかとよく聞かれたそうです。その答えは、まず自分は伝える人なのだ、というものでした。トルコ各地で、そして今は米国でも登壇しています。

結局は、AIエージェントとコミュニケーションを取っているんです。文脈を与える必要がありますし、文脈はコミュニケーションに関わるものです。

文脈のないメッセージが同僚にうまく伝わらないのと同じで、エージェントにも伝わりません。友人からAIではアプリを作れなかったと聞くと、Fatihは問題をきちんと説明することで、たいてい動くようにできるそうです。オープンソースへの貢献には、この力が二度必要です。エージェントには、そのプロジェクトに合う変更を書くための文脈が必要です。そしてメンテナーには、変更を信頼するために、貢献者からの文脈が必要です。

オープンソースの貢献者は、何度も同じところに行き着きます。コードを送った本人がコミュニティに参加していると、その貢献にはより重みが生まれます。Fatihもそうでした。ほぼ独学で学んだ彼にとって、GitHubは見知らぬ人がコードを読み、何が間違っているのか教えてくれる場所でした。その中には貢献者になった人もいます。地球の反対側にいる人が自分のものづくりを手伝ってくれることを、今も「魔法のようだ」と表現します。

身につけたいのは検証する力

Fatihは、以前よりもコーディングモデルを信頼しています。初期のエージェントではすべての行を確認する必要がありましたが、今は自分よりよいコードを書くと考え、アーキテクチャに時間を使っています。「部屋の中で一番賢い人でいたいわけではありません。ただ、動くものを作りたいんです。」

その信頼にも限界はあります。最近、あるモデルがJavaScriptプロジェクトの途中でRubyを書き始め、存在しないRubyファイルを探し回りました。新しく開発を始める人にFatihが身につけてほしい二つ目の力は、検証です。それは、自分でその言語を書けるかどうかとは別の話です。FatihはSwiftを知らずにiOSアプリを作ったことがありますが、それでもSwiftのコードが間違っていれば気づけます。

メモリリークが何かを知っていれば、アプリが繰り返しクラッシュするとき、エージェントにその可能性を調べさせられます。知らなければ、見えるのはクラッシュだけです。Kunal Kushwahaも同じことを述べています。基礎知識があるからこそ、エンジニアはAIツールの出力を確かめられるのです。

Fatih自身、その感覚がどこから来たのかはよくわからず、おそらく実践の積み重ねだと考えています。以前は、どう作られているのかを知るためだけに、他人のコードを読んでいました。jQueryのソースコードもすべて読んだそうです。他人のプロジェクトでエージェントを動かす人には、同じ習慣が必要です。その変更にメンテナーの時間を使う価値があるかどうかは、変更を読んでこそわかるからです。

対談の全編を見る

このエピソードでは、FatihがGitHubの1文字のユーザー名fを手に入れた経緯や、prompts.chatが一つのREADMEからアプリへと育ち、今もGitHubで貢献者の名前を残していることについても話しています。

The Mergeの対談全編をご覧ください。

CodeRabbitがprompts.chatのすべてのPRを最初に確認するので、Fatihは大変な作業が済んだ後から自分の確認を始められます。オープンソースプロジェクトでは無料で使えるため、エージェントが書いたPRに対応しているメンテナーなら、同じ体制を導入できます。

CodeRabbitを使い始める。

著者について

共有

Share on XShare on LinkedinShare on Reddit