エラー文を読んでも次に進めない。AIアプリの案内を一文だけ直す

AIで作ったアプリに「入力エラー」と出る。でも、どこを直せばよいか分からない。そんな画面を作った人に向けて、利用者が次にできる操作を一文にする方法を紹介します。持ち帰れるのは、確認した条件だけで書いた案内文と、AIへ渡す変更依頼です。

「何が悪いか」より、次の操作が分かるか

エラーを日本語にしただけでは、利用者が先へ進めるとは限りません。「値が不正です」なら、どの欄を、どう変える必要があるのかが残ります。「もう一度お試しください」も、同じ操作を繰り返してよいと確認できた場合にしか案内できません。

今回は、入力欄が空のときに表示する一文を扱います。サーバーの障害や保存の成否を推測する話ではありません。画面に見えた事実と、確認済みの入力ルールを使い、直す場所と次の行動をつなぎます。

一文の型は「どの欄に、何をしてから、どの操作をするか」です。ただし、画面にないボタンや、確かめていない文字数制限を足してはいけません。丁寧な文章より先に、実際に実行できる案内かを見ます。

用意する環境と、時間の目安

必要なのは、変更してよいテスト用アプリ、架空データ、現在の画面を記録するメモ帳です。文案だけを考える段階なら、画面の記録と確認済みの仕様があれば始められます。AIに文章を整えてもらう場合は、普段使うチャットを使えます。

一つの入力欄を選び、記録と案内文を整理する作業枠として15分程度を想定します。人の所要時間は未計測です。実装、動作確認、原因調査にかかる時間は含めていません。条件が分からなければ、その場で完成させず、確認待ちにします。

公開中の利用者データで失敗を再現する必要はありません。名前やメールアドレスなどは架空の値に置き換えます。画面の記録をAIに渡す前に、個人情報や秘密のURLが含まれていないかも確認します。

入力例：案内の根拠を先にそろえる

以下は架空の備品アプリを使った説明用の入力です。実在アプリでの検証結果や、AIが実際に返した回答ではありません。例の中では、作成者が次の条件を確認済みという設定にしています。

入力となる記録：
A：画面の入力欄名は「備品名」、ボタン名は「追加」。
B：「備品名」が空の状態で「追加」を押すと、欄の下に「入力エラー」と表示され、登録処理は始まらない。
C：「備品名」に架空の値「青いノート」を入れて「追加」を押すと、一件追加される。
D：備品名は必須。最大文字数や、空白だけを入れた場合の扱いは未確認。

ここで分かるのは、空欄では進めず、例Cの入力では進めることです。「どんな文字でも登録できる」「20文字以内ならよい」「入力済みの内容は必ず残る」とは言えません。確認した一例から、全入力の動作へ話を広げないようにします。

空欄で登録処理が始まらないというBも、実際のアプリでは確認が必要です。画面にエラーが出たことだけで、裏側の保存が止まったと決めつけません。保存結果が分からないエラーなら、再送信を促す案内を作る前に、作成者へ確認する課題へ戻します。

出力例：空欄のときだけ使う一文にする

入力A〜Dから作る文案は、次の一文です。

「備品名を入力してから『追加』を押してください。」

適用する場所は、備品名が空のときに出る、欄の下の案内です。通信に失敗した場合や、原因が分からない場合まで同じ文言に置き換えるわけではありません。画面にある「備品名」「追加」をそのまま使い、未確認の文字数や原因を加えていないことを入力と照合します。

Before：入力エラー
After：備品名を入力してから「追加」を押してください。

Beforeでは、利用者はどこを直すか探す必要があります。Afterでは、対象の欄と次の操作が文章に現れます。これは文案の比較であり、利用者の成功率が上がった、問い合わせが減ったという実績ではありません。

確認用の組み合わせも残します。
・入力が空：空欄向けの案内が出て、登録処理が始まらないかを確認する。
・入力が「青いノート」：空欄向けの案内が残らず、一件追加されるかを確認する。
・入力が空白だけ：扱いが未確認なので、期待結果を決める前に仕様を確かめる。

三つ目を勝手に「正しい」「間違い」と決めない点が大切です。未確認の条件を残しておくことで、文章の変更依頼が、知らないうちに入力ルールの変更へ広がるのを防げます。

AIへの依頼は、変える文と条件を一緒に渡す

AIへは、入力A〜Dに続けて、次のように依頼できます。

「備品名が空のときの『入力エラー』だけを、『備品名を入力してから「追加」を押してください。』へ変更したいです。まず、この文を出している場所と適用条件を確認してください。必須条件、保存処理、ほかのエラー文は変更対象に含めません。最大文字数と空白だけの入力は未確認のため、新しい制限を追加せず、確認が必要な点として報告してください。」

AIが「修正しました」と答えても、確認はそこで終わりません。テスト用の版で、上の空欄と架空入力の組み合わせを試し、実際に出た文と結果を残します。変更した版がどれかも記録すると、古い画面と見比べる取り違えを避けられます。

確認するのは文章だけではありません。空欄で追加されてしまう、入力しても同じ案内が消えない、別のエラーにも同じ文が出るなら、文案の完成と実装の完了を分けます。原因を確認するまで、ほかの文や保存処理までまとめて直す依頼を重ねないでください。

うまく進まないときと、今回の完成条件

エラーの出る条件が分からない場合は、元の文を保存し、「どの操作のあとに出たか」「どの欄がどうなっていたか」を追記します。「通信の問題です」など、原因を想像して説明文に埋め込む必要はありません。

AIが画面にない「再試行」ボタンを案内したら、その文案を採用せず、実際のボタン名へ戻します。削除、再送信、再ログインなどを提案された場合も、それで問題が解決する根拠と、入力内容への影響が確認できるまでは案内に含めません。

変更後に別の動作が変わったら、追加の修正を止め、変更前の文、変更した版、試した入力と結果を並べます。戻せる検証用の版がある場合は、その版に戻して再確認します。復元方法が分からない状態で、データを消したり上書きしたりして確かめないでください。

今回の文案は、対象の欄、実行できる行動、表示する条件がそろい、入力の記録にない約束を含まなければ完成です。アプリへ反映した場合の完了は、テスト用の版で空欄と架空入力を試し、案内と動作を確認してから判断します。文章を一文直しただけで、アプリ全体の不具合が解消するわけではありません。

この記事では、確認できた条件に合う案内文と、変更範囲を絞った依頼まで作れます。確認中に見つかった不具合を、完全版の記録欄・記入例・AIへの修正依頼文まで一式にまとめたい方には、500円の「AIに『直して』で壊されない。5分で作るバグ報告テンプレ」を用意しています。商品名の時間表現は、今回の作業時間を実測したものではありません。

https://note.com/witty_weasel4527/n/n715bf37ef9b3