Loading...
CONTACT

直す順番を間違えると、直したものがまた壊れます

worklogを読み返したら、AIが「何を」ではなく「どの順番で」直すかを決めた記録が3件ありました。

AIが下書きし、佐久間が確かめました

2026-11-16 / 仕事

直す順番を間違えると、直したものがまた壊れます

ここ2週間のworklogを読み返していて、同じ種類の判断が3件、別々の案件で出てきていることに気づきました。何を直すかではなく、どの順番で直すかを決めた記録です。

どれも、直す中身は最初から分かっていました。それでもAI(Claude Code)は、手を付ける前に順番を決めて、その理由をログに書いていました。

1件目:データを先に戻すと、翌朝また入れ直される

ある管理画面で、2社に本来まだ出ないはずの請求が起きていました。原因は、登録のときに入ってはいけない「契約開始日」が保存されていたことです。

直すことは2つです。コードを直して、もう保存されないようにする。それから、入ってしまった契約開始日と請求を取り消す。

先にデータを戻したくなります。お客さんに関わるのはそちらだからです。でもAIは、コードの本番反映を先にして、データの取り消しは後にしました。ログの理由はこうです。

先に戻すと、今のコードの毎朝の自動処理が
翌朝また契約開始日を入れ直すため

きれいに戻しても、古い仕組みが動いているあいだは、また同じものが入ってきます。取り消しのスクリプトは先に作って、実際には何も変えない「試し実行」まで済ませておき、本番反映を確かめてから流しました。

2件目:6つ全部に流す前に、1つで確かめる

あるネットショップで、送料をケース数に応じた重さ別の料金に作り直しました。対象の地域の区分(マーケット)は6つあり、どれも同じ形の設定です。

スクリプトは1本なので、6つまとめて流すこともできました。でもAIは沖縄の1つだけ先に作り、わたしが実際にカートに入れて確かめるのを待ってから、残りの5つに流しました。

作り直しの手間を、1マーケットで済ませるため

確かめたのは、1ケース・2ケース・39ケース、それから上限を超える40ケースです。もし重さの区切りがずれていたら、6つ全部を作り直すことになっていました。1つなら、作り直しも1つで済みます。

3件目:途中で止まっても、空の記事が公開されないように

あるサイトに、別のサイトのお知らせを1日2回、自動で取り込む仕組みを作りました。記事1件を取り込むのに、やることは4つあります。

AIは、この順番にしました。

1. 下書きで記事を作る
2. 取り込み元のURLを記録する
3. 画像を保存する
4. 公開する

理由は、どこで止まっても、重複や空の公開記事が残らないようにです。画像の保存で止まっても、残るのは下書きだけです。取り込み元のURLを先に記録しておけば、次に動いたときに同じ記事をもう1件作らずに済みます。

自動の取り込みは、人が見ていないときに動きます。途中で止まったことに、すぐには誰も気づきません。だから、止まった場所に何が残るかを先に決めていました。

3件に共通していたこと

並べてみると、AIが順番を決める前に考えていたことは、3件とも同じ形でした。

1件目 直したあとに、何が元に戻しに来るか → 毎朝の自動処理
2件目 間違っていたら、何回やり直すか   → 6回か、1回か
3件目 途中で止まったら、何が残るか    → 公開記事か、下書きか

どれも、うまくいったときの話ではありません。うまくいかなかったとき、あるいは自分以外の何かが動いたときに、何が起きるかから逆に決めています。

わたしはコードを書かないので、こういう判断はログを読むまで気づきませんでした。作業の報告だけ見れば「直りました」の一言です。順番がまちがっていても、その日の報告はたぶん同じ「直りました」で、翌朝にまた請求が起きてから気づくことになります。

学んだこと

これまでAIに直してもらうときは、「何を直すか」を説明することに力を入れていました。「いいプロンプトは、人にも伝わる説明でした」で書いたとおり、前提を厚く書くようにしています。

これからは、直す対象のまわりで勝手に動いているものも書いておこうと思います。毎朝の自動処理、定時の取り込み、同じ設定を使っているほかの画面。今回の3件はAIが自分で見つけてくれましたが、コードに書かれていないもの、たとえば人が毎週手でやっている作業は、AIには見えません。

直す中身が合っていても、順番がまちがっていれば、直したものはまた壊れます。

この話の続きは、サイトの中にあります

開発の進め方を見る →

佐久間

コードは書かず、AIに「こう作りたい」を伝えてプロダクトをつくる、いわゆるバイブコーディングで開発しています。だから毎日いちばん書いているのは、コードではなくAIへの説明(プロンプト)です。この記事は、その説明に「まわりで勝手に動いているもの」も書き足そうと決めた話です。

この人が書いた記事 →

前後の記事

ほかの記事

こういう直し方を、お手伝いしています。

相談してみる →
← ブログ一覧へ戻る