AIを使って、自分のサービスや作りたかった機能を形にできた。でも、できあがったコードを開くと、知らない言葉ばかりで何をしているのか分からない。このまま進めて大丈夫なのか、不安になることはありませんか。
先にお伝えすると、コードを一行ずつすべて理解しないと、先に進めないわけではありません。まずは「どこにデータを保存するのか」「外部サービスとどうやりとりするのか」「利用者の操作から何が起きるのか」という大枠をつかむことが大切です。
受講生のYさんも、AIでコードを作れた一方で、中身が読めず、このまま進めてよいのか迷っていました。AIで作れることと、安心して運用できることの間には、少し距離があります。その距離を埋めるために、コードをどこから見ればよいか整理してみましょう。
まずは、コードの役割を大きく分ける
最初に確認したいのは、コードが何を担当しているかです。細かな文法を追うよりも、次の三つを探すと全体像をつかみやすくなります。
- データの保存先:ユーザー情報や投稿内容などを、データベースに保存しているか
- 外部とのやりとり:決済、メール送信、地図表示などを、APIを通じて呼び出しているか
- 処理の流れ:画面で操作したあと、どの処理が動き、何が表示されるか
たとえば、フォームに入力して送信する機能なら、「入力画面」「送信を受け取る処理」「データベースへの保存」「完了画面」の順にたどります。ファイル名や関数名だけで判断しにくいときは、画面の操作を起点にして、次に何が起きるかを見ていきます。
ここで目指すのは、すべての記述を説明できることではありません。「この機能では、どのデータが、どこに送られ、どこに保存されるのか」を自分の言葉で言えることです。


お金・個人情報・削除は中身を確認する
大枠をつかむだけで十分とは言い切れない部分もあります。特に、お金、個人情報、データの削除に関わる処理は、コードの中身を確認しましょう。
決済なら、料金や課金の条件、決済が完了したと判断する処理を見ます。個人情報を扱うなら、どの項目を保存するのか、誰が見られるのか、外部サービスに送るのかを確かめます。削除機能では、画面から消えるだけなのか、データベースからも削除されるのかが重要です。
こうした処理は、動作確認だけでは分からないことがあります。画面上で問題なく動いても、想定していないデータを保存していたり、削除したつもりの情報が残っていたりする可能性があるためです。
また、AIが作った説明だけを根拠にせず、実際のコードの場所も確認します。AIに「どのファイルの、どの処理を見ればよいか」を示してもらうと、調べる範囲を絞りやすくなります。
AIに「全体像」と「確認箇所」を聞く
コードが読めないときは、AIに説明を頼む方法があります。ただ「これは何ですか」と聞くより、何を知りたいかを分けて伝えると、次の行動につながる回答を得やすくなります。
たとえば、次のように尋ねてみてください。
この機能の処理を、画面の操作からデータの保存まで順番に説明してください。関係するファイル名も挙げ、コードのどの部分を根拠にしたか示してください。お金・個人情報・削除に関わる処理があれば、その箇所と確認すべき点も教えてください。不確かな点は推測せず、不確かだと書いてください。
説明を受け取ったら、ファイル名や該当箇所を実際に開き、説明と合っているかを確かめます。AIの回答にも間違いや見落としはあり得ます。APIキーや個人情報など、外部に出したくない内容は入力しないよう注意してください。
不安を整理しながら、作りたいものを進める
独学でAIに質問しながら進めることもできます。ただ、説明が正しいか判断できないと、調べ直すうちに「どこまで分かれば進めてよいのか」が見えなくなり、手が止まることがあります。コードを全部理解しようとして疲れてしまう人もいます。
どこまで読めば安心か、影響の大きい処理はどこか。一人だと判断に迷い、不安を抱えたまま進めてしまうこともあります。AIで自分のサービスややりたいことを形にしたい方は、作っているものを一緒に見ながら相談してみる方法もあります。ZELK IT・AI相談所では、コードの読みどころの整理から、1対1で伴走しています。



