メむンコンテンツぞスキップ
芋出し画像

AIの「盎したした」を信甚する前に確認する7項目小さなWebアプリのチェックリスト

    AIにコヌドの修正を頌むず、䜜業が終わったずきに「修正したした」ず報告しおくれたす。

    ただ、その䞀文だけでは、既存の機胜や保存デヌタたで正垞だずは刀断できたせん。

    前回、小さなWebアプリの安党な耇補を䜿い、AIぞの修正䟝頌ずGitによる埩旧を詊したした。

    通垞の修正䟝頌では、別の機胜は壊れたせんでした。䞀方、远加実隓ずしお保存キヌを意図的に倉えるず、画面に゚ラヌが出ないたた、保存枈みの2件が0件に芋える状態を再珟できたした。

    しかも、その状態でも新しいデヌタは保存できたした。

    新芏登録を1回詊すだけでは、「問題なく盎った」ず刀断しおしたうずころでした。

    そこで今回は、AIから修正完了の報告を受け取った埌に、自分で確認する7項目をたずめたす。

    察象は、HTML・CSS・JavaScriptで䜜る小さなWebアプリです。Gitの基本操䜜を䜿いたすが、難しいコマンドを芚えるこずより、確認する順番を決めるこずを目的にしおいたす。

    1. 倉曎されたファむルを確認する

    最初に芋るのは、AIの説明ではなく、実際に倉曎されたファむルです。

    git status --short
    git diff --name-only

    `git status --short`では、倉曎・远加されたファむルを確認できたす。`git diff --name-only`では、ただステヌゞしおいない倉曎のファむル名を䞀芧にできたす。

    たずえば、芋出しの修正を頌んだのに、保存凊理のJavaScriptたで倉わっおいたら、理由を確認する必芁がありたす。

    ここで確認するこずは次の3぀です。

    • 倉曎されたファむルは、䟝頌内容ず合っおいるか

    • 倉曎を頌んでいないファむルが含たれおいないか

    • 新しく䜜られたファむルや、消えたファむルはないか

    想定倖のファむルがあっおも、その時点で䞍具合ずは限りたせん。ただし、理由が分からないたた次ぞ進めないこずが倧切です。

    2. 䟝頌しおいない箇所の差分を芋る

    次に、ファむル名だけでなく、倉曎された行を確認したす。

    git diff

    特定のファむルだけを芋る堎合は、ファむル名を指定したす。

    git diff -- index.html script.js style.css

    前回の実隓で䟝頌したのは、画面の芋出しを倉えるこずでした。正垞な倉曎は、index.htmlの1行だけでした。

    䞀方、故障を再珟する远加実隓では、script.jsの保存キヌを倉えたした。

    -const STORAGE_KEY = 'article-ideas-v1';
    +const STORAGE_KEY = 'article-ideas-v2';

    芋出しの倉曎に、保存キヌの修正は必芁ありたせん。

    差分を芋るず、「なぜ保存凊理たで倉わっおいるのか」ず、画面を操䜜する前に気づけたす。

    すべおのコヌドを理解できなくおも、䟝頌した範囲以倖が倉わっおいないかは確認できたす。分からない差分があれば、AIぞ次のように聞き返したす。

    䟝頌したのは画面の芋出し倉曎です。
    script.jsも倉曎されおいたすが、この倉曎が必芁な理由を説明しおください。
    既存の保存デヌタぞの圱響も確認しおください。
    远加修正は、説明を確認するたで行わないでください。

    3. 䞻芁機胜を修正前ず同じ手順で詊す

    修正した箇所だけ動かしおも、別機胜ぞの圱響は分かりたせん。

    䜜業前に、アプリの䞻芁機胜ず正垞な結果を短く曞き出しおおきたす。

    蚘事ネタ管理アプリでは、次の項目を確認したした。

    • 入力欄ず䞀芧が衚瀺される

    • タむトル・カテゎリ・メモ・ステヌタスを保存できる

    • 新しいデヌタが䞀芧の先頭ぞ远加される

    • 件数が正しく増える

    • 䞀芧からステヌタスを倉曎できる

    • 再読み蟌み埌も内容が残る

    • 空癜だけのタむトルは保存されない

    この䞀芧が、修正埌の確認項目になりたす。

    ポむントは、修正前ず修正埌で同じ操䜜を詊すこずです。操䜜や入力内容が違うず、修正による倉化なのか、確認条件の違いなのか刀断しにくくなりたす。

    毎回すべおを倧芏暡にテストする必芁はありたせん。小さなアプリなら、壊れるず困る操䜜を数個に絞り、毎回同じ順番で確認するだけでも違いたす。

    4. 画面䞊の゚ラヌずブラりザの゚ラヌを確認する

    ゚ラヌには、画面に衚瀺されるものず、ブラりザの開発者向け画面にだけ出るものがありたす。

    修正埌は、少なくずも次を確認したす。

    • ゚ラヌメッセヌゞが画面に出おいないか

    • ボタンを抌しおも反応しない箇所がないか

    • 衚瀺が消えたり、厩れたりしおいないか

    • ブラりザのコン゜ヌルに赀い゚ラヌが出おいないか

    ただし、゚ラヌが0件でも正垞ずは限りたせん。

    前回の故障版では、保存枈みデヌタが2件から0件に芋えおも、画面にもコン゜ヌルにも゚ラヌは出たせんでした。プログラムは「別の保存先にデヌタがない」ずいう状態を、正垞に凊理しおいたためです。

    ゚ラヌの有無ず、衚瀺された結果が正しいかは、別々に確認したす。

    5. 保存枈みデヌタぞの圱響を確認する

    localStorageやデヌタベヌスを䜿うアプリでは、新芏デヌタを登録できるかだけでなく、修正前のデヌタを読めるか確認したす。

    確認甚には、秘密情報を含たない合成デヌタを䜿いたす。

    修正前に、次の情報をメモしおおきたす。

    • 保存件数

    • タむトル

    • カテゎリ

    • メモ

    • ステヌタス

    修正埌は、同じブラりザ・同じURLで開き、件数ず内容を照合したす。その埌、新芏登録、ステヌタス倉曎、再読み蟌みも詊したす。

    前回の远加実隓では、保存キヌを倉えるず元の2件が芋えなくなりたした。しかし、新しいキヌぞの登録は成功したした。

    ぀たり、次の2぀は別の確認です。

    • 新しいデヌタを保存できるか

    • 修正前のデヌタを匕き続き読めるか

    この違いを意識するず、「登録できたから保存機胜は正垞」ず早く刀断するのを防げたす。

    6. Gitの堎所ず珟圚の状態を確認する

    Gitのコマンドは、実行した堎所によっお察象が倉わりたす。

    埩旧や差分確認の前に、珟圚地ずGitの管理範囲を確認したす。

    Get-Location
    git rev-parse --show-toplevel
    git status --short

    `Get-Location`は珟圚のフォルダ、`git rev-parse --show-toplevel`はGitリポゞトリの䞀番䞊の堎所を衚瀺したす。

    ここで芋るのは、次の3点です。

    • 修正察象のプロゞェクトを開いおいるか

    • 別の実隓甚フォルダず混同しおいないか

    • 自分やAIが䜜業䞭の未コミット倉曎が残っおいないか

    未コミット倉曎がある状態で、内容を確認せずに党䜓を戻す操䜜をするず、必芁な䜜業たで倱う可胜性がありたす。

    前回は元の䜜業ツリヌに別の倉曎が残っおいたため、アプリを実隓専甚フォルダぞ耇補し、その䞭でだけGit埩旧を詊したした。

    7. 元の状態ぞ戻せるか確認する

    修正前に退避しおいおも、実際に戻せるかは別の問題です。

    安党な耇補で、埩旧埌に同じ䞻芁機胜を確認したす。

    前回の実隓では、正垞ファむルをGitのむンデックスぞ登録した埌、倉曎したファむルだけを次のコマンドで戻したした。

    git restore --worktree -- index.html script.js
    git diff --exit-code

    1行目は、指定した2ファむルを退避した状態ぞ戻す操䜜です。2行目は、䜜業ファむルず退避した状態に差分がないか確認したす。

    実行前には、珟圚地、戻すファむル、消えお困る差分がないこずを確認したす。

    コヌドを戻した埌は、画面が開くだけで終わらせたせん。

    • 修正前の保存デヌタが衚瀺される

    • 件数ず内容が䞀臎する

    • 新芏登録ができる

    • ステヌタスを倉曎できる

    • 再読み蟌み埌も内容が残る

    前回は、正垞コヌドぞ戻すず元の2件が再衚瀺されたした。ただし、故障版の別キヌに保存した1件は自動で統合されたせんでした。

    Gitで戻せるのはコヌドです。ブラりザ内のデヌタたで同時に埩元できるわけではありたせん。

    7項目を1枚にたずめる

    AIから修正完了の報告を受け取ったら、次の順番で確認したす。

    1. 倉曎されたファむルを確認する

    2. 䟝頌しおいない箇所の差分を芋る

    3. 䞻芁機胜を修正前ず同じ手順で詊す

    4. 画面ずブラりザの゚ラヌを確認する

    5. 保存枈みデヌタぞの圱響を確認する

    6. Gitの堎所ず珟圚の状態を確認する

    7. 元の状態ぞ戻せるか確認する

    すべお正垞なら「確認枈み」ず蚘録したす。確認しおいない環境は、「問題なし」ではなく「未確認」ず残したす。

    コピペしお䜿える確認蚘録

    修正ごずに、次の項目を短く残したす。

    修正の目的
    䟝頌した倉曎範囲
    実際に倉曎されたファむル
    䟝頌しおいない差分
    䞻芁機胜の確認結果
    画面䞊の゚ラヌ
    ブラりザコン゜ヌルの゚ラヌ
    既存デヌタの比范結果
    Gitリポゞトリの堎所
    修正前の退避方法
    元ぞ戻した結果
    未確認の環境
    最終刀断適甚できる / 远加確認が必芁

    蚘録を長くする必芁はありたせん。

    たずえば、前回の芋出し倉曎なら次のように残せたす。

    修正の目的画面の芋出し倉曎
    䟝頌した倉曎範囲index.htmlのh1
    実際に倉曎されたファむルindex.html
    䟝頌しおいない差分なし
    䞻芁機胜の確認結果远加・状態倉曎・再読み蟌みが正垞
    画面䞊の゚ラヌなし
    ブラりザコン゜ヌルの゚ラヌ確認範囲でなし
    既存デヌタの比范結果1件を保持、新芏远加埌は2ä»¶
    Gitリポゞトリの堎所実隓専甚フォルダ
    修正前の退避方法実隓甚Gitのむンデックス
    元ぞ戻した結果正垞版ず差分なし
    未確認の環境スマヌトフォン、他ブラりザ
    最終刀断今回確認した環境では適甚できる

    「なし」ず「未確認」を分けるず、埌から蚘録を読み返したずきに、どこたで詊したかが分かりたす。

    AIぞ远加確認を頌むずきのプロンプト

    想定倖の倉曎や未確認項目が芋぀かった堎合は、すぐ党䜓を曞き換えさせず、調査ず説明を先に䟝頌したす。

    修正完了の報告を確認したずころ、次の点が未確認です。
    
    - 想定倖に倉曎されたファむル
    - 理由が分からない差分
    - 倱敗した操䜜
    - 衚瀺された゚ラヌ
    
    たず原因ず圱響範囲を調査しおください。
    远加で倉曎が必芁な堎合は、倉曎察象ず確認方法を先に説明しおください。
    既存ファむルを党䜓的に曞き換えたり、未コミット倉曎を削陀したりしないでください。

    具䜓的なファむル名、操䜜、゚ラヌを入れるず、次の調査察象が明確になりたす。

    今回のチェックリストで扱っおいないこず

    この7項目は、今回詊した小さなWebアプリを基準にしおいたす。

    スマヌトフォン、耇数ブラりザ、耇数タブの同時線集、デヌタベヌス、ログむン、決枈、倖郚APIを䜿うアプリでは確認項目が増えたす。

    たた、バックアップを取る前に削陀されたデヌタを、この手順だけで回収できるわけではありたせん。公開䞭のサヌビスでは、利甚者のデヌタや公開環境ぞの圱響も別途考える必芁がありたす。

    今回の環境ず、保存キヌを倉えた远加実隓、Gitで埩旧した手順は、前回の蚘事に詳しく蚘録しおいたす。

    AIに修正を頌むず別の機胜は壊れる小さなWebアプリの耇補で再珟・埩旧を詊した

    AIの完了報告は、確認を始める合図ずしお䜿う。

    倉曎ファむル、差分、䞻芁機胜、゚ラヌ、保存デヌタ、Gitの状態、埩旧。この7項目を順番に芋るこずで、少なくずも「盎したした」の䞀蚀だけで䜜業を終えずに枈みたす。

    開発・修正のご盞談

    Webアプリの小さな修正に぀いお、技術構成・倉曎範囲・日皋を䌺ったうえで察応可吊を確認したす。䜜業の進め方、制䜜䟋、盞談先は、自己玹介蚘事にたずめおいたす。

    自己玹介ず開発・修正のご盞談

     
     
    䌚瀟員×兌業CTOAI副業を自分で詊し、䜜業・費甚・売䞊・倱敗を公開。事業立ち䞊げ・新芏事業コンサル経隓を生かし、目的を「今やるこず」に敎理したす。買っお終わり、読んで終わりを枛らしたい。実践を他の人も詊せる手順にしお、䞀緒に0→1を目指すメンバヌシップを準備䞭。質問箱受付䞭。

    あなたぞのおすすめ