AIにHTMLを書かせていて、壊れたまま気づかなかった経験がある人に向けた記事です。AIがファイルを書き換えるたびに、構文の確認を自動で走らせる方法と、使ってみた結果を書きます。
元飲食店員で、IT未経験からPythonを始めました。今は、ブラウザで遊べる自作の育成ゲームを、ひとりで作っています。HTMLファイル1枚のゲームで、コードの大部分はAI(Claude Code)に書いてもらっています。
■困っていたこと
AIに書かせたコードは、自分で確認するまで、壊れているかどうかが分かりません。確認するのは人間なので、疲れている日は飛ばしてしまいます。
コードに限らず、ゲームを公開したときも、README(ゲームの説明書きのファイル)に「あとで書く」つもりの空欄を残したまま出してしまいました。確認の手順があっても、毎回は守れません。
■自動化したかったこと
AIがファイルを書き換えたら、その場で自動的にチェックが走り、壊れていたらAI自身に知らせる。人間が「チェックして」と言わなくても、確認が自動で挟まる状態にすることが目標でした。
■作ったもの
Claude Codeには「フック」という機能があります。AIが何かをした直後に、決まった処理を割り込ませる仕組みです。これを使って、2つのファイルを作りました。
・check.mjs:HTMLの中のJavaScriptを取り出して、構文が壊れていないかだけを確認する。外部のライブラリは使っていません。
・html-postcheck.mjs:AIがHTMLファイルを書き換えた直後に、自動でcheck.mjsを呼ぶフック。
流れは次のとおりです。
AIがHTMLを書き換える → フックが動く → check.mjsが構文を調べる → 結果がAIに返る
結果はPASSかFAILでAIに返ります。正しいコードと、数字を1か所消したコードで試したところ、壊れたほうは何行目のどこがおかしいかまで表示されました。この表示がAIに届くので、人間が指摘しなくてもAIが直し始めます。
■うまくいかなかったこと
・PASSが出ても、動かしてみたら不具合があったことがあります。だから最後は毎回自分で起動して確かめることにしました。
・フックとは別に、「直した」と言われたファイルが、直っていないことがありました。AIが修正版をファイルに書き出したとき、ひとつ前の版が書き込まれていたことがありました。書いたあとに中身を照合する手順を足して、公開前に気づけるようにしました。
■保存まわりの修正で使った流れ
自作ゲームの保存まわりを直したときにも、同じcheck.mjsを使いました。ブラウザの設定で保存がブロックされている環境や、保存データが壊れている場合に、ゲームが起動しなくなる箇所が残っていたためです。
修正したあとの構文チェックはPASSでした。そのうえで、修正の前と後に、同じ6つの条件でゲームを起動して試しました。6つの条件には、保存がブロックされている環境や、保存データが壊れている場合を含みます。起動しなかったケースは、修正前は6条件のうち3件、修正後は0件になりました。
このときの流れは次のとおりです。
1. AIが修正を書く
2. 構文チェックを通す
3. 6つの条件で起動テストをする
4. 修正を書いたのとは別のAIが、変更点を点検する(5項目すべてPASS、追加の指摘が1件)
追加の指摘も直してから、同じテストをもう一度通しています。人間がやったのは、最後に起動して動きを見ることと、記録することだけです。
■あえて自動化しなかったこと
全部を自動にしたわけではありません。自動にしたのは「構文が壊れていないか」の確認だけです。
・ゲームが正しく動くか、楽しいかは、自分で起動して目で確かめる。
・変更を記録する(git commit)かどうかは、自分で決める。
動きの確認を人に残したのは、チェックで判定できるのが構文だけだからです。記録に残すかどうかも、自分で決めるルールにしています。
■同じ形にするには(考え方)
単一のHTMLで作るゲームやツールをClaude Codeで作っているなら、同じ形にできます。ファイルは、Claude Codeに「HTMLの中のJavaScriptの構文だけを確かめるスクリプト」と「HTMLの編集直後にそれを呼ぶフック」を書かせて作れます。置き場所は次の3つです。
1. フックのファイルは、ホームフォルダの.claude/hooks/ に置く
2. フックを動かす設定は、ホームフォルダの.claude/settings.json に書き足す
3. check.mjsは、チェックしたいHTMLと同じフォルダに置く
check.mjsを置いたフォルダでしか動かないので、ほかのプロジェクトの邪魔はしません。Node.js(JavaScriptをパソコン上で動かすソフト)18以上が必要です。
■まとめ
・AIがHTMLを書き換えた直後に構文チェックを自動で走らせると、壊れたまま気づかない状態を減らせる、と考えて使っています。
・自動にしたのは構文の確認だけです。動きの確認と記録は、人が決めて行います。
・保存まわりを直したときは、構文チェックのあとに6つの条件で起動テストもして、起動しなかったケースが修正前の3件から修正後は0件になりました。この数字は修正そのものの結果です。
■確かめていないこと
・この結果は、自分のパソコン1台と、自作の1つのゲームでのものです。ほかのHTMLや環境で同じ結果になるかは、確かめていません。
・check.mjsが見るのは構文だけで、動作や見た目の正しさは保証できません。
・下書きにはAIを使い、内容は自分の作業記録と照らして確かめています。
■案内
この記事のHTML確認とは別に、Claude Codeの権限設定を整える出品をしています(秘密ファイルを守るフックはオプションです)。この記事に紐づけたサービスをご覧ください。