AIとの協業:具体的な例
Working With AI: A concrete example (htmx.org)
要約
この記事では、HTMXの作成者が、ハイパースクリプトのメンテナンス中にAIと協力してバグを修正した具体的な例を紹介しています。AIは問題の原因特定とテスト作成には非常に役立ったものの、クリーンな解決策の提案には弱く、技術的負債を回避するためには人間の介入が不可欠であることを示しています。AIの利点と限界、そしてAIに過度に依存することの危険性(魔法使いの弟子問題)について考察しています。
全文翻訳
AIとの協働:具体的な事例
Carson Gross
2026年6月29日
私は一般的に、AIに対しては両方の感情を持っています。過去1年間でAIが開発において非常に強力なツールになったことは疑いようがありませんが、同時に、私たち個人(例:知性の緩やかな鈍化)にとっても、集合的(例:環境問題、ますます高価になるパーソナルコンピューティングなど)にとっても、多くの危険が伴います。
「コードは安い(より安い)」では、開発者がAIに依存し、構築しているシステムの発生する問題を理解し、適切に対処できなくなる「魔法使いの弟子」問題を警告しました。
この記事では、hyperscriptのメンテナンス中にAIと行った具体的なやり取りを通じて、AIの一般的な長所と短所を示し、特に(私が間一髪で回避した)「魔法使いの弟子」問題を実証したいと思います。
Hyperscriptパーサー
背景として、hyperscriptはWebのための代替の解釈型スクリプト言語です。皮肉なことに、それは完全にJavaScriptで書かれています。
それは奇妙なソフトウェアです。実験として、物事がどのように機能するかを見るために、多くの解析規則を意図的に破って書きました。
例:
- 解析ロジックは解析要素上に共存しています。
- パーサーはプラグイン可能で、文法は動的に定義されます。
- プロパティアクセスのために複数の構文をサポートしています。
ほとんどのプログラミング言語には推奨しないアプローチですが、このプロジェクトではかなりうまくいきました。
ソフトウェアには確かに猫の皮を剥ぐ方法は複数あるという、もう一つの実証です。
バグレポート
私たちの物語は、ユーザーが0.9.91リリースへのアップグレード時にリグレッションを報告したことから始まります。以下の式が正しく解析されなくなりました。
fetch `{% url 'trade:get_symbol_data' %}?symbol=${symbol}` as JSON
特に、as JSONが結合しすぎて、ユーザーが期待していたこと(そして以前行っていたこと)ではなく、結果をJSONとして取得するのではなく、fetchに渡される前に文字列リテラルをJSONに変換しようとしていました。
このような結合の競合は、解析における古典的な問題です。
hyperscriptはxTalkスタイルの言語であり、英語の曖昧さの多くを継承しているため、この問題はさらに悪化します。
原因の調査
最初に行うべきことは、このリグレッションがなぜ発生したのかを調査することでした。
これは私が通常AIに助けを求める分野です。
Claudeを使用しましたが、根本原因の特定において見事な仕事をしてくれました。0.9.91で、goコマンドとfetchコマンドのロジックを再利用/共有するために、過度に積極的なリファクタリングを行っていました。
両方のコマンドで使用する共通メソッドparseURLOrExpression()を抽出しましたが、その過程で、fetchコマンドの後の文法を、一般的なexpression、つまり式に誤って拡張してしまいました。
asキーワードは式において意味を持ちます。これは、型間で変換できる変換式です。
set x to "42" as Int
しかし、asキーワードはfetchコマンドの修飾子でもあり、レスポンスをどのように変換するかを指示します。
fetch https://hyperscript.org as Text
(おそらくこの事実に、少し口の中に嫌な味がするかもしれません。良いことです。)
問題の核心は、リファクタリングで意図せず、fetchキーワードの後に式を解析させてしまい、それがasキーワードをfetchの修飾子としてではなく、式として消費してしまったことでした。
Claudeの助けを借りて、これを数分で見つけることができ、自分で見つけ出すよりもはるかに速かったです。
問題の修正
AIは問題の原因特定に非常に役立ちました。
しかし、問題の修正においては、はるかに弱かったです。
ここでは怠惰だったことを認めますが、AIに解決策を尋ねたので、それらの解決策について不平を言うのは、まあ、怠惰ですが、それでも出来事の連なりは有益だと思いますので、正確に何が起こったのかを見ていきましょう。
提案された修正1:ハック
最初に与えられた提案は、「文字列のような」リーフを最初に解析し、次に完全な式にフォールバックするというものでした。
return this.parseElement("stringLike") || this.requireElement("expression");
この修正は、ユーザーから報告された問題を即座に解決したでしょう。
しかし、それは報告されたバグに非常に特化しており、例えば誰かがfetchのターゲットとして変数を使用した場合のような、一般的なケースを修正しませんでした。
fetch $url as JSON
私はこの提案を、あまりにもハック的で、十分に一般的ではないという理由で却下しました。
(hyperscriptパーサーには、有機的に供給されたハックがたくさん含まれていることに注意してください。この点では、鍋が釜を黒いと呼んでいるのかもしれません。)
提案された修正2:より良いが、不必要な複雑さ
2番目の提案はより興味深いものでした。パーサーにnoConversionsフラグを追加し、URL解析の周りに設定し、AsExpression.parseが設定されている場合に終了するようにします。
// AsExpression.parse()
if (parser.noConversions) return;
これは多くのパーサーエンジニアを愕然とさせるでしょう。なぜなら、hyperscriptパーサーをコンテキスト依存にするからです。
良いことです。
hyperscriptパーサーはすでにコンテキスト依存でした。
この修正を見て、少し考えただけで、新しいフラグをパーサーに追加することなく、すでに必要なハック的なコンテキスト依存インフラストラクチャがあることに気づきましたが、Claudeは見落としていました。
Hyperscriptパーサーの「Follows」
hyperscriptパーサーには、トークンが「より上位の」解析要素によってフォロー・トークンとして「主張される」という「follows」という概念があります。
hyperscriptパーサーは(やや奇妙な)再帰下降パーサーであり、これにより解析要素(通常はコマンド)がキーワードを「主張」でき、式は解析中にそれらと一致しなくなります。
例として、when機能は、宣言において論理結合子としてではなく、区切り文字としてorを使用します。
<div _="when $x or $y changes put it into me"></div>
(多くのパーサーエンジニアが怒ってこのウィンドウを閉じているのが聞こえます。良いことです。)
この機能を使用して、目的を達成できることが判明しました。パーサーに新しいフラグを追加する代わりに、asをフォローとしてプッシュし、式を解析してから、フォローとしてポップすることができます。
これにより、AsExpressionの解析が防止されますが、変数のようなほとんどの一般的な式は引き続き機能します。
提案された修正3:惜しい、しかし不十分
これをClaudeに指摘したところ、興奮のあまり、それは「絶対に正しい!」と言い、このテクニックを使ってバグを修正し始めました。
ClaudeはparseURLOrExpression()に正しいコードを追加し、追加のパーサーインフラストラクチャを追加することなく、問題を一般的に修正しました。
これでOKです。
最終的な、半有機的な修正
しかし、変更を確認しているうちに、新しい修正が過度に広範囲であることがわかりました。fetchとgoの両方がこのメソッドを共有していましたが、asを修飾子として使用したのはfetchだけでした。
既存の修正は、goコマンドでのas変換式の完全に有効な使用も妨げていました。
そこで、最終的な修正をFetchCommand#parse()で自分自身で実装しました。
parser.pushFollow("as");
try {
var url = parser.parseURLOrExpression();
} finally {
parser.popFollow();
}
if (parser.matchToken("as")) {
...
ここで、特殊ケースをfetchコマンドのみに絞り込み、goの解析には影響を与えないようにしました。
これが最終的なバグへの回答となりました。
テスト
途中で、Claudeにいくつかのテストを生成してもらいました。
hyperscriptには優れた既存のテストスイートがあり、Claudeは問題を実証し、修正が正しく機能していることを示す、小さく焦点を絞ったテストを作成するのに良い仕事をしてくれました。
AIがうまく機能するもう一つの分野です。
物語の教訓
さて、このかなり平凡なバグ修正の話で興味深い点は何でしょうか?
AIがうまく機能した点(調査とテスト作成)と、うまく機能しなかった点(クリーンな解決策の考案)を対比して見ることができるのは興味深いと思います。
もし私がhyperscriptパーサーとそのインフラストラクチャに精通していなかったら、この修正はプロジェクトに技術的負債を蓄積させる可能性が簡単にありました。別のハック的な解析コーナーケース、パーサー上の別の状態ビットなどです。
技術的負債は、証拠なしに主張しますが1、指数関数的に増加するため、プロジェクトでそれを最小限に抑えることは非常に重要です。
この話は、AIエージェントを単独で放置するよりも、人間がループ内にいて、エージェントと協力し、基盤となるインフラストラクチャを十分に理解していることが、複雑性の制御においていかに効果的であるかを示しています。
hyperscriptのコードベースを見て、複雑性の制御が考慮事項であったかどうかを嘲笑する人もいるでしょう。私はその見方に共感します。
しかし、この例では、明らかに恥ずかしいバグを修正する際に、知識のある人間がAIエージェントと協力することで、複雑性が(少なくとも少しは)抑制された具体的なシナリオを見ることができます。
これは、AIが提案する解決策を盲目的に受け入れる「魔法使いの弟子」になるのではなく、私が「魔法使い」(そう言うのは傲慢かもしれませんが!)として、既存のコードベースのアーキテクチャにより適した正しい解決策を要求した状況です。
私は問題を理解し、正しい解決策を見て、AIと協力してそれを達成し、AI生成テストの助けを借りて解決策を検証することができました。
これは、現在推進されている一部の「バイブコーディング」とは対照的です。そこでは、開発者(または何であれ)が、実際に何が起こっているのかを理解していないことを誇りに思っているようです。
余談:AIと年配の開発者
この経験を振り返っているうちに、もう一つ思いつきました。
私は50歳になった年配の開発者です。開発者が年を取ると、現実として、ある程度「速球を失う」傾向があります。
実際、私にとっては、これは2つのことを意味しました。
- 以前ほど多くのことを覚えていられなくなった。
- 以前ほど長時間働けなくなった。
AIは、これら両方の問題に直接対処することがわかりました。
記憶に関して言えば、以前覚えていたすべてを覚えていられなくても、適切なプロンプトがあれば、物事を再び非常に速く理解できます。AIはこの点で非常に役立ち、オープンソースプロジェクトと仕事のプロジェクトを、それなしの場合よりもはるかに効率的に切り替えることができます。
長時間労働に関して言えば、AIは、若い開発者だった頃でさえ、私が追いつくのが困難だったであろう方法で、作業をこなすことができます。これは、例えば、そうでなければできなかったであろう、より広範なテストスイートを持つことができることを意味します。
このケースでClaudeが生成したテストを見ると、私が自分でエネルギーを費やして作成できたであろうものよりも広範です。
このように、AIは年配の開発者として私が持っていた2つの根本的な(相対的な)弱点に対処しました。
一方で、私の全体的な知性のより一般的な退行を可能にしているのではないかと非常に心配しています。これは、年齢とともに自然に起こることでもあります。しかし、AIへの依存はこのプロセスを加速させる可能性があり、この話を振り返ると、自分で正しいことをする前にClaudeにどれだけ長く頼っていたか、少し恥ずかしいと言わざるを得ません。
これは、まだ自分自身でナビゲートしようとしている分野です。
結論
コーディングにおけるAI支援の良い点と悪い点の両方を捉えていると思ったので、この一連のやり取りを書き留めたかったのです。それは、比較的有能な開発者がAIエージェントと協力してループ内にいることの価値を示し、また、AIエージェントが問題に対して最初に(または2番目に)提案する解決策を盲目的に受け入れる危険性も示しました。
あなたがAIエージェントに関するあなた自身の考えや戦略を開発する上で、それが役立つことを願っています。
–
1
これは夢の中で私に明かされました。
</>