Claude Code に点検をさせるときの3つの決まり

Claude Code に点検をさせるときの3つの決まり

記事
IT・テクノロジー
AIにコードを点検させて「問題なし」と言われても、どこまで見たのか分からない。そんな困りごとがある人に向けた記事です。点検役のAIに何を許し、何を許さないか。その決まりを3つ、実際の使い方と一緒に紹介します。書いている私は元飲食店員で、IT未経験からPythonを始めました。

下書きにはAIを使い、内容は自分の作業記録と照らして確かめています。数字は記録にあるものだけを使い、記録にない数字は書いていません。

この記事に出てくる開発イベントでは、参加者全員にAI(Claude)の利用枠が提供され、私も受け取りました。イベントの運営や提供元から依頼を受けて書いた記事ではありません。

■ 背景:7日間の開発イベントで、点検の役を分けた

提出期限のある7日間の開発イベントに参加し、自作のWebアプリを作りました。このとき、設計・実装・点検を、Claude Code の中で別の担当として動く役(サブエージェント)に分けました。

点検の役は、悪用する人の目で穴を探す役、規約や自分の決まりに触れないかを確かめる役、読み取り専用の写しでテストを動かす役、出てきた指摘を振り分ける役などです。

効いた決まりは3つです。

■ 決まり1:報告する役には、最初から「書かせない」と決めておく

点検の役には、リポジトリ(コードを置いている場所)へ書き込むことを許しませんでした。

たとえば11月3日に置いた「事前の検死」の役は、「提出に失敗した」と仮定して、原因をさかのぼって挙げる点検です。この役に許したのは、資料を読むことと、読むだけのコマンド(git log や git status など)だけで、書いたのは検死の文書1枚でした。

脆弱性(悪用される弱点)の監査でも、報告の冒頭に「監査のみ。リポジトリのファイルは変更していない」と書かせました。作業の前と後で git status の出力が0行なのも確かめています。

指摘を直す段になっても、本体には書かせませんでした。リポジトリの複製の上で直させ、4本のパッチ(変更の差分をまとめたファイル)として受け取りました。当てたのは、そのうち自分で選んで承認したものだけです。

この決まりが効いたのは、提出前の整合チェック(README・設定・コードが食い違っていないかを確かめる点検)のときです。この役は、push の漏れを見つけました。push は、手元の変更を公開の場所へ送ることです。手元の最新の修正が、まだ公開のリポジトリに送られていなかったのです。それでも、自分では push していません。提案は「本人がスキャンを通してから手動で push する」で止まり、直すべき候補10件は「まだ何も直していない」と書いた表で渡されました。

なぜ書かせないのか。点検する役が直す役を兼ねると、「見つけた」と「直した」の境目が見えなくなるからです。直したつもりが別の場所を壊していても、報告には「直した」としか残りません。読むだけの役にしておけば、報告に書かれたことと、リポジトリで実際に変わったことを分けて追えます。

■ 決まり2:リポジトリに書く担当は、同時に1人にする

書き込みの扱いでは、もう1つ決めたことがあります。

事前の検死の役から、まだコミット(変更を履歴に記録すること)されていないファイルが見えていました。その数分後、別の担当がコミットを入れました。検死の役はこれを見て、ある担当のテストが別の担当の書きかけのファイルを読み込み、誤った PASS/FAIL(合格・不合格)を出すおそれがある、と指摘しました。

手当ては次の3つです。

・リポジトリに書き込む担当は、同時に1人にする
・並べて動かしたいときは、git worktree(同じリポジトリの作業場所を別のフォルダに分ける機能)で分ける
・機能を凍結する(これ以上機能を足さないと決める)ときは、ほかの担当を止め、git status が空なのを確かめてから凍結する

同じ場所を同時に触らせると、誰の結果を信じてよいのか分からなくなります。

■ 決まり3:報告の最後に「保証しないこと」を書かせる

もう1つの決まりは、報告の末尾に「保証しないこと」の節を置かせることです。

事前の検死の報告には、次の4つが並びました。

・審査の結果の予測ではない
・運営の見解ではない
・コードは必要な行だけ読み、アプリもテストも動かしていない
・数字はこの時点の実測である

テストを動かさなかった理由も書いてありました。ほかの担当とぶつかるのを避けたためです。

ほかの役も同じ節を書きました。規約を見る役は、規約の原文は読んでいないことを書きました。サーバーの監査は「未確認」の節を立てました。本物の API(外部サービスと通信するための窓口)を呼ばずに監査したので、投稿に仕込まれた指示に Claude が実際にどう反応するかは確かめていない、という内容です。

この節があると、「問題なし」がどこまでの範囲の話なのかが分かります。読む側は、確かめられていない範囲を自分で確かめるか、未確認のまま進めるかを選べます。

指示文に入れるときは、たとえば次のように書けば足ります。

報告の最後に「保証しないこと」の節を置く。読んだもの・動かしたもの・動かしていないものを分けて書く。数字には、いつ測ったかを添える。確かめられなかったことは「未確認」と書く。

■ まとめ

・点検の役には、リポジトリへ「書かせない」と最初に決める。直すかどうかは人が選ぶ。
・書き込む担当は同時に1人。並行させるなら作業場所を分ける。
・報告の最後に「保証しないこと」を書かせ、「問題なし」の範囲を見えるようにする。

■ 確かめていないこと

・この3つの決まりは、1つのアプリを7日間で作った記録から書いたものです。ほかのプロジェクトでも同じように効くかは確かめていません。
・決まりを入れなかった場合との比較はしていません。効いた、という判断は、報告の中身を読んだうえでの私の見方です。

同じ考え方で、一度直したところが別の作業のあとで元に戻ってしまうことを減らすためのルールを、文章で書く出品をしています。下のサービスをご覧ください。

サービス数100万件のスキルマーケット、あなたにぴったりのサービスを探す