記事一覧

「本番のログを見て原因を調べて」と頼みかけて、手が止まる。エージェントは調べるだけでなく実行までできるので、渡す鍵の重さがそのまま事故の大きさになります。渡さない・絞る・追える、の順で権限を整理する手順をまとめました。

バージョンを上げたらビルドが通らない。AIに投げると直してはくれるけれど、それが正しい直し方かは別の話です。破壊的変更のうち自分たちに効くものだけを選び、1つずつ上げて、自分の目で確かめる——手戻りしにくい進め方をまとめました。

「動きません」から始まる障害報告は、原因より先に情報が足りません。AIに原因を当てさせるのではなく、足りない情報を洗わせて再現手順の形に整える——集める・整える・削るの3ステップにまとめました。

AIに頼むと、リリース前チェックリストはすぐ出てきます。ただ、そのままだと「テストを実行する」のような、どの現場にも当てはまる代わりに今回の役には立たない行が並びがち。今回の差分から効く項目を出させる頼み方と、判定できる形への直し方を整理しました。

AIが書いたコードのエラー処理は、たいていきれいに整っています。ただ、失敗したことが誰にも伝わらないまま先へ進んでいることがある。捕まえる場所の決め方、握りつぶしの見つけ方、失敗経路の確かめ方を、明日ひとつ試せる形で整理しました。

AIに頼んだDockerfileは、たいていちゃんとビルドが通ります。ただ、動くことと、本番に置いていいことは別の話。イメージがなぜか重い、rootのまま動いている、ビルド時の鍵が履歴に残っている——受け取ったあとにどこを見ればいいかを、順番に整理しました。

AIが書いた日付の処理は、だいたい動きます。ただ、深夜と月末と海外だけ静かにズレる。時差の入れ方、日付の区切り、月末の扱いまで、レビューでどこを見ればいいかを順番に整理しました。

「あのAIの機能、遅くないですか」と言われた日に。待ち時間の中身を分けると、実は「速くする」より先にできることがあります。最初の一文字を早く出すストリーミング、途中で詰まるバッファの外し方、向かない場面の見分け方まで、明日ひとつ試せる形で整理しました。

テストは全部緑なのに、本番でだけ落ちた。原因をたどるとモックが本物と少し違っていた——現場でよくある一日です。AIはモックを作るのが速い代わりに、本物を見ずに「こうなっているはず」で書きます。嘘をつくモックに気づくための確認手順を、そのまま使える頼み方つきで整理しました。

「タスク一覧を出しておいて」と言われた夜に。AIはタスク分解が速い代わりに、うまくいく順路だけを並べます。抜けやすいのは決まっていないこと・他人が絡むこと・後片付け。粗く出して、抜けを名指しで洗わせる手順を整理しました。

YAMLやenvの書式をうろ覚えのまま検索するより、AIに聞いたほうが早い。ただ設定ファイルは、構造と秘密の値が同じ場所に同居しています。貼る前に値を伏せる・形だけ書かせる・機械に見張らせる。明日ひとつ試せる手順を整理しました。

「重い」と言われてAIに聞いたら、改善案が十いくつ返ってきた。全部やる時間はないし、どれが効くのかも分からない。AIが得意なのは候補を並べることで、どれが効くかを知っているのは計測した数字のほうです。測ってから1つずつ直す、明日ひとつ試せる手順を整理しました。

AIが書いた並列処理は、手元では気持ちよく動きます。おかしくなるのは、同じ瞬間に二つの処理が同じものに触ったときだけ。だから普段のテストでは出てきません。「同時に来るもの」を先に3行書いてからAIに渡す、明日ひとつ試せる確認の手順を整理しました。

権限まわりの設計は、間違えたときに取り返しがつきにくいぶん、ひとりで決めるのが怖い場所です。AIに相談すると立派な権限表は返ってきますが、実際に穴が空くのは表の外側でした。AIに「案を出させる」から「穴を探させる」へ切り替える詰め方を整理します。

pull したらコンフリクト、しかも金曜の夕方。AIに投げるとマーカーはきれいに消えるのに、片側の変更が静かに消えていることがあります。もとの状態を見せる設定から、解消後の差分確認まで、明日ひとつ試せる形で整理しました。

使っているモデルの提供終了の告知を見て、ひやりとしたことはありませんか。乗り換えはいつか来る前提で、呼び出しの窓口を一つにまとめ、プロンプトと合格例を外に出しておく。明日ひとつ試せる形で、疎結合な組み込み設計を整理しました。

AI機能の請求額と応答の遅さを見ながら「同じことを何回も聞き直している気がする」と感じたら、キャッシュの出番です。まず完全一致から入れる順番、鍵に何を入れるか、他人の回答が漏れない作り、効かなくなったときの捨て方まで、明日ひとつ試せる形で整理しました。

「このAI、業務で使っていいんですか」と聞かれて言葉に詰まる——決まりが無いまま各自の判断で進んでいる状態は、現場にとっても落ち着かないものですよね。禁止リストではなく、A4一枚で「使う道具・入れない情報・人が確認・相談先」を決めるところから。現場目線で作って、形骸化させない進め方を整理しました。

AIの出力をそのまま業務テーブルに入れるのは、正直こわいですよね。形式は正しいのに中身が業務的にありえない——その一件が本番データに残ると、後から誰も気づけません。形式・中身・業務ルール・人の目という4つの関門と、下書きから確定へ進める書き戻し方を、明日そのまま仕込める順番で整理しました。

赤い型エラーをAIに投げたら一瞬で消えた——でも、よく見るとanyや`as`で黙らせているだけ。エラーは消えても、型が守ってくれていた安全網ごと外れていることがあります。この記事は、AIに型エラーを直させるときに「消しただけ」を「ちゃんと直した」に変えるための、渡し方・確認の型をまとめました。any・`as`・`@ts-ignore`が紛れていないかを見る目と、そのまま使えるプロンプトつきです。