こんにちは、時短ギア管理人の清光です。

コードは書けない現役の営業ですが、AIと一緒に、現場が毎日使う業務システムを1年以上つくり続けてきました。

「ちゃんと保存されているはず」のデータが、実は何日も保存されていなかったとしたら——想像すると怖くないですか?

この記事では、自作の業務ツールで実際に起きた「自動保存が1週間まったく効いていなかった」という実話と、コードが読めない人間がそのバグにどう気づいたかを紹介します。

キーボードを打つ手元のクローズアップ

見えるバグと、見えないバグはまったく違う

私はAIにコードを書いてもらって業務ツールを作っていますが、コードの良し悪しは今も判断できません。

判断できるのは「見た目」と「触ったときの手触り」だけです。

画面が真っ白になるような壁は、見た瞬間に分かります。すぐ「壊れた」と報告できます。

ところが、何のエラーも出ず、裏側だけ静かに壊れているバグには、そもそも気づく入口がありません。

実際に起きた2つのバグ

自作ツールを作っている最中、同じ週に重大なバグが2つ重なって出たことがあります。

1つ目は、画面がいきなり真っ白になるバグでした。

原因はAIが同じ名前の変数を2回書いていたことで、これは開いた瞬間に誰でも気づけます。

その日のうちに直してもらい、ここまでは「よくあるトラブル」で済みました。

2つ目が厄介でした。自動保存の機能が、丸1週間まるごと効いていなかったのです。

原因は、保存の処理そのものを生成する1行が足りていなかったことでした。

画面の見た目はいつもと同じで、ボタンも反応し、エラーも一切出ませんでした。

「動いているように見える」が、そのまま1週間続いていたんですよね。

気づけたのは「手触りで確かめる」習慣だった

私がこの不具合に気づけたのは、コードを読んだからではありません。

いつものように入力して、一度閉じて、もう一度開き直してみたからです。

そこで初めて「前に入力した内容のままだ」と気づきました。

コードが読めない私にとって、確認の方法はいつもこれです。「使ってみて、結果を自分の目で見る」。

以前の記事(コードが読めなくてもAIでバグは直せる)でも書きましたが、原因を探すのはAIに任せています。

人間がやるのは「見た目どおりに動いているか」だけを確かめることで、この役割分担が私には合っています。

自分でも真似できる確認のリズム

  1. よく使う画面を1つ決めて、入力してすぐ閉じる。
  2. 少し時間を置いて、もう一度開き直す。
  3. さっき入力した内容がそのまま残っているかを目で確認する。

これを毎日ではなく、新しい機能を入れた直後や、何となく違和感を覚えた日に1回やるだけで十分です。

最初にハマったのが、このリズムを「完成したら終わり」と思って一度もやらなかったことでした。

実際にやってみたら、5分もかからず「大丈夫そう」か「おかしい」かが分かります。

よくある疑問に先回りして答えます

Q. コードが読めないのに、原因まで分かるんですか?

原因そのものを突き止めるのはAIに任せています。

人間がやるのは「直った後、見た目どおりに動いているか」を確かめることだけです。

Q. 毎回すべての画面を確認するのは大変そうです。

すべてを見る必要はありません。

私の場合は、よく使う2〜3画面だけに絞って確認しています。

Q. 同じようなバグを繰り返さないための対策はありますか?

新しい機能を入れたら、その場で一度「使ってみて確かめる」を必ずセットにしています。

「完成した」と「ちゃんと動いている」は別物だと、この件で学びました。

モニターの前で原因を切り分けている男性
見えないバグは、手触りで確かめるしかない

まとめ

  • 見えるバグ(画面が真っ白等)はすぐ気づけるが、エラーの出ない裏側のバグは気づく入口がない
  • コードが読めなくても、「使ってみて結果を自分の目で見る」習慣があれば気づける
  • 新しい機能を入れたら、その場で一度動作を確かめるリズムをセットにする
  • =あなたの自作ツールやシステムでも、同じ確認を1回挟むだけで、見えない事故を防げるかもしれません

今日はここまで。この記事が、あなたの時間を少しでも価値に変えるお手伝いになれば嬉しいです。

それでは、また次の時短ハックでお会いしましょう。

自作している業務システムのことや、お仕事のご依頼はお問い合わせからどうぞ。