読み込み中

信頼する:無人実行の検証

レッスン 85 分
読み込み中

信頼する:無人実行の検証

あなたはClaudeにタスクを任せ、すべてのステップを見守ることなく実行させました。今、Claudeは完了したと言っています。その成果物を出荷する前に、自分が監督していなかったものを確認する方法が必要です。その確認こそが、手放しのClaude Codeを安心して頼れるものにしてくれます。

ここでの考え方はシンプルです。実行にどれだけ自由を与えたかに比例して検証するということです。短いセッションでメッセージが流れていくのを見ていたなら、さっと目を通すだけで十分です。しかし、無人で行われた実行や、誰も見ていない状態で継続的インテグレーションで起動したジョブには、本物のチェックが必要です。誰も何が起きたかを見ていないのですから、後から再構築しなければなりません。

こう考えてみてください。見ていなかった分だけ、検証する。

無人実行はautoモードのままにしておく

仕事で無人実行を行う場合は、権限バイパスではなくautoモードのままにしておきましょう。autoモードでは、分類器が依然としてほとんどのアクションを危険性の観点からレビューします。これは維持する価値のある安全網です。

ただし、その安全網が何をして何をしないのかをはっきりさせておく必要があります。分類器はコードが実際に正しいかどうかを判断することは決してありません。危険なアクションにフラグを立てるだけです。したがって、検証の基準は以前とまったく変わりません。その基準は、実行がどれだけ監督されていなかったかに基づいて設定してください。

要約ではなく差分から始める

Claudeが何をしたかの要約から始めてはいけません。差分そのものから始めましょう。

  1. /code-review を実行して変更内容をたどり、問題点にフラグを立てます。
  2. 次に、自分自身の目で git diff を確認します。

落とし穴は、一見完璧に読める整った要約が、実際には予想もしていなかったファイルに手を加えていた、というケースです。要約はそれを教えてくれません。差分が教えてくれます。

ですから、変更内容を読んでください。まず計画の一部だったファイルを読み、次にそれ以外の部分に何かないか探してください。きれいな説明文は、きれいなコードの証明にはなりません。

テストを約束ではなくゲートにする

無人実行における本当のゲートは、テストが通ったかどうか、そしてClaudeが実際にテストを実行したのか、それとも実行したと主張しているだけなのか、という点です。それを信頼任せにしてはいけません。Claudeがスキップできないよう、フックとして組み込みましょう。

これを実現するフックが2つあります。

  • テストを実行し、失敗した場合にターンの終了を拒否するstopフック。
  • 編集のたびにlintと型チェックを行うpost-tool-useフック。

重要なのは終了コードです。exit 2 で終了するフックは、失敗をそのままClaudeに返します。Claudeはその失敗を読み取り、あなたが頼まなくても修正します。さらに良いことに、このチェックは、あなたが依頼することを覚えているかどうかに関わらず、実行のたびに発動します。

冷静な第二の意見を得る

プルリクエストの前に実行するサブエージェントによるコードレビューは、ここでも役立ちます。それを無人実行に向けてみましょう。

新しいセッションまたはサブエージェントを開き、コードがどのように作られたかの記憶を一切持たない状態で、変更されたコードをレビューさせてください。そのアプローチに利害関係がないため、元の実行が自分を納得させてしまった部分を見つけ出します。新鮮な目を持つ第二のレビュアーは、作成者が正当化してしまった部分を見つけ出します。

まとめ

実行が無人であった度合いに見合うだけ、チェックを真剣なものにしましょう。

  • 差分は自分自身で読む。
  • テストをターンをゲートするフックに変える。
  • ヘッドレス実行はJSON結果と終了コードで検証する。
  • 重要なことについては冷静な第二の意見を得る。

そうすれば、「見ていない間にClaudeがやってくれた」はもはや信頼頼みではなくなります。