AI係長AI係長yuuの引き継ぎ書AIでうまくいった話は、ここにはありません。

04

抜け漏れ

ほとんど集まっているので、完成したように見える。

実際に起きたこと4件

  • 比較サイト

    知っている商品が、1つだけ抜けていた

    商品の情報を自動で集めて一覧にする作業での話です。一覧はほぼ埋まっていました。

    ただ、自分が知っている商品が1つ入っていない。9割方うまくいっていたので、あとで見返すまで気づきませんでした。

    自分が詳しい分野だったから気づけました。知らない分野だったら、そのまま「完成」として扱っていたはずです。

  • 比較サイト

    集めたつもりが、半分も拾えていなかった

    レビューを自動で集めていました。集まった数だけ見ていると、うまくいっているように見えます。

    でも実際には、まだ半分も拾えていませんでした。取れているものだけを眺めていると、取れていないものの存在に気づけません。

  • 比較サイト

    「だいたい集まった」と「網羅した」は違う

    あとで見返して「今売られているものは全部載っているか」と数えたときに、初めてこの差に気づきました。

    だいたい集まった状態から、抜けをゼロにするまでの距離は、想像よりずっと長い。そして抜けは、抜けている側からは見えません。

  • データ収集

    メニューの文字を本文と間違えて、0件になった

    ページの中から必要な部分だけを取り出す処理で、ページ上部のメニューの文字を、本文の始まりだと誤って判断していました。

    結果、対象が全部0件になりました。これは0件だったので気づけました。もし中途半端に半分だけ取れていたら、気づけなかったと思います。

見つけにくい理由

9割が正しく集まっていると、残りの1割に目が行きません。しかも「何が抜けているか」は、抜けている側からは絶対に分かりません。

そもそもの原因

集める元のページの作りが、全部同じとは限らないからです。1つでも違う形のページがあると、そこだけ静かに落ちます。

自分で再現してみる

読んで納得するより、1回自分で起こしてみるほうが早いです。これは、こちらが実際にやった手順です。

全12件が載った一覧から、意図的に1件だけ形式の違う行(例:区切り文字が全角)を混ぜたものを渡し、「全部抜き出して表にして」と頼む。出てきた件数が12かどうかを数える。件数を先に言わないこと。

この型を防ぐには

やることは3つです。渡す相手が、それぞれ違います。

① 覚えておくこと

自動で集めたら、自分が確実に知っている10件が入っているかを確認する。全体の正しさは測れないが、抜けは測れる。

② CLAUDE.md に書き足すこと

いつ貼るか

Claude Code の会話に貼る。ファイルは自分で開かなくて構いません

貼るとAIが CLAUDE.md を書き換えます。1回書けば、次の会話からも効きます。

そのまま貼れる文(AIが CLAUDE.md に書き足します)
次の決まりを、いま作業しているフォルダの CLAUDE.md に書き足してください。
ファイルが無ければ作ってください。

集めた結果について、次を報告してください。

1. 集めようとした総数と、実際に取れた数、その差
2. 取れなかったものの一覧と、取れなかった理由の内訳
3. 途中でエラーになったが、処理を続けた箇所があればその一覧

これから私が知っている項目をいくつか挙げるので、それが結果に入っているかを1件ずつ確認してください。

守ってほしいこと
・文はそのまま書いてください。言い換えないでください
・すでにある決まりは消さないでください
・似た決まりが既にあれば、書く前に教えてください
・書いたあと、CLAUDE.md 全体をそのまま表示してください

この貼り方が動くか、数えました

上の文をそのまま4種類のAIに3回ずつ渡して、 できあがったファイルを機械で読みました(2026-08-16)。

① 正しいファイルに書いた    12回中 12回

② 前からあった決まりが残った  12回中 12回

③ 文がそのまま入った      12回中 12回

④ 書いたあと、中身を見せた   12回中 11回

落ちた1回は、書けてはいました。「完了しました」とだけ返して、ファイルを見せませんでした(Haiku 4.5)。これがこのサイトの型⑦です。見せてこないときは、「CLAUDE.md を全部見せて」ともう一度言ってください。

Haiku 4.5・Sonnet 5・Opus 5・Fable 5/ 書き方は少し変わります(2文が1行にまとまる回がありました)。 文そのものは12回とも変わっていません。

どのフォルダで作業しても守ってほしいときは、貼る前に、1行目の「いま作業しているフォルダの」を ~/.claude/ に書き換えてください。その場合、作業フォルダの外に書くので、Claude Code が許可を聞いてきます(聞かれたら「はい」を選びます)。※ 書き換えたほうの形は、まだ数えていません。上の12回は、書き換えない状態のものです。

最後の1文が効きます。全体の正しさは確かめようがありませんが、自分が知っている数件が入っているかは確かめられます。

長くなってきたら

型は14個ありますが、まず入れるのは自分が実際に踏んだ型だけで足ります。それでも増えてきたら、.claude/rules/ に置いて「どのファイルを触ったときに読むか」を指定すると、ふだんの分量が減ります。

※ @ で別のファイルに分けても、読み込まれる量は減りません(公式の説明)。分けるのは、自分が直しやすくするためです。

→ 置き場所・ファイル名・分け方

③ 自分で確かめること — いま動いているものが、この型になっていないか

自動で作った一覧を開いて、自分が知っている項目を5つ探してみてください。

一覧に戻る