「キャッシュを消してほしい」と頼んだ結果、開発者のドライブの中身が消えてしまったのだと報じられていました。その報告を読んだ夜のことです。私は自分のビルド掃除用のシェルスクリプトを開き直しておりました。
個人開発のアプリでは、ビルドの残骸を消す作業が週に何度も発生します。その中に、変数が空のまま動けば根元のディレクトリを指しうる行が、一つ残っていました。報告の主役はエージェントでしたが、胃のあたりが冷えたのは、自分の古いスクリプトに対してでした。いま思えば、他人の事故を読んでいるつもりで、自分の棚卸しを迫られていたのかもしれません。
最初にお伝えしたいのは、承認を外してよいかどうかより先に、削除がどこまで届くかを機械で狭めておくほうが、はるかに効くということです。ここからは、その関所を Python で一枚作り、11月に意地の悪い条件で叩き直して見つかった穴を塞いだ版までを書き残してまいります。
報じられたことと、私が断定しないこと
2025年12月の初め、複数の技術メディアが、Google Antigravity のエージェントがプロジェクトのキャッシュ削除を頼まれて、Windows の D: ドライブの中身まで消してしまったという利用者の報告を取り上げました。私が確認できたのは、それらの記事の見出しと概要の範囲です。
原因が指示の曖昧さなのか、パスの解決なのか、承認の設定なのかは、公開されている範囲では私には判断がつきません。ですので、ここから先は「あの事例の再現」ではなく、同じ種類の事故を自分の環境で起こさないための手当てとして読んでいただければと思います。
事故の種類は、突き詰めると一つです。削除コマンドの対象が、頼んだ人の想像より広かったのだと思います。
「頼み方」を磨くより、「届く範囲」を先に狭めます
最初のうち、私は指示文のほうを直そうとしておりました。「このプロジェクトの build フォルダだけを」と書き添え、念押しを増やしていったのです。結果は芳しくありませんでした。念押しは、読む側が守ってくれたときにしか効きません。
いまは順番を逆にしています。対象が正しいかどうかを人の注意や文章の丁寧さに預けず、削除を実行する直前の一点で、機械が範囲を検査します。
検査する項目は多くありません。
- 対象が空文字ではないこと(変数が展開されなかった場合を止めます)
- 実体のパスに解決したとき、プロジェクトの内側にあること
- プロジェクトのルートそのものではないこと
- ルートや
/Users/名前のような浅い場所ではないこと - シンボリックリンクを辿らないこと
.gitを含むディレクトリではないこと
どれも、事故のあとに読み返すと当たり前に見える項目です。当たり前だからこそ、毎回人の目に任せると抜けます。
11月の再検証で見つかった、最初の版の四つの穴
10月にこの記事を書いたとき、私は上の六項目を Python に移した関所(以下 v1)を載せ、八通りの対象を渡して全部が期待どおりに止まることを確かめました。11月に読み返したとき、確かめていたのは「私が思いついた悪い対象」だけだったと気づきました。そこで、エージェントが置かれうる状況のほうを変えて、もう一度叩きました。
環境は Ubuntu 22.04・Python 3.10.12 です。偽のホーム me の下に proj(build/cache、入れ子の Git を持つ packages/lib/.git)と、proj の外の outside(5MB のファイル)と Documents を置いています。出力のパスは読みやすいように短く書き換えています。
| 条件 | v1 の結果 | 何がまずいか |
|---|---|---|
シェルの現在地がホームのまま Documents を渡す | 予定: /…/me/Documents (2 bytes)・終了コード 0 | --root の既定が現在地なので、ホームにいればホーム全体が「プロジェクトの内側」になります。現在地が / でも同じく通りました |
packages(中の lib/.git は一段深い) | 予定: /…/proj/packages・終了コード 0 | .git を見ていたのは対象の直下だけでした。入れ子のリポジトリは素通りです |
dist "" を --apply 付きで渡す | dist を消してから空文字で拒否・終了コード 1 | 一件ずつ検査して一件ずつ消していたため、拒否が出た時点で手前の対象はもう消えています |
build(中に外の 5MB を指すリンク) | 予定: /…/proj/build (5,000,002 bytes) | 実際に消えるのはリンク自体だけで、外のファイルは残ります。予定に出る大きさが、人の判断を誤らせます |
いちばん冷や汗をかいたのは一行目です。エージェントのターミナルがどこで開かれているかは、私が毎回見ているわけではありません。関所の範囲を、関所を呼ぶ側の現在地に預けていた——これでは、念押しを指示文に書いていた頃と構造が同じでした。
ほかに、存在しないパスを渡すと拒否の一行ではなく FileNotFoundError のトレースバックが出ることも分かりました。終了コードは 1 なので止まりはしますが、エージェントがその長い出力を「別の問題」と読み違える余地が残ります。
関所 v2(root は必ず明示・全件を検査してから消す)
直したのは五点です。root は --root か環境変数 SAFE_RM_ROOT で必ず明示し、現在地は使いません。root 自体がホームやそれより浅い場所なら拒否します。.git は対象の中をリンクを辿らずに全部見ます。--apply でも、全件の検査が通るまで一件も消しません。大きさはリンク自体の大きさで数えます。加えて、表の線引きに合わせて、同期フォルダ(Dropbox など)の中は --allow-synced を付けない限り拒否するようにしました。
次のスクリプトを safe_rm.py として、プロジェクトの外側(たとえばホーム直下の bin)に置きます。プロジェクトの内側に置かないのが、地味ですが大事な点です。 エージェントが編集できる場所に置くと、関所そのものが書き換わりうるためです。
#!/usr/bin/env python3
"""削除の手前に置く関所 v2。既定は dry-run。--apply のときだけ、全件の検査が通ってから消す。"""
from __future__ import annotations
import argparse
import os
import shutil
import sys
from pathlib import Path
MIN_DEPTH = 3 # /Users/name までは無条件で拒否(root はこれより深いこと)
SYNCED = {"Dropbox", "CloudStorage", "Mobile Documents", "OneDrive", "Google Drive"}
class Refused(Exception):
pass
def load_root(arg: str | None) -> Path:
raw = arg or os.environ.get("SAFE_RM_ROOT", "")
if not raw:
raise Refused("root が未指定です(--root か SAFE_RM_ROOT。cwd は使いません)")
root = Path(raw).expanduser().resolve(strict=True)
if len(root.parts) <= MIN_DEPTH + 1 or root == Path.home():
raise Refused(f"root が浅すぎます: {root}")
return root
def find_git(real: Path) -> Path | None:
if (real / ".git").exists():
return real / ".git"
for d, dirs, files in os.walk(real, followlinks=False):
if ".git" in dirs or ".git" in files:
return Path(d) / ".git"
return None
def size_of(real: Path) -> int:
if not real.is_dir():
return real.lstat().st_size
total = 0
for d, _, files in os.walk(real, followlinks=False):
total += sum(os.lstat(os.path.join(d, f)).st_size for f in files)
return total
def check(target: str, root: Path, allow_synced: bool) -> Path:
if not target.strip():
raise Refused("対象が空です(変数が展開されていない可能性があります)")
p = Path(target).expanduser()
if p.is_symlink():
raise Refused(f"シンボリックリンクは辿りません: {p}")
try:
real = p.resolve(strict=True)
except FileNotFoundError:
raise Refused(f"存在しません: {p}")
if len(real.parts) <= MIN_DEPTH:
raise Refused(f"浅すぎる場所です: {real}")
if real == root or root not in real.parents:
raise Refused(f"root の外、または root そのものです: {real}")
if not allow_synced and SYNCED & set(real.parts):
raise Refused(f"同期フォルダの中です(--allow-synced が必要): {real}")
g = find_git(real) if real.is_dir() else None
if g:
raise Refused(f".git を含むので消しません: {g}")
return real
def main() -> int:
ap = argparse.ArgumentParser()
ap.add_argument("targets", nargs="*")
ap.add_argument("--root")
ap.add_argument("--apply", action="store_true")
ap.add_argument("--allow-synced", action="store_true")
a = ap.parse_args()
try:
root = load_root(a.root)
if not a.targets:
raise Refused("対象がありません")
plan = [check(t, root, a.allow_synced) for t in a.targets] # 先に全件を検査する
except (Refused, FileNotFoundError) as e:
print(f"拒否: {e}", file=sys.stderr)
return 1
for real in plan:
print(f"{'削除' if a.apply else '予定'}: {real} ({size_of(real):,} bytes)")
if a.apply:
for real in plan:
shutil.rmtree(real) if real.is_dir() and not real.is_symlink() else real.unlink()
return 0
if __name__ == "__main__":
sys.exit(main())「なぜこう書くか」を四つだけ添えます。
--applyを付けない限り何も消えないのは、エージェントが最初に打つコマンドを必ず「予定の表示」にするためです。resolve(strict=True)は、..やパスの途中のリンクを実体に解いたうえで root の内側かを判定するためです。文字列の前方一致だと/projと/proj-oldを取り違えます。from __future__ import annotationsは、型注釈のstr | Noneを Python 3.10 より前でも評価させないための一行です。macOS に最初から入っている python3 は版が古いことがあるためで、私は 3.10 でしか実行を確かめていません。- 検査の失敗はすべて
拒否: …の一行と終了コード 1 にそろえています。エージェントにとって読み違えようのない形にしておくためです。
v2 を手元で確かめた結果
同じ偽のホームで、v1 の穴を突いた条件と、10月に確かめた条件の両方を流し直しました。
| 渡したもの | v2 の結果 |
|---|---|
Documents(root 未指定・現在地はホーム) | 拒否: root が未指定です(--root か SAFE_RM_ROOT。cwd は使いません) |
--root にホームそのもの、または /tmp | 拒否: root が浅すぎます |
packages(一段深い lib/.git) | 拒否: .git を含むので消しません: /…/packages/lib/.git |
dist "" を --apply 付きで | 空文字で拒否・dist は残っている |
build(外の 5MB を指すリンクを含む) | 予定: /…/proj/build (68 bytes)。--apply 後も外の 5MB は無傷 |
nothere(存在しない) | 拒否: 存在しません: nothere |
../outside | 拒否: root の外、または root そのものです |
Dropbox/app/build | 拒否: 同期フォルダの中です(--allow-synced が必要)。付ければ予定を表示 |
68 bytes は、本物のファイル 2 bytes と、リンク二本そのものの大きさの合計です。予定の数字が「実際に空く量」に近づいたことで、--apply の前に一覧を読む人の判断が、ようやく正しい材料の上に乗りました。
症状から引く切り分け表
関所を入れたあとに出会いやすい場面を、症状から引けるようにまとめます。
| 症状 | 原因の候補 | 確かめ方 | 直し方 |
|---|---|---|---|
消してよいはずの build が「root の外」で拒否される | 環境変数 SAFE_RM_ROOT に、別のプロジェクトの値が残っている | echo "$SAFE_RM_ROOT" と、拒否の一行に出たパスを見比べる | 呼び出しのたびに --root を明示します。環境変数は、一つのプロジェクトしか触らないセッションだけで使います |
vendor などが「.git を含む」で拒否される | 中にサブモジュールや、Git で直接取ってきた依存がある | 拒否の一行に出る .git のパスを見る | そのフォルダだけを、人が中身を確かめてから手で消します。関所は緩めません |
予定は出るのに、エージェントが --apply を付けて続けてしまう | 承認なしで任せるコマンドに、--apply 付きの形まで含めている | エディタやエージェントの許可設定に、safe_rm.py がどう書かれているかを見る | 許可するのは引数なしの形(dry-run)だけにし、--apply は毎回確認に回します |
| 関所を通したのに、別の場所が消えていた | エージェントが関所を経由せず rm や rmdir を直接打った | ターミナルの履歴とエージェントの実行ログを見る | 直接の削除コマンドを拒否側に入れ、削除は関所経由だけに寄せます |
| 拒否されたのに、エージェントが「成功」と報告する | 終了コードを見ずに、出力の一部だけを読んでいる | 同じコマンドを手で打ち、echo $? を見る | 報告の前に終了コードを確かめる、と指示と手順の両方に書きます |
どこで止めるか——比較と、私の選び方
削除の事故を減らす手段は、関所のほかにもあります。それぞれ拾えるものと拾えないものが違います。
| 手段 | 拾えるもの | 拾えないもの | 向いている場面 |
|---|---|---|---|
rm -i / rm -I(確認つき削除) | 人が打ったときの勢い | エージェントが y を流し込む、または別のコマンドを選ぶ | 人が手で消すとき |
git clean -n(予定だけ表示) | Git 管理下の未追跡ファイルの範囲 | リポジトリの外。予定を見たあと、実行時に -d や -x を足したときの広がり | リポジトリの中だけを掃除するとき |
| エージェント側の許可・拒否の設定 | 決めたコマンドの実行そのもの | 変数展開の結果や、許可したスクリプトの中で起きること | どのコマンドを打たせるかを決めるとき |
| ターミナルのサンドボックス | ワークスペース外への書き込み | ワークスペースの内側での消しすぎ | 使える環境なら常に |
| 削除の関所(この記事) | 空の変数・浅い場所・外へのはみ出し・入れ子の Git・同期フォルダ | 関所を経由しない削除 | 掃除を任せるとき |
私の選び方は一文に収まります。どのコマンドを打たせるかはエージェントの設定で決め、そのコマンドがどこまで届くかは関所で決めます。 設定だけでは中身の広がりが見えず、関所だけでは関所を迂回した削除が見えないので、二つを重ねています。
よくある誤解を三つ
一つ目は、「dry-run を見せていれば安全」という思い込みです。v1 の予定表示は、実際には 2 bytes しか消えないフォルダに 5,000,002 bytes と出していました。予定の一覧は、人が判断する材料です。材料の数字がずれていれば、読む人の注意がどれだけ確かでも判断はずれます。
二つ目は、「resolve() しておけばリンクの心配はない」という思い込みです。resolve が解いてくれるのは、パスの途中のリンクと .. です。対象そのものがリンクのときは、v1 も v2 も is_symlink() で先に拒否しています。また、フォルダの中にあるリンクについては、Python の shutil.rmtree はリンクの先へ降りずにリンク自体を消します——手元でも、外を指すリンクを含む build を消したあと、外の 5MB はそのまま残っていました。
三つ目は、「エージェントはプロジェクトのフォルダで動いているはず」という思い込みです。私自身がこれに寄りかかって v1 を書きました。ターミナルが開かれた場所、途中の cd、別のフォルダを開いたままのセッション——現在地が変わる理由はいくつもあります。だから v2 では、root を現在地から推測すること自体をやめました。
承認を外す作業と、外さない作業
関所があっても、任せる範囲の線引きは別に要ります。私は次のように分けています。
| 作業 | 承認なしで任せる | 理由 |
|---|---|---|
| ビルド成果物の再生成 | 任せる | 消えても同じ手順で戻せるため |
safe_rm.py 経由の削除(dry-run) | 任せる | 予定の表示だけで、何も変わらないため |
safe_rm.py --apply | 目で見てから | 表示された「予定」の一覧を、人が一度読みます |
| プロジェクト外のパスを含む削除 | 任せない | 戻せるかどうかを、人が先に確かめます |
| 同期フォルダ(Dropbox など)配下の削除 | 任せない | 削除が他の端末へ伝わるため |
同期フォルダの行は、私自身の実感から足しました。私は作業のファイルを Dropbox に置いていて、そこで消したものは、手元のバックアップがなければ版履歴に頼ることになります。復元できるとはいえ、夜中にそれを探す作業は、できれば避けたいものです。v2 で同期フォルダを既定で拒否にしたのは、この行を「気をつける」から「機械が止める」へ移すためでした。
関所を通さないときの、もう一つの保険
削除を機械で狭めても、戻せる経路は別に持っておきます。大きな作業の前には、次の二つだけを欠かさないようにしています。
- 作業ディレクトリを Git で一度コミットし、未追跡ファイルも含めて状態を固定します
- プロジェクトの外にあるものは、そもそもエージェントの作業ディレクトリに入れません
承認の設定画面の名称や置き場所は版によって変わりますので、画面の手順はここには書きません。2026年11月時点では、Antigravity の公式ドキュメントに Agent permissions と Terminal sandbox のページがあります。設定を触る日は、そちらを開きながら、いまの版での名前を確かめていただければと思います。
次に詰まる一歩
関所を置いた直後に当たりやすいのは、「では、エージェントに直接打たせないコマンドをどう決めるか」です。拒否側に何を入れるかを自分のシェル履歴から数えて決める手順は、Deny list を自分のシェル履歴から作り始める記事にまとめています。
承認を緩める方向で迷っている方は、「常に続行」でも承認を求められる日の、緩め方の順番が、コマンドの種類ごとの線引きの叩き台になると思います。
夜間など人のいない時間に回す場合は、関所そのものや設定ファイルが書き換わっていないかを外側から確かめる 無人実行のエージェントが設定を書き換えたときの備えも、あわせて読んでいただけましたら幸いです。
まずは一行だけ
今日いちばんにお勧めしたいのは、手元の削除スクリプトや関所を開いて、範囲を決めている値がどこから来ているかを確かめることです。現在地か、環境変数か、引数か。私はそれを確かめただけで、10月の自分の関所に一つ冷や汗をかきました。
頼み方は人が磨き、届く範囲は機械が狭め、その範囲を決める値は人が明示します。 この分担だけは、疲れた日でも崩さないようにしています。