cloudensis learn

AIと学ぶ、はじめてのソフトウェア開発

第5章 わざと壊して、直す

ゴール
エラーを手がかりに、原因の場所を狭められる
手に入るもの
一度壊して直したゲーム
目安の時間
40分

いまの位置:第2部 手元で作る / 第5章

次の章では、ゲームに機能を足します。 そうすると、ほぼ確実に一度は動かなくなります。 それは失敗ではなく、ソフトウェアを作るうえで毎日のように起きることです。

そこでこの章では、先に自分でゲームを壊して、自分で直します。 自分で壊したものは、何を変えたか分かっているので必ず直せます。 壊れたときに何が起き、どこを見れば手がかりがあるのかを、安全なうちに体験しておきます。

壊す前に、コピーを取る

まず、my-game フォルダをまるごとコピーして、同じドキュメント(Mac では「書類」)の中に my-game-backup という名前で置いてください。

これが、最後にうまく動いていた状態の控えになります。 どれだけ壊しても、このコピーと見比べれば元に戻せます。 この本では、ゲームを大きく変える前に、毎回このコピーを取り直します。

エラーが見える場所を開く

ブラウザには、ページの裏側で起きていることを見るための開発者ツールが入っています。 その中のコンソールという画面に、ゲームが動かなくなった理由が表示されます。

新しい会話で送ってください

利用OS
ブラウザ
Windowsのパソコンで、ブラウザの「開発者ツール」の「コンソール」を開く方法を教えてください。

- 私が使っているブラウザはChromeです
- キーボードの操作で開く方法と、メニューから開く方法の両方を教えてください
- コンソールに表示される赤い文字が何を意味するかを、一言で教えてください

ゲームの index.html をブラウザで開いた状態で、コンソールを開いてください。 いまはゲームが正しく動いているので、赤い文字は出ていないはずです。

壊し方1:ファイルの名前を間違える

エディタで index.html を開き、script.js と書いてある箇所を探して、scripts.js に書き換えて保存してください(「s」を1文字足すだけです)。

ブラウザを再読み込みすると、ゲームが動かなくなっているはずです。 ゲームによっては、画面の一部が表示されなくなることもあります。 コンソールを見てください。赤い文字で、何かが表示されています。

英語で書かれていても、慌てなくて大丈夫です。 まずは、文の中に出てくるファイル名を探してください。 scripts.js という名前が見つかるはずです。 「このファイルが見つからない」という意味のことが書かれています。

書き換えてもゲームが動いたままなら、ゲームの動きがまだ index.html の中に残っています。 第2章でゲームを作った会話の続きで「index.html の中に残っている JavaScript を、すべて script.js に移してください。変更後の index.html と script.js を全文で出してください」と頼み、返ってきた全文で2つのファイルを上書きしてから、もう一度書き換えてみてください。 この章の残りは、動きが script.js に分かれていることを前提に進みます。

確かめたら、scripts.js を script.js に戻して保存し、ゲームが動くことを確かめてください。

壊し方2:知らない命令を1行足す

次は、ファイルの中身を壊します。 エディタで script.js を開き、いちばん上の行の先頭に新しい行を1つ作って、次の1行を書いて保存してください。 コピーして貼り付けてかまいません。

hello();

これは「hello という名前の動きを実行して」という命令です。 ところが、ゲームのどこにも hello という動きは作られていません。 存在しないものを実行しようとするので、ゲームはここで止まります。

ブラウザを再読み込みすると、ゲームが動かなくなっているはずです。 コンソールには、今度は別の赤い文字が出ています。 ここでも、ファイル名と、その横の数字を探してください。 script.js:1 のような形で、どのファイルの何行目で問題が起きたかが書いてあります。 いま足した1行目を指しているはずです。

ただし、エラーが指す行が、いつも本当に間違えた場所だとは限りません。 かっこの閉じ忘れのような書き間違いでは、ファイルの最後の行を指すこともあります。行番号は、探しはじめる場所の目印だと考えてください。

ここで、あえて自分では直さずに、AIに相談してみます。 相談のしかたにも、決まった聞き方があります。

エラーを相談する

AIに「動きません」とだけ伝えても、AIは推測で答えるしかありません。 次の4つをそろえて渡すと、AIは原因の場所を絞り込めます。

エラーを相談する

次の問題について、原因と直し方を教えてください。

# やったこと
(何をしたら、問題が起きたか)

# 期待したこと
(本当はどうなってほしかったか)

# 実際に起きたこと
(画面で何が起きているか)

# エラーの全文
(コンソールの赤い文字を、英語のまま、全部そのまま貼る)

# 関係しそうなファイル
(エラーに出てきたファイルの中身を、全文貼る)

エラーは訳したり要約したりせず、英語のまま全文を貼ってください。一見関係なさそうな部分に手がかりがあることが多く、AIは英語のエラーをそのまま読めます。

この聞き方で、新しい会話で相談してください。 丸かっこの部分は、たとえば次のように埋めます。

  • やったこと:script.js を少し書き換えた(ここでは練習のため、何を書き換えたかは書かずに送ります)
  • 期待したこと:これまでどおり、ゲームが遊べる
  • 実際に起きたこと:画面は出るが、ゲームが動かない
  • エラーの全文:コンソールの赤い文字をコピーしたもの
  • 関係しそうなファイル:script.js の全文

返ってきた答えに、1行目の hello(); が原因で、その行を消せば直ることが含まれていれば、相談は成功です。 答えに沿って直すか、my-game-backup の同じファイルと見比べて直してください。

この練習では、やったことをわざと伏せて、エラーだけで原因にたどり着けるかを見ました。 ふだんの相談では逆です。やったことは、できるだけ具体的に書いてください。手がかりが多いほど、AIは早く正確に原因を絞り込めます。

確かめる

直したら、ブラウザを再読み込みして、次の2つを確かめます。

  • コンソールに赤い文字が出ていない
  • 第4章のときと同じように、最初から最後まで遊べる

AIが示した直し方が、本当に正しかったかどうかは、この2つで判断できます。 AIの説明がどれだけもっともらしくても、動かして直っていなければ、直っていません。

次へ進んでよい状態

  • my-game-backup に、動いていた状態のコピーがある
  • コンソールの開き方が分かり、エラーからファイル名と行番号を読み取れた
  • 「エラーを相談する」を1回使い、ゲームが元どおりに動いている

つまずいたら

コンソールに赤い文字が出ない
コンソールを開いたまま、ブラウザを再読み込みしてください。エラーは、ページを読み込んだときに表示されることが多いです。
エラーの文をどこからどこまでコピーすればいいか分からない
赤い文字の行を、全部コピーしてください。多すぎるくらいで大丈夫です。足りないより、多いほうがAIは正確に答えられます。
直したつもりなのに、まだ動かない
エディタで保存したか、ブラウザを再読み込みしたかを確かめてください。それでも動かないときは、my-game-backup のファイルで上書きすれば、確実に元に戻せます。
AIの直し方を試したら、別のところが壊れた
第1章の「詰まったときの共通ルール」を使います。いったん my-game-backup から元に戻し、新しい会話で、「エラーを相談する」の聞き方で相談し直してください。

どれにも当てはまらないとき、同じところで何度も止まるときは、第1章の「詰まったときの共通ルール」に戻ってください。

ここまでの確認

  • 壊す前に、my-game-backup としてコピーを取った
  • ファイル名を間違えて、コンソールでファイル名を見つけた
  • script.js に1行足して、エラーから行番号を読み取った
  • 「エラーを相談する」の聞き方でAIに相談し、直ったことを動かして確かめた

ロードマップ用チャットに報告する

ロードマップ用チャットで送ってください

第5章を終えました。
ゲームをわざと壊し、ブラウザのコンソールのエラーからファイル名と行番号を読み取って、AIに相談して直せるようになりました。

次の一歩

壊れたときの見方と、相談のしかたが手に入りました。 第6章では、いよいよ自分で決めた機能をゲームに足します。 動かなくなったら、この章でやったことをそのまま使ってください。