AIが書いたコードは使って確かめる ― 舞台アプリ開発のレビュー記録
私の環境では、コードを書くのはAIがほとんどです。
ゲームは Claude Code、サーバーやサイトのプログラムは Codex、GitHub の内側の作業は Copilot、そして日常の開発相手はミューズさんとコーデックスさんです。
生成される量が増えた分、問題になるのはレビューでした。
私は、その全部を1行ずつ読んでいるわけではありません。
興味があれば、読みます。
必要ならば読みます。
この記事では、発表用の舞台アプリ muse-stage の開発を例に、私のレビューの形を書きます。
レビューの形は「使って確かめる」
私のやり方は、だいたい決まっています。
頼む時に、指示書へ完了条件を書いておく。
作業の報告は Markdown で受け取る。
できあがったら、コードではなく実物を開いて、実際に使って確かめる。
公開するものは、公開側の画面やデータでもう一度確認する。
人が見るのは、細部の書き方よりも「実際に使えるか」と「方針が合っているか」です。
この形で回すと、レビューはコードの検査ではなく、体験の確認になります。
方法そのものが違った話
舞台アプリでは、ミューズさんの返事を自動で舞台に届ける仕組みが必要でした。
最初に作ったのは、Mac のアクセシビリティの仕組みでアプリの画面から返事を取り込む方法です。
報告の上では、動いていました。
過去の返事70件を再構成できるところまで確認が取れていました。
ところが、実際に発表の相方として使ってみると、違いました。
要素を一括で取る命令はこのアプリでは使えず、子要素を一つずつ順にたどるしかありません。
新しい返事は段落やコード片ごとにバラバラの要素で描かれるため、断片を文書の順番どおりに組み立て直す必要もありました。
その走査だけで十数秒かかり、声が出るまでに十秒以上かかるのが普通だったのです。
最新の返事を取りこぼすこともありました。
コードの正しさの話ではありません。
方法そのものが、用途に合っていなかったのです。
そこで、取りに行くのをやめました。
ミューズさんが返事をするたびに、その文を決まったファイルへ書き込む直送の形に変えたら、ほぼ同時に読み上げが始まるようになりました。
仕組みは単純です。
ミューズさんが返事をするたびに、その文を Mac の決まった Markdown ファイルへ、連番を付けて書き込みます。
舞台アプリは、そのファイルを0.7秒ごとに読んで、新しい返事があれば読み上げます。
ファイルが Markdown なのは、人もAIも読める形で、履歴も残るからです。
そもそも、返事の文を持っているのは画面ではなく、書いた本人です。
画面から読み取る苦労をするより、本人に届けてもらう方が確実でした。
レビューがコードを直したのではなく、レビューが方法を変えた、という話です。
その舞台アプリの画面です。
発表のスライドを後ろに敷いて、実際に使う形で確かめます。
詳しい経緯は、開発記録の記事に書きました。
GitHub へのリンクも、その記事にあります。
是非、ご利用くださいなのだ。
返事を読み上げる舞台アプリを作った ― muse-stageの開発記録
「動いた」を信じすぎた話
もう一つ、失敗談があります。
ブラウザの画面から返事を送るウェブフックの仕組みを作った時、舞台が喋ったので「動いた」と思いました。
後で確かめると、喋っていたのはフックではなく、別の仕組みであるアクセシビリティの自動取り込みの方でした。
「動いた」という報告だけでは足りません。
どの経路で動いたのかまで確かめないと、取り違えます。
それ以来、動いた理由まで確認することと、間違えたら訂正も含めて記録に残すことを、決め事にしています。
線引きはどこか
細部の確認は、道具とAI同士の分担に寄せています。
テストが何件通ったか、ビルドが通るか、公開側のデータに反映されたか。
GitHub の内側では Copilot にプルリクエストを作らせて、ミューズさんが確認とマージと公開確認をする分担もあります。
一方で、人が見ないとダメだったのは、こういう点でした。
実際に使った感触です。
キャラクターが回りすぎて目が回る、姿が近くてスライドが読めない、ずっと動いていて疲れる。
こういう違和感は、テストでは出てきません。
それと、やめる判断です。
合わない方法を捨てる、公開の範囲を決める、人の名前を出さない、といった取り返しのつかない点は、人が見ます。
観点は前と同じか
生成されたコードをそのままマージするのか、という問いに、私の答えは「そのままにはしない」です。
ただし、見方が変わりました。
コードの正しさを見る観点に、「実際に使えるか」と「報告は本当か」が加わったのです。
AIが書く量が増えるほど、レビューの仕事は、読むことから確かめることへ移っていく。
舞台アプリの開発は、その往復の連続でした。
そして、副産物もありました。
仕組みを考えて、レビューを繰り返していたら、気がついたら、英語へのほぼ同時翻訳のアプリになっていました。
仕組みを考えながら動作を確認するレビューを繰り返すことで、新しいアイデアが出てくることもあります。
それを繰り返すことが、今は楽しいのです。
