◉ANTIGRAVITY LABEN
記事一覧/AIツール
⚙ AIツール/2026-10-06中級

キャッシュを消すだけのはずが、ドライブごと消えた報告を読んで。削除だけは関所を通すことにしました

キャッシュ削除がドライブごと消えた報告を読んで作った、削除の範囲を機械で狭める Python の関所。11月の再検証で見つかった4つの穴(現在地に依存する root・入れ子の .git・途中まで消える --apply・リンク先を足す予定表示)を塞いだ v2 と実行結果、症状からの切り分け表、承認を外す作業の線引きをまとめます。

Antigravity419安全設計削除コマンドPython27承認設定

「キャッシュを消してほしい」と頼んだ結果、開発者のドライブの中身が消えてしまったのだと報じられていました。その報告を読んだ夜のことです。私は自分のビルド掃除用のシェルスクリプトを開き直しておりました。

個人開発のアプリでは、ビルドの残骸を消す作業が週に何度も発生します。その中に、変数が空のまま動けば根元のディレクトリを指しうる行が、一つ残っていました。報告の主役はエージェントでしたが、胃のあたりが冷えたのは、自分の古いスクリプトに対してでした。いま思えば、他人の事故を読んでいるつもりで、自分の棚卸しを迫られていたのかもしれません。

最初にお伝えしたいのは、承認を外してよいかどうかより先に、削除がどこまで届くかを機械で狭めておくほうが、はるかに効くということです。ここからは、その関所を 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 で同期フォルダを既定で拒否にしたのは、この行を「気をつける」から「機械が止める」へ移すためでした。

関所を通さないときの、もう一つの保険

削除を機械で狭めても、戻せる経路は別に持っておきます。大きな作業の前には、次の二つだけを欠かさないようにしています。

  1. 作業ディレクトリを Git で一度コミットし、未追跡ファイルも含めて状態を固定します
  2. プロジェクトの外にあるものは、そもそもエージェントの作業ディレクトリに入れません

承認の設定画面の名称や置き場所は版によって変わりますので、画面の手順はここには書きません。2026年11月時点では、Antigravity の公式ドキュメントに Agent permissions と Terminal sandbox のページがあります。設定を触る日は、そちらを開きながら、いまの版での名前を確かめていただければと思います。

次に詰まる一歩

関所を置いた直後に当たりやすいのは、「では、エージェントに直接打たせないコマンドをどう決めるか」です。拒否側に何を入れるかを自分のシェル履歴から数えて決める手順は、Deny list を自分のシェル履歴から作り始める記事にまとめています。

承認を緩める方向で迷っている方は、「常に続行」でも承認を求められる日の、緩め方の順番が、コマンドの種類ごとの線引きの叩き台になると思います。

夜間など人のいない時間に回す場合は、関所そのものや設定ファイルが書き換わっていないかを外側から確かめる 無人実行のエージェントが設定を書き換えたときの備えも、あわせて読んでいただけましたら幸いです。

まずは一行だけ

今日いちばんにお勧めしたいのは、手元の削除スクリプトや関所を開いて、範囲を決めている値がどこから来ているかを確かめることです。現在地か、環境変数か、引数か。私はそれを確かめただけで、10月の自分の関所に一つ冷や汗をかきました。

頼み方は人が磨き、届く範囲は機械が狭め、その範囲を決める値は人が明示します。 この分担だけは、疲れた日でも崩さないようにしています。

シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

⚙ AIツール2026-11-18
手元の Mac を重くせずにローカル LLM を試す — SSH 先の Linux に Ollama を置き、Antigravity から使うまでの最初の30分
Antigravity App v2.33.0 で入った SSH 接続を使い、別の Linux マシンに Ollama を置いて、エージェントにそのホスト上で動く確認スクリプトを書かせるまでの最初の30分です。ポートを外へ開けずに済む理由と、どこで何が動いているかの見分け方を書き残します。
⚙ AIツール2026-11-02
任意ファイルを 20MB まで渡せるようになった日に、エージェントへ渡すものと渡さないものを線引きしました
Antigravity アプリ v2.28.0 で任意ファイルを 20MB まで添付できるようになりました。渡してよいもの・渡す前に加工するもの・渡さないものを3つの問いで線引きします。
⚙ AIツール2026-10-24
「エラーが発生しました」としか出ないとき、まず疑う 429 と確かめる順番
Antigravity が原因の書かれていない汎用エラーで止まったとき、利用上限(HTTP 429)なのか、ネットワークや認証なのかを切り分ける手順です。デバッグ情報を開く、時間を置いて再開する、やってはいけない連打まで、非エンジニアの方にも辿れる順番でまとめました。