cloudensis learn

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

第1章 この本の歩き方とAIのコツ

ゴール
この本の進め方と、AIにうまく頼むコツが分かっている
手に入るもの
すぐ使えるAIツール
目安の時間
30分

いまの位置:第1部 まず作ってみる / 第1章

この本では、ブラウザで遊べるゲームを1つ作り、それを自分のパソコンに持ってきて、インターネットに公開し、自分の手で育てていきます。 プログラミングの知識は要りません。 書き方を覚える代わりに、AIに頼み、返ってきたものを確かめることをくり返します。

この章では、そのための準備をします。 使うAIツールを決め、この本を通して使うコツと決まりごとを押さえます。

この本の進み方

この本は4つの部に分かれていて、最初から最後まで同じゲームを題材にします。

  • 第1部 まず作ってみる:AIツールの中でゲームを作り、先の道のりを描く
  • 第2部 手元で作る:ゲームを自分のパソコンに持ってきて、壊したり直したり、機能を足したりする
  • 第3部 世界に出す:ゲームをインターネットに公開して、自分のURLを手に入れる
  • 第4部 自分で進む:本の手助けを少しずつ減らし、最後は次に学ぶことを自分で決める

どの章も、同じ形で進みます。

  • やること:AIに送る文が置いてあります。コピーして、そのまま送ってください
  • 確かめる:返ってきたものが本当に正しいかを、自分の手で確かめます
  • 次へ進んでよい状態:ここに書いてある状態になっていれば、章の残りを飛ばして先へ進んでかまいません
  • ロードマップ用チャットに報告する:第3章で作るチャットに、章の終わりに一言報告します

パソコンのファイルやフォルダの扱いに自信がない人は、先にダウンロードに置きっぱなしを卒業する:ファイルとフォルダの基本を読んでおくと、第4章から先が楽になります。

使うAIツールを決める

この本では、AIとの対話ツールを1つ使います。 条件は、作ったWebページを、その場で動かして見せる機能があることです。 ChatGPT と Gemini では Canvas、Claude では Artifacts という名前で、無料の範囲でも使えます。

すでに使っているものがあれば、それでかまいません。 まだ何も使っていなければ、どれか1つでアカウントを作ってください。 どれを選んでも、この本は同じように進められます。

使うツールを開いたら、その機能が本当に使えるかを試します。 AIに「機能はありますか」と聞くこともできますが、AIは自分の機能について間違えて答えることがあります。実際に小さなものを作らせて、動くかどうかを見るのが確実です。 新しい会話で、次の文を送ってください。

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

ボタンを1つだけ置いた、小さなWebページを作ってください。
ボタンを押すたびに、画面に表示された数字が1ずつ増えるようにしてください。
作ったページは、この画面の中でそのまま動かして見せてください。

会話の横か下にページが表示され、ボタンを押して数字が増えれば、準備はできています。 文字だけが返ってきた場合は、 「作ったページを、この画面の中で動かして見せる機能を使って表示してください」と送ってみてください。 それでも表示されない場合は、設定でその機能をオンにする必要があるか、同じ会話で聞いてみます。 どうしても表示されなければ、別のツールを試してください。

AIとうまくやり取りするコツ

AIに頼むときに、知っているだけで結果が大きく変わるコツが4つあります。 この本では、ずっとこの4つを使います。

1. 話題ごとに、新しい会話を始める

AIは、同じ会話の中のやり取りをすべて踏まえて答えます。 便利な一方で、関係のない話が混ざると、そちらに引きずられて答えが散らかります。話題が変わったら、新しい会話を始めるのが基本です。 会話が長くなって、答えがちぐはぐになってきたと感じたときも同じです。

ツールによっては、ほかの会話の内容を覚えておく機能(メモリ)があります。 ついていると、新しい会話にも前の話が混ざることがあります。 気になる場合は、設定でオフにできるかAIに聞いてみてください。

2. 自分の前提を伝える

「私はプログラミングの知識がまったくありません」「使っているパソコンは Windows です」。 こうした前提をひとこと添えるだけで、説明の高さや具体性があなたに合います。 この本のAIに送る文には、必要な前提があらかじめ入れてあります。

3. 範囲を区切って聞く

分からないことが出てきたら、その一点だけを、範囲を区切って聞きます。 これを一点だけ聞くと呼び、この本でいちばん多く使う聞き方です。

一点だけ聞く

「(分からない言葉)」について教えてください。

- 何のためのものかを、一言で説明してください
- 身近なたとえを1つ使って、300字以内で説明してください
- 私はソフトウェア開発の知識がまったくありません。ほかの専門用語はできるだけ使わないでください

丸かっこの部分だけを書き換えて使います。 試しに、「ブラウザ」という言葉で一度送ってみてください。 字数と、ほかの専門用語を使わない条件があるので、読み切れる長さの答えが返ってくるはずです。

4. AIの答えは、必ず確かめる

AIは、もっともらしく間違えることがあります。 古い情報を答えることもあります。 だからこの本では、答えを受け取ったら必ず確かめます。確かめ方は2つです。

  • 実際に動かしてみる:作ったものが思ったとおりに動けば、その答えは少なくとも間違っていません
  • 公式資料で確かめる:そのサービスや仕組みを作っている本人が出している資料のことです。一次情報ともいいます

どちらを使えるかは、場面によって変わります。 各章の「確かめる」で、その場面に合った確かめ方を示します。

この本で使う5つの聞き方

コツ3の「一点だけ聞く」のように、この本では、場面ごとに決まった聞き方をくり返し使います。 全部で5つあり、必要になった章で1つずつ教えます。 いまは名前だけ眺めておいてください。 本文に「第4章の「選び方を聞く」」のように出てきたら、リンクから教えた場所に戻れます。

  • 一点だけ聞く(第1章):分からない言葉が出てきたとき、その一点だけを範囲を区切って聞く
  • 全体像を聞く(第3章):何が関係するのか分からないとき、登場するものとつながりを先に聞く
  • 選び方を聞く(第4章):選択肢がいくつかあるとき、選択肢と選ぶときの基準を聞く
  • エラーを相談する(第5章):動かないとき、やったこと・期待・実際・エラー全文をそろえて渡す
  • 公式資料を読ませる(第7章):答えが正しいか、古くないかが気になるとき、公式資料の場所を先に渡す

詰まったときの共通ルール

この本のどの章で詰まったときも、次のルールに戻ってきてください。 各章の「つまずいたら」からも、ここを案内します。

  • AIの答えが、本に書いてある例と違う:違っていて当然です。AIの答えは毎回少しずつ変わります。答えが一致するかではなく、その章の「次へ進んでよい状態」になっているかで判断してください
  • 同じところで3回止まった:最後にうまく動いていた状態に戻してください。そのうえで新しい会話を始め、ここまでの状況を短くまとめてから聞き直します。同じ会話で同じやり取りを続けても、たいてい抜け出せません
  • それでも解決しない:その章は「次へ進んでよい状態」の一歩手前まででかまいません。ロードマップ用チャットに、どこで止まっているかを報告しておき、日を改めて戻ってきてください
  • AIにも、公開する場所にも載せないもの:パスワード、住所や電話番号などの個人情報は、AIへの質問にも、公開するゲームにも入れないでください

確かめる

この章で用意したのは、AIツールと、そのツールでの聞き方です。 実際に使えるかを、動かして確かめます。

  • AIツールで、新しい会話を始められる(会話の一覧から、前の会話も開ける)
  • 小さなページを作ってもらい、その場でボタンを押して数字が増えた
  • 「一点だけ聞く」で「ブラウザ」について聞き、読み切れる長さの答えが返ってきた

次へ進んでよい状態

上の3つができていれば、先へ進んでかまいません。 コツや共通ルールは、覚えていなくても大丈夫です。 必要な場面で、本の中からくり返し案内します。

つまずいたら

どのAIツールを選べばいいか決められない
すでにアカウントを持っているものがあれば、それを使ってください。なければ、どれでもかまいません。この本はどのツールでも同じように進められるように書いてあります。
アカウントを作るときに、有料プランをすすめられた
この本は無料の範囲で進められます。有料プランを選ぶ必要はありません。無料で続ける選択肢が見つからないときは、画面に出ている文をそのままAIに伝えて聞いてください。
ページが表示されず、作り方の説明やコードだけが返ってきた
無料の範囲では、その機能が使える回数や条件が決まっていることがあります。表示された文をそのまま伝えて、同じ会話で理由を聞いてください。それでも使えなければ、別のツールに切り替えてかまいません。
「一点だけ聞く」の答えが、長すぎたり難しすぎたりした
「さきほどの説明を、もっと短く、専門用語を使わずに言い直してください」と送ってください。聞き直すのは、何度でもかまいません。

ここまでの確認

  • 使うAIツールを決めて、新しい会話を始められる
  • 小さなページを作ってもらい、その場で動くことを確かめた
  • 「一点だけ聞く」を1回使ってみた
  • 詰まったときの共通ルールが、この章にあると知っている

次の一歩

準備ができました。 第2章では、いま用意したAIツールで、さっそくゲームを作ります。 ロードマップ用チャットへの報告は、第3章でチャットを作ってから始めます。