はじめに
Claude Code のセッションを何本も並べて、共有リポジトリの「受付箱」(dispatch/ フォルダに置いた依頼ファイル)から仕事を拾わせる運用をしています。30 分おきにエージェントを起こし、それぞれが「まだ誰も手を付けていない依頼」を 1 件選んで作業します。
ここで必ず問題になるのが 同じ依頼を 2 本のエージェントが同時に拾うこと です。ロック用のサーバーや DB を立てるほどでもないので、リモートの git ブランチをロック代わりにしました。
# 依頼 job-123 を取る
git push origin HEAD:refs/heads/claim/job-123 # 成功したら自分のもの
# 終わったら外す
git push origin --delete claim/job-123
「ブランチの作成は早い者勝ちだから、push が通ったほうが勝ち」という発想です。ところが、これをそのまま書くと 2 本とも push が成功します。この記事では、実際にはまった落とし穴 2 つと、直したあとの 3 行を紹介します。
落とし穴1: 同じコミットを push すると「Everything up-to-date」で成功する
エージェント A も B も、着手の印として origin/main をそのまま push していました。
# A
git push origin origin/main:refs/heads/claim/job1
# * [new branch] origin/main -> claim/job1
# B(A の直後)
git push origin origin/main:refs/heads/claim/job1
# Everything up-to-date
echo $? # 0
B の push は 拒否されず、終了コード 0 です。リモートのブランチが既に同じコミットを指しているので、git から見ると「更新するものが無い=成功」だからです。「push が失敗したら次の依頼へ」と書いたスクリプトは、B にもそのまま作業を始めさせてしまいます。
--force-with-lease=<ref>:(期待値を空にすると「そのブランチがまだ無いこと」を条件にできる)を足しても同じでした。
git push --force-with-lease=refs/heads/claim/job2: origin origin/main:refs/heads/claim/job2
# Everything up-to-date ← 更新が無いので、条件の確認そのものが走らない
落とし穴2: + を付けると lease の条件が無視される
「拒否されないなら強制で上書きして確かめよう」と + を付けたくなりますが、これは逆効果です。
git push --force-with-lease=refs/heads/claim/job3: origin +$c:refs/heads/claim/job3
# + 73ab1fe...caabbc1 ... -> claim/job3 (forced update)
既にあるブランチを 黙って上書き しました。git push --help にもあるとおり、refspec の先頭の + は --force-with-lease の条件より強く効きます。先に取った A の印が消え、A と B の両方が作業する最悪の状態になります。
直し方: エージェントごとに「自分だけのコミット」を作って、+ なしで push する
原因はどちらも「全員が同じコミットを push している」ことと「強制している」ことです。そこで、印ごとに中身の無いコミットを 1 個作り、メッセージに自分の名前を入れます。git commit-tree を使うと作業ツリーを汚さずに作れます。
slug=job-123
c=$(git commit-tree -p origin/main -m "claim $slug by $AGENT_NAME $(date -Iseconds)" 'origin/main^{tree}')
git push origin "$c:refs/heads/claim/$slug" || { echo "取られていた"; exit 1; }
- 1 本目: ブランチが無いので
[new branch]で成功。 - 2 本目: 自分のコミットは 1 本目のコミットの子孫ではないので non-fast-forward で拒否(終了コード 1)。
手元で確かめた結果です(git 2.43)。
A: * [new branch] 73ab1fe -> claim/job3 rc=0
B: ! [rejected] ... -> claim/job3 (non-fast-forward) rc=1
B(lease あり・+ なし): ! [rejected] ... (stale info) rc=1
リモートの ref の更新はサーバー側で 1 件ずつ原子的に行われるので、同時に push しても勝つのは 1 本だけです。念のため --force-with-lease=refs/heads/claim/$slug: を足しておくと、「無いはずのブランチがあった」ことが stale info という分かりやすい理由で返ってきます(+ は付けない)。
おまけ: 印に情報を持たせる
コミットメッセージに名前と時刻を入れたので、「誰がいつから持っているか」がリモートだけで分かります。
git ls-remote --heads origin 'claim/*' # 取られている依頼の一覧
git log -1 --format='%s' origin/claim/job-123 # 誰がいつ取ったか
時刻が古すぎる印は、エージェントが途中で落ちた跡です。見張り役がこれを見つけて外せば、次の起動で別のエージェントが拾い直せます。
まとめ
| やり方 | 2 本目の push | ロックになるか |
|---|---|---|
全員が origin/main を push |
Everything up-to-date(rc=0) | ならない |
同じコミット+--force-with-lease=ref:
|
Everything up-to-date(rc=0) | ならない |
+ を付けて push |
上書き(forced update) | 先の印を消す |
自分だけのコミットを + なしで push |
rejected(rc=1) | なる |
git の push は「更新が無ければ成功」「+ は条件より強い」という 2 つの性質があり、ロックとして使うときはどちらも裏目に出ます。印ごとに一意なコミットを作るだけで、追加のサーバー無しに複数エージェントの取り合いを防げました。