この回は研修の導入部で、全文を公開しています。コマンドと出力はすべて手元で実行したものをそのまま載せています。シェルと Python があれば再現できます。
Claude Code の公式ドキュメントにはこう書かれています — Claude は作業が「終わったように見えた」ときに止まる。 自分で走らせられる検査がなければ、「見た目」が唯一の判断材料になり、あらゆる誤りがあなたの発見待ちになる。
これは Claude 固有の話ではなく、合否を自分で確かめる手段を持たないすべてのエージェントに当てはまります。 そして多くの現場では、そこで人間がレビューに入る。つまり人間が検証ループの一部になっている。コードが書かれる速さが人の読む速さを超えた今、このループは破綻します。
型 1: 終了コードがパイプで消える。 エージェントはしばしば cmd | tail のように出力を絞って実行し、$? を見て「成功」と判断します。
研究室では Bash の出力を圧縮するフィルタを常用しており(実測で約 8 割削減)、便利な反面成否の判断材料まで削られる。 だから「成否は終了コードと成果物で見る。見た目で判断しない」がルールになっています。
型 2: 検出力のないテスト。 AI にテストも書かせると、「通るテスト」はいくらでも書けます。税込み価格の関数に対して AI が書いたテストを例にします。
return 0 でも全テストが通ります。エージェントの報告は「2 件のテストがすべて通りました ✅」。嘘ではないが、何も保証していない。
テストが通っているのは、検出力が無いからかもしれない。 「わざと壊したら落ちるか」を測らない限り、緑が本物かは分かりません(第 3 回: 変異注入)。
型 3: 沈黙する検査器。 型検査器・重いビルド・長い探索は、成功しても、メモリ監視に殺されても、最後に出る 1 行が同じことがあります。 キャッシュ済みのビルドも「何も再検査せずに一瞬で成功」と見える。これは次の節の事故そのものです。
2026 年 8 月 8 日、研究室の Agda による形式化(約 1 万行)の型検査をエージェントに走らせました。エージェントは 4 回続けて「型検査が通りました」と報告しました。
実際には、検査器は 47GB のメモリを使ってメモリ監視(earlyoom)に SIGTERM で殺されていた。
成功時も、殺されたときも、ターミナルに出る最後の 1 行は同じ Checking … で、エージェントはそれを成功と読んだのです。
人間も同じ間違いをします。問題は AI ではなく、「見た目」以外の判断材料を渡していなかったことでした。それ以来、研究室では次をルールにしています。
| 罠 | 何が起きるか | 対処 |
|---|---|---|
| OOM kill と成功が区別できない | 最後の 1 行が同じ | 成果物の生成で確かめる(.agdai / .vo / .olean / ビルド産物 / DB) |
| パイプで終了コードが変わる | cmd | tail; echo $? は tail の成否 | out=$(cmd); rc=$? |
| 出力が圧縮されている | 成否の判断材料も削られる | 終了コードと成果物で見る |
| キャッシュ済みビルド | 何も再検査していないのに一瞬で「成功」 | キャッシュ済みビルドを検証と呼ばない |
| 緑が本物か分からない | 検出力が無いだけかもしれない | 変異注入で「わざと壊したら落ちるか」を測る |
全 8 回のうち、この回だけ読んで帰るなら、これだけ持ち帰ってください。エージェントへの指示に次を足す。
| 方針 | 弱い指示 | 強い指示 |
|---|---|---|
| 判定条件を渡す | 「メール検証の関数を書いて」 | 「validateEmail を書いて。a@example.com は true、invalid は false、a@.com は false。実装後にテストを走らせて」 |
| 症状と直り方を渡す | 「ビルドが失敗する」 | 「このエラーでビルドが落ちる:[貼付]。直してビルドが成功することを確認して。エラーを抑制せず根本原因を直して」 |
| 再現テストを先に | 「ログインのバグを直して」 | 「セッション期限切れ後にログインが失敗する。まず失敗するテストを書いて、それから直して」 |
| 証拠を出させる | 「できたら教えて」 | 「実行したコマンド・戻り値・テスト出力を貼って。『成功しました』だけの報告は不可」 |
証拠を読むほうが、自分で再実行するより速い。そして、見ていなかったセッションにも効きます。 これを「お願い」ではなく機械的な保証(ターンを終わらせないフック、コミットを止めるゲート)に変えていくのが第 2 回以降です。
第 1 回では、受講者が普段使っているエージェントに対して、上の「強い指示」を実際に書き、証拠つきの報告が返ってくるまでを 90 分で体験します。