git add -A の巻き込み|AIエージェントのコミット

git add -A の巻き込み|AIエージェントのコミット

AI エージェントに自動でコミットさせていて、関係のないファイルまでコミットに入った、という記録が Zenn に公開されています。

原因は git add -A で、設定を集めるフォルダに置かれていた機密ファイルが拾われ、push の前に気づいて取り消したそうです。

著者は、CLAUDE.md に「使わない」と書くだけでは足りず、add してよい場所をスクリプトの側で名指しする形に変えたと書いています。

参考: Zenn: git add -A が機密ファイルを巻き込んだ

git add -A が機密ファイルを巻き込んだ — 「禁止」と書くより、add する場所を配列で固定した

この話を読んで、git add -A が何を拾うのか、名指しにすれば本当に防げるのかを、手元で確かめました。

検証は Git 2.48.1(Git for Windows)で、空のリポジトリを作って行いました。

巻き込みを防ぐには、add する場所の固定に加えて、コミット直前のステージの中身も確かめる必要があります。

git add -A はリポジトリ全体を拾う

git add -A は、パスを付けずに実行すると、作業ツリー全体を対象にします。

Git の公式ドキュメントにも、パスを省いたときは作業ツリー全体の全ファイルが更新され、古い版の Git はカレントディレクトリより下に限っていた、と書かれています。

参考: Git – git-add Documentation

違いを見るために、notes/ の下で 1 ファイルを書き換え、1 ファイルを新しく作り、リポジトリの直下に stray.pdf を置きました。

その状態で、notes/ の中から add の種類ごとに実行した結果です。

実行したコマンドnotes の変更notes の新規直下の stray.pdf
git add .入る入る入らない
git add -A入る入る入る
git add -u入る入らない入らない
git add — notes入る入る入らない

git add . はカレントディレクトリより下だけを拾いますが、git add -A はサブフォルダの中から打っても直下の stray.pdf まで拾いました。

git add -u は追跡済みのファイルだけが対象なので、新規のファイルは入りません。

git commit -a も同じく追跡済みのファイルだけをコミットし、未追跡の stray.pdf は残りました。

エージェントはカレントディレクトリを移動しながら作業するので、「今いるフォルダの中だけ」のつもりで打った -A が、別の場所のファイルを拾うことがあります。

どれが入るかは、git add -A -n の dry run で実際には add せずに一覧を見られます。

$ git add -A -n
add 'notes/a.md'
add 'notes/new.md'
add 'stray.pdf'

名指しで add しても先にステージ済みの物は入る

Zenn の記事が勧めているのは、add してよい場所を決めて、そこだけを名指しする形です。

私も git add -- notes のようにフォルダを名指しすれば、stray.pdf が入らないことを確かめました。

ただし、名指しが制限するのは「今回 add する物」だけです。

git commit はステージにある物を全部コミットするので、先に誰かが stray.pdf を add していれば、それも一緒に入ります。

実際に、stray.pdf を先に add してから notes を名指しで add し、コミットすると、こうなりました。

$ git add stray.pdf          # 先にステージされていた
$ git add -- notes
$ git commit -m c1
$ git show --stat --format=%s HEAD
c1
 notes/a.md   | 1 +
 notes/new.md | 1 +
 stray.pdf    | 1 +

この穴は Zenn の記事でも、別の AI にレビューさせて見つかった点として書かれていました。

対策は 2 つあります。

1 つ目は、add する前にステージが空かどうかを確かめ、空でなければ止める方法です。

# add の前に、ステージ済みの変更があれば止める
if ! git diff --cached --quiet; then
  echo "ステージ済みの変更があるため中断" >&2
  git diff --cached --name-only >&2
  exit 2
fi
git add -- notes

2 つ目は、コミットのときにもパスを渡す git commit -- <パス> です。

パスを付けたコミットは、ほかのパスにステージされた物を無視して、渡したパスの作業ツリーの今の中身だけをコミットします。

公式ドキュメントでは --only の動きとして説明されていて、パスを渡したときの既定です。

参考: Git – git-commit Documentation

$ git add stray.pdf
$ git add -- notes
$ git commit -m c2 -- notes
$ git show --stat --format=%s HEAD
c2
 notes/a.md   | 1 +
 notes/new.md | 1 +
$ git status --short
A  stray.pdf

stray.pdf はコミットに入らず、ステージに残ったままでした。

残ったステージは次のコミットで入りうるので、1 つ目の確認と組み合わせて使うと漏れが減ります。

入ってしまったときの戻し方

コミットする前なら、git restore --staged <ファイル> でステージから外せます。

ファイルの中身は消えず、未追跡に戻るだけです。

コミットした後でも、push していなければ git reset --soft HEAD~1 でコミットだけを取り消せます。

$ git reset --soft HEAD~1
$ git status --short
M  notes/a.md
A  notes/new.md
A  stray.pdf
$ git restore --staged stray.pdf
$ git status --short
M  notes/a.md
A  notes/new.md
?? stray.pdf

--soft はコミットだけを戻し、変更はステージに残すので、外したいファイルだけを restore --staged で外してからコミットし直せます。

push した後は、履歴を書き換えても、すでに取得された分は取り戻せません。

コミットに入ったのが鍵やトークンなら、その鍵を無効にして発行し直すことが先になります。

鍵をコードやリポジトリに置かない考え方は、別の記事で整理しています。

シークレット管理入門|認証情報をコードに書かないための選択肢

Claude Code のフックで git add -A を止める

CLAUDE.md の指示はモデルへのお願いなので、守られないことがあります。

Claude Code には、ツールを実行する前にスクリプトを挟める PreToolUse フックがあり、スクリプトが終了コード 2 で終わると、そのツールの呼び出しは止まります。

止めた理由には標準エラーの文が使われ、Claude にもその文が伝わります。

参考: Claude Code Docs: Hooks reference

Hooks reference - Claude Code Docs

git add -A・git add --all・git add .・引数の無い git add と、git commit -a を止めるスクリプトを書きました。

# .claude/hooks/block_git_add_all.py(import は省略)
cmd = json.load(sys.stdin).get("tool_input", {}).get("command", "")
for part in re.split(r"&&|\|\||;|\n", cmd):
    w = shlex.split(part)  # 引用符の崩れた部分は飛ばす(略)
    if len(w) < 2 or w[0] != "git":
        continue
    sub, args = w[1], w[2:]
    if sub == "add" and ({"-A", "--all", "."} & set(args) or not args):
        print("git add はファイルかフォルダを名指ししてください", file=sys.stderr)
        sys.exit(2)
    # git commit -a / -am も同じ形で止める(略)
sys.exit(0)

登録は .claude/settings.json の hooks に書きます。

if に Bash(git *) を書くと、git のコマンドのときだけスクリプトが起動します。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "if": "Bash(git *)",
            "command": "python \"${CLAUDE_PROJECT_DIR}/.claude/hooks/block_git_add_all.py\""
          }
        ]
      }
    ]
  }
}

ドキュメントにあるフックの入力の形の JSON を標準入力に渡し、Python 3.12 でスクリプトの終了コードを確かめました。

渡したコマンド終了コード
git add -A2(止める)
git add .2(止める)
cd notes && git add –all2(止める)
git commit -am "wip"2(止める)
git add — notes/a.md0
git commit -m "add notes"0
git -C repo add -A0(すり抜ける)
bash commit.sh0(すり抜ける)

確かめたのはスクリプト単体の判定までで、Claude Code に登録して止まる様子は、このためには動かしていません。

表の下の 2 行のとおり、コマンドの文字列で判定するフックは、git -C で場所を変えた呼び方や、スクリプトの中で打たれる add を見られません。

git -C は判定に足せますが、スクリプトの中身まではフックから見えないので、次の網が要ります。

フックの終了コードの扱いには、exit 1 では止まらないという落とし穴もあります。

Claude Codeのhookはexit 1では止まらない

最後の網は Git の pre-commit

どの経路で add されても、コミットは必ず Git を通ります。

そこで、Git の pre-commit フックで、ステージにある物が許した場所の中だけかを確かめました。

pre-commit は git commit のたびに呼ばれ、0 以外で終わるとコミットは作られません。

参考: Git – githooks Documentation

#!/bin/sh
# .git/hooks/pre-commit: コミットしてよい場所の外がステージにあれば止める
bad=$(git diff --cached --name-only | grep -v -E '^(notes/|README\.md$)')
if [ -n "$bad" ]; then
  echo "pre-commit: 許可した場所の外がステージにあります:" >&2
  echo "$bad" >&2
  exit 1
fi

stray.pdf をステージに入れたままコミットすると、止まりました。

$ git add stray.pdf notes/a.md
$ git commit -m c4
pre-commit: 許可した場所の外がステージにあります:
stray.pdf
$ echo $?
1

stray.pdf をステージから外してコミットし直すと、notes/a.md だけが入りました。

ただし pre-commit は git commit --no-verify で飛ばせて、実際に stray.pdf がコミットに入りました。

.git/hooks/ の中身はリポジトリと一緒に配られないので、クローンし直した環境では入れ直しが要ります。

自動でコミットする仕組みでは、コミットのコマンドに --no-verify を付けないことも、決まりとして書いておく必要があります。

最後に

git add -A はサブフォルダの中から打ってもリポジトリ全体を拾い、名指しで add しても、先にステージ済みの物はコミットに入りました。

止める場所は、add する場所の固定、コミット直前のステージの確認、Claude Code のフック、Git の pre-commit の 4 つで、どれも単独ではすり抜けがあります。

指示で頼む場所と、仕組みで止める場所を重ねておくと、どれか 1 つが漏れても次で止まります。

以上です。

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

CAPTCHA