引き継ぎを読まない技術

CC BY 4.0

仕組み: 報告の隣に、機械の数字を並べる

観測点を決めて、作業の終わりに毎回同じ数字を出すだけです。typingtube（YouTube の音楽動画でタイピング練習ができる、個人運営の Web サービス）の開発で私が使っているのは 2 行です。

# handoff_numbers.sh — 報告の隣に並べる数字。AI の自己申告ではなく機械が数える
git diff --stat HEAD | tail -1               # 例: 14 files changed, 512 insertions(+), 40 deletions(-)
grep " runs, " tmp/test_last.log | tail -1   # 例: 13950 runs, ..., 0 failures, 228 skips（第 1 回のログから）

読み方は「報告文と数字の食い違いを探す」だけです。違和感という曖昧な言葉を、具体的な観測点に落としておきます。

• 「小さな修正です」という報告の隣に 14 files changed, 512 insertions——量が合わない
• 「テストは全部通っています」の隣に、前回 13,950 だった runs が 9,000——走っていないものがある（第 1 回で件数の行を削らなかったのは、このための布石です）
• 「ログイン処理を直しました」の隣に、変更ファイルの一覧が 決済ディレクトリまで及んでいる——場所が合わない

大事な条件が一つあります。数字は AI に報告させないこと。報告文の中の「3 ファイル変更しました」は要約の一部なので、同じ偏りを受けます。使うのは、AI の文章を経由せずコマンドが直接出した数字だけです。

数字が合っていれば、私は報告を読まずに引き継ぎます。食い違ったときだけ、そこで初めて diff なりログなりの全文を開きます。どれを開けばいいかは食い違った数字が教えてくれるので、探し回ることもありません。

CC BY 4.0 はここまで

CC BY 4.0

注意: 数は「おかしい」までしか教えない

観測点は異常の存在を教えますが、中身は教えません。runs が減った理由が、テストの整理（正しい）なのかロード漏れ（事故）なのかは、開いて読むまで分かりません。この仕組みの役目は判定ではなく、全文を開くタイミングを人間が決められるようにすることです。それから、観測点は少なく保ってください。数字が 10 行並ぶと今度は数字が読まれなくなります。2〜3 個で始めて、一度も食い違いを拾わなかった観測点は外す。ここでも、増やさないことが機能の証拠です。

検証手順: 食い違いが見えることを確かめる

前提

• 観測点を 2〜3 個決め、作業の終わりに毎回その数字が出るようにしてあること（この回の例は、変更ファイル数・変更行数を出す 1 行と、テストの実行件数を出す 1 行です）
• ⚠️ その数字が、AI の報告ではなく、コマンドが直接出したものであること

所要時間: 10 分

手順

1. AI に、範囲のはっきりした小さな作業を 1 つ頼みます——「<ファイル名> だけを直して」
2. AI が作業している間に、あなたが、その作業と無関係な既存ファイルを 1 つ、1 行だけ変えます。⚠️ これが「報告と実際がずれた状態」の再現です。ずらす側を人の手で作るので、AI に嘘をつかせる必要はありません
3. あなたが、作業の後に、AI の報告と機械が出した数字を並べて見ます

合格条件（すべて満たすこと）

• AI の報告のほうは「1 ファイル直しました」に相当する内容になっている
• 機械の数字のほうは 2 ファイルになっている（2 files changed に当たる行）

合格しなかったとき

• 数字も報告と同じ 1 ファイルだった —— ⚠️ その数字は、機械ではなく AI の文章から来ています。 数字の出どころを、コマンドが直接出すものへ繋ぎ直します

後始末

• 手順 2 であなたが変えた 1 行を戻します

⚠️ この手順が確かめているのは「食い違いが見えること」だけです。数字は異常の存在を教えますが、中身は教えません。開くかどうかを決めるのは、そのあとのあなたです。

CC BY 4.0 はここまで