「ここはテストしないことにします」と実装計画に書いて逃げたら、まるごとノーガードでした

（こども向けゲーム開発実況中継 No.4）

かずゆきです。

前回の記事↓

前回までで、タイトル画面からゲームオーバー、リトライまでが一周するようになって、コンボも入りました。今日はそこにアイテムを足す日です。

はっきり言って、シンプルすぎるゲームですが（笑）、企画ものとして楽しんで開発しています。

さて、今日やったことをざっくり言うと、これだけです。

• モンスターを見送ると、まれにアイテムが落ちる

• ⚡（光が強くなる） / ♥（HP回復） / 💧（弱くなる罠）

• 🔥（大かがり火）は右下のスロットに貯まって、好きなタイミングで発動できる

文字にすると2行なんですが、実際にはコミットが15本積まれました。今日はその中身の話をします。

フェーズをさらに5A / 5Bに割りました

まず、アイテムのフェーズを 5A と 5B に分けました。5A が取った瞬間に効く3種（⚡💧♥）、5B が貯めて使う1種（🔥）とインベントリです。

⚡💧♥ は「拾う→即効く」だけですが、🔥 は「拾う→貯まる→スロットをタップする→発動する」で、画面の右下にUIが増えて、タップの処理そのものに手を入れることになります。一緒にやると、おかしくなったときにどっちが原因か分かりません。

分けたぶん、往復は増えました。

今日いちばん良かった判断：「枠を詰めない」

5A の時点では 🔥 を作らないので、抽選のテーブルから 🔥 を外すことになります。

もともとのテーブルは5枠で `⚡ ⚡ ♥ 🔥 💧`。素直に 🔥 を抜くと4枠 `⚡ ⚡ ♥ 💧` になります。それで実機で遊んでみたら、「💧（罠）がやたら出るな」と感じました。

計算してみたら当たり前で、💧 は 20% → 25% に上がっていました。枠を1つ抜いたぶん、残った3種の取り分が増えます。

ここで選択肢が2つありました。💧 の枠を減らして調整するか、🔥 の枠を「何も落ちない」枠として空けておくか。

空けておく方にしました。5B で 🔥 を戻したときに、⚡♥💧 の頻度が1ミリも変わらないからです。枠を減らす方でやると、5A で「ちょうどいい」と感じた頻度が、5B で 🔥 を戻した瞬間にまたズレます。同じ調整を二度やることになります。

変わるのは「何も落ちない確率」だけ（12.0% → 9.6%）。5A で得た体感を、そのまま先の判断材料として使えます。

こういう判断、実装を自分で書いていると面倒くさくて飛ばしがちなんですよね。AIに書かせていると「じゃあそうしといて」で済んでしまいます。

同じフレームで落ちた罠を、同じフレームで拾えてしまう

5A で一番「おっ」となったのがこれです。

このゲームは指を複数本使えるので、同じフレームに複数のタップが来ます。素直に実装すると、こうなります。

1. 1本目の指がモンスターを見送る

2. その位置に 💧（罠）が落ちる

3. 同じフレームの2本目の指が、まだ画面に出ていない 💧 を拾う

「見分けて避ける」という 💧 の存在理由と真っ向からぶつかります。画面に描かれてすらいないものを踏まされるので。

新しく落ちたアイテムをいったん保留にして、その回のタップを全部処理し終えてから場に出す形にしました。

ややこしいのは、その逆は正しいということです。「フレームの最初から落ちていた ⚡ を1本目で拾って、2本目の攻撃に2倍が乗る」のは、指の到着順どおりなので正しい。似ていますが別の話なので、テストも別々に書きました。

🔥 の出現率は、実機で2回調整しました

5B の 🔥 です。強力な一掃技なので、出すぎても出なさすぎてもダメなんですよね。

• 当初（🔥 2.4%）: Wave 11 まで遊んで一度も出ませんでした

• 1回目の調整（🔥 4.7%）: 今度は多い

• 確定（🔥 3.5%）: 中間に落ち着きました

中間の 3.5% を作るために、抽選テーブルの枠を11枠に刻んであります。5枠や6枠だと「2.4% か 4.7% か」しか作れなくて、あいだの値が置けないんです。

11枠に刻み直しても ⚡♥💧 の頻度は当初とほぼ同じ（4.7 / 2.4 / 2.4%）に保っています。動かしたいのは 🔥 だけなので。

最後に50万回まわして実測 ⚡4.72% ♥2.38% 🔥3.53% 💧2.38%。狙いどおりでした。

「手動確認に委ねます」と書いて逃げたところが、まさに穴でした

今日いちばん刺さった指摘です。

5B では、🔥 のスロットをタップする処理を入れました。ここで問題になったのが、画面UI（ポーズボタンなど）に指が1本でも当たると、そのフレームのタップを全部捨てる、という既存の作りでした。

指A: モンスターをタップ  ← 消える
指B: スロットをタップ    ← これだけ処理される

ポーズボタンならこれでいいんです。押した瞬間に止まるので。でもスロットは戦闘の真っ最中に押すので、片方の指が消えるのは受け入れられません。

なので「スロットのタップは画面UIではなくゲーム入力として扱う」という設計にしました。ここまではよかったんです。

問題は、その振り分け処理を描画側に置いてしまったこと。うちのプロジェクトは、ロジック層だけテストがあって描画層にはテストがありません。なので実装計画に、

と書きました。要するに、テストできないところに置いたので、テストしないことにします、と書いたわけです。

Codex のレビューで、ここを突かれました。

言われてみればそのとおりで、実際に確かめてみたら、

• 「振り分けが常に通常タップになる（スロットが効かない）」

• 「矩形を無視する」

• 「UIに当たったら同時タップを全部捨てる（＝直したはずの元の挙動に戻る）」

この3つ、どれを仕込んでもテストが1本も落ちませんでした。今日いちばんの目的だった機能が、まるごとノーガードでした。

振り分けだけをロジック層に切り出したら、3つとも検出できるようになりました。「テストしにくい場所に置いた」は、たいてい「置き場所が間違っている」のサインなんだと思います。

「誤実装を仕込む」をやっていたら、仕込むスクリプトがバグっていました

このプロジェクトでは、フェーズごとに、わざと間違った実装を入れて、テストがちゃんと落ちるか確かめることにしています。「テストを書いた」と「テストが誤りを検出できる」は別物なので。

今日は 5A で14件、5B で12件+6件やりました。

で、5B の途中で「この誤実装は検出できませんでした」と報告が上がってきた件が1件あって、調べたら誤実装がそもそも当たっていませんでした。

原因は2つで、

• 置換の対象にコメント（`// 配列順（＝出現順）`）が入った行を指定していて、置換が空振りしていた

• 置換できたか確認する `diff` のオプションが macOS の diff では効かず、エラーも出さずに「適用できた」と誤判定していた

検証の仕組み自体が壊れていたという、なかなか間抜けな話です。以降は、誤実装ごとに目印を埋め込んで `grep` で当たったことを確かめる方式に変えました。

ほかにレビューで見つかったもの

Codex のレビューは 5A で7件、5B で6件でした。実際に画面に出ていた不具合もありました。

• アイテムがポーズ画面やリザルト画面より手前に描かれていました。ノードの重なり順の値を足し算していたせいです

• ゲームオーバー後もバフの残り秒数が表示され続けていました。止まっているのに

• スロットを揺らす演出が、繰り返すたびに少しずつ位置がズレていきました。「今の位置から動かす」を積み重ねていたため、揺れの途中でもう一度呼ばれると中途半端な位置が新しい基準になっていました

3つ目みたいなのは、ユニットテストでは絶対に見つかりません。

かかっている時間の体感

聞かれることがあるので、割合で書いてみます。

「新しく作る」は合わせて10%しかありません。 残り90%はレビューとテストと修正です。

Codex のレビューには gpt-5.6 sol の Max と Ultra を使っています。規模感でモデルを選択するようにはしていますが、ちょっと過剰なレビューかなと感じるときもあります。

ただ、コードを読まないと決めたアプリ開発の場合は、こまめなレビューが大事かなと思って、今のところこれでいっています。実際、今日だけでも「テストが1本も落ちない機能」と「壊れた検証スクリプト」が出てきているわけで。自分がコードを読まない以上、読む人をもう1人立てるしかない、というのが今のところの結論です。

なお、実機で遊んで多い / 少ないを決めるところ（🔥 の出現率の話）だけは、この表のどこにもAIが入っていません。数値は出せても、「Wave 11 まで一度も出ないのは寂しい」は遊んだ人しか言えないので。

次は

フェーズ6、モンスターの種類を増やすところです。速いやつ、硬いやつ、ジグザグに来るやつ。

ここまでは「1種類のモンスターをどう気持ちよく帰すか」だったので、やっと「どれから狙うか」という判断が生まれます。

あと、硬いモンスターが混ざると 🔥 の一掃の価値が上がるので、今日決めた 🔥 のスコア係数はまた見直すことになりそうです。

つづきます。

#まよいびの子 #個人開発 #ゲーム開発 #iOSアプリ開発 #Swift #SpriteKit #Xcode #ClaudeCode #Claude #Codex #生成AI #AIコーディング #開発日記 #制作日記 #プログラミング #エンジニア #ものづくり #アプリ開発 #スマホゲーム #インディーゲーム #ユニットテスト #テスト設計 #テスト自動化 #ミューテーションテスト #SwiftTesting #コードレビュー #AIレビュー #設計書 #実装計画 #アーキテクチャ #レイヤードアーキテクチャ #責務分離 #リファクタリング #デバッグ #バグ #品質保証 #乱数 #確率 #ゲームバランス #バランス調整 #ゲームデザイン #レベルデザイン #アイテム #インベントリ #UI設計 #マルチタッチ #タップ操作 #フレームレート #実機テスト #シミュレータ #iPhone #iOS #AppStore #ゲームアプリ #自作ゲーム #ひとり開発 #個人開発者 #週末開発 #副業 #ChatGPT #GPT5 #LLM #AI活用 #AIエージェント #AIとの共同作業 #ペアプログラミング #プロンプト #開発効率化 #失敗談 #振り返り #学び #気づき #継続は力なり #毎日note #note初心者 #創作 #親子 #子育て #中学生 #プログラミング教育 #子どもと一緒に