
AIエージェントのrm -rf誤削除を防ぐ方法|macOS標準trashと事前mkdir禁止ルール
Claude Code、Cursor、Antigravity などのAIコーディングエージェントには、ファイルを読み書きする専用ツール(read_file や write_file)が備わっている一方で、ファイルを削除する専用ツール(delete_file)が標準搭載されていません。この結果、AIは不要ファイルの整理時に汎用シェルへ逃げて rm -rf を乱発し、未コミットの作業資産を1ターンで永久消失させたり、1ファイルずつ小刻みに rm や事前 mkdir -p を叩いて推論ターンを浪費したりします。本稿では、Git管理下での git rm と macOS 15 Sequoia 以降で標準搭載された純正 /usr/bin/trash のバッチ統合、事前 mkdir の全面禁止、そして PreToolUse フックで代替コマンドへ即座に誘導する二段防衛アーキテクチャを実機検証とともに公開します。
-
バイブコーディングはなぜPythonで失敗しRustとSwiftで成功するのか|循環検証の死角と対策 : AI任せのバイブコーディングがPythonやJavaScriptだと実行時エラーのモグラ叩きで破綻し、RustやSwiftなら厳格なコンパイラ検品で14本のネイティブアプリが育つ理由と、循環検証の死角を破る別セッション監査・UI憲法を解説します。
-
MomongaCodeとは?Z3・TLA+形式検証とChatGPT検証150件で防ぐAI開発の死角 : AI任せの開発が15分の試遊で破綻し、GPT-6 Lunaの150件検証でもパーサーをすり抜ける実行時バグが残る原因を解明。Z3と36本のTLA+仕様を備えたOSS「MomongaCode」や6項目の判断ログ、Signal画面監視対策まで解説します。
-
Rust製CLIの起動ラッパーが遅い原因|シェルfork税撤廃とSQLiteゼロコピーで5ms化した実証録 : 「人間の1msはAIにとって永遠(360万クロック)」という視点からPure Rust実行経路をナノ秒計測。本体3.6msの3倍を奪っていたbashサブシェルfork税の…
-
AIエージェントのシェル手癖を禁止してPure Rust専用CLIで7倍高速化した実測録 :AIが無意識に連発する
cat・grep・ls・findなどの旧世代シェル手癖を封じ、SQLite FTS5 と Pure Rust 製ゲートキーパーへ統合してトークン消費と実行時間を劇的に圧縮した先行検証記事です。 -
PaShシェル自動並列化コンパイラの実力とAIエージェント環境での適材適所 :Linux Foundation 傘下のシェル並列化コンパイラ「PaSh」が生きるバッチ処理の領域と、AIエージェントの単発コマンド往復における本当の最大の障壁(ボトルネック)を切り分けた姉妹編です。
-
OpenAIがLinuxカーネルで948件の特権昇格を発見した衝撃とClaudeフック×Rust検問の実装 :AIエージェントの自律実行権限をどの境界で縛るべきか、OSカーネル層の脆弱性事例と
PreToolUseフックによる4ミリ秒検問の設計思想を深掘りしています。
-
Claude Code、Cursor、Windsurf、Antigravity 等のAIエージェントにファイル整理やリファクタリングを任せており、
rm -rfによる誤削除事故を根絶したい開発者の方 -
AIがファイルを1個ずつ
rmしたり、ファイル作成前に毎回mkdir -pを単独実行したりして、推論ターンの往復待ちやAPIクォータの浪費に悩んでいる方 -
macOS 15 Sequoia 以降の現行 macOS 環境で、追加パッケージに頼らず OS 標準の
/usr/bin/trashとPreToolUseフックを組み合わせた安全な削除体制を構築したい方

AIエージェントに「古い一時ファイルと不要になった画像フォルダを整理して」と頼んだら、いきなりターミナルで rm -rf を走らせてヒヤッとしたことはないかい? しかも1ファイルずつ rm を5回も6回も連打して、そのたびに推論が止まるのも地味にストレスなんだよね。

あります! 読むときは read_file、書くときは write_file という専用ツールを律儀に使うのに、なぜか消すときだけ急にワイルドなシェルコマンド rm -rf に豹変するんですよね。間違ってコミット前の原稿や設定ファイルを消されたらと思うと怖くて目が離せません。

そこにはAIエージェント特有の「ツール設計上の空白」があるんだ。今回はなぜAIが削除でシェルに逃げるのかという構造的な理由から、macOS標準の /usr/bin/trash と git rm を使った100%復元可能な3段階ガード、そして無駄な事前 mkdir を封印する実践ルールまで一気に解説していくよ。
なぜAIエージェントに専用削除ツールがないのか
AIコーディングエージェントを日常的に使っていると、ある非対称な設計に気づきます。ファイルの閲覧・検索・新規作成・部分編集には、それぞれ厳密にスキーマ定義された専用ツール(Built-in Tools)が用意されているにもかかわらず、「ファイルやディレクトリを削除する専用ツール」だけが意図的に外されている のです。
不可逆な破壊操作の責任境界とシェルへの逃避
主要なAIエージェントの標準ツール群を並べてみると、CRUD(作成・読み取り・更新・削除)のうち「削除(Delete)」だけがぽっかりと空いています。
| 操作区分 | 標準搭載されている専用ツール例 | 失敗時の復元性と安全機構 |
|---|---|---|
| 探す(Search) | find_by_name / list_dir / grep_search |
読み取り専用のため副作用ゼロ |
| 読む(Read) | read_file / view_file |
読み取り専用のため副作用ゼロ |
| 作る(Create) | write_file(親ディレクトリ自動生成内蔵) |
既存ファイル上書き時は Overwrite フラグで保護 |
| 直す(Update) | edit_file / replace_file_content |
変更前後の差分(Diff)がUIに明示され即座にアンドゥ可能 |
| 消す(Delete) | 専用ツールなし(不在) | 汎用シェル(run_command / Bash)へ丸投げ |
なぜプラットフォーム開発元は delete_file ツールを標準搭載しないのでしょうか。最大の理由は、OSレベルでのファイル削除(POSIX の unlink(2) や rmdir(2) システムコール)が 「実行した瞬間にファイルシステムの inode 参照を切り離し、エディタのUndo履歴からも消滅する不可逆な破壊操作」 だからです(推論)。
edit_file でコードを書き間違えても、IDEの差分ビューで「拒否(Reject)」を押すか git checkout を叩けば1秒で元に戻ります。しかし、もしAIがハルシネーション(幻覚)を起こして未追跡(Untracked)の秘密鍵や書きかけの原稿、あるいは数百MBの画像素材ディレクトリに対して delete_file(recursive: true) を呼び出してしまえば、データの救出は不可能です。そのため、多くのエージェント設計では「削除だけは専用ツールとして手軽に触らせず、人間の承認ゲートが挟まる汎用シェル実行へ委ねる」という責任境界が引かれています(推論)。
ところが、この設計が現場では裏目に出ます。専用削除ツールを持たないAIは、ファイルを消す必要が生じた瞬間に汎用シェルへと逃げ込み、学習データの中で最も出現頻度の高い削除コマンド――すなわち GNU Coreutils Manual『rm invocation』 で定義されている rm -rf(確認なし・再帰的・強制削除) を躊躇なく引き金にかけてしまうのです。
AIが引き起こすrmコマンド3大事故パターン
当ラボの運用ログ(SQLite 監査台帳および会話履歴)を分析すると、AIエージェントがシェルで rm を実行する際に引き起こすトラブルは次の3パターンに集約されます。
-
変数未展開・スペース混じりパス・ワイルドカード誤爆による巻き添え消去 :AIがワンライナーで
rm -rf $TARGET_DIR/*やrm -rf build/ temp/のようなコマンドを組み立てた際、各ターンが独立したサブシェルで実行される環境では環境変数$TARGET_DIRが空文字になりやすく、意図しない階層をごっそり吹き飛ばす危険があります。 -
Git未追跡(Untracked)の一次素材・下書き・ローカルDBの永久消失 :Gitでコミット済みのソースコードであれば誤って
rmされてもgit restoreで復旧できますが、まだコミットしていない撮影写真、生成直後のWebP画像、.gitignore対象のローカル検証データ(_local_db/や一時バンドル)は、rm -rfされた瞬間に1バイトも残らず消滅します。 -
1ファイルずつの小刻み
rm連打による推論ターンと時間の浪費 :古い画像を10枚整理する場面で、AIが1ターンに1回ずつrm img1.png→ 思考 →rm img2.png→ 思考……と小刻みにシェルを呼び出す手癖です。コマンド自体の実行は数ミリ秒でも、毎ターン全会話コンテキストを再送信するLLMの推論往復(1回あたり数秒〜十数秒)が10回重なり、人間を1分以上待たせる最大の障壁(ボトルネック)となります。

3番目の「1ファイルずつ小刻みに消す手癖」、めちゃくちゃ心当たりがあります! 「まとめて1回で消してよ!」と画面の前で叫びたくなるやつですね。しかも勢い余って rm -rf で大事なものまで消されたら目も当てられません。

そうなんだ。だからこそ「消すな」と精神論で縛るのではなく、「どのコマンドを使って、どういう単位で消せば100%安全かつ最速なのか」 を決定論的なアルゴリズムとしてAIに与えてあげる必要があるんだよ。
macOS純正trashとgitによる3段階削除ガード
rm -rf の恐怖から完全に解放されつつ、ファイル整理の速度を最大化する答えはシンプルです。対象ファイルが「Git管理下にあるか」「ローカルの未追跡ファイルか」によって、Git公式ドキュメント『git-rm』 と、Apple Support『Macでファイルやフォルダを削除する』 の仕組みに直結した macOS 標準 /usr/bin/trash を3段階で使い分け、かつ必ず1回のコマンドにバッチ統合する ことです。
削除の意思決定ツリーとバッチ統合の鉄則
当ラボの共通原則(GEMINI.md)では、AIエージェントがファイルを削除・退避する際の判断フローを以下の3段階に完全固定しています。
リポジトリで追跡されているコードや記事の削除は git rm file1 file2 を使用します。ワーキングツリーとインデックスから同時に削除され、万が一の誤削除時も git reset と git checkout で100%確実に復元できます。さらに、まだ未コミットの変更が残っているファイルは Git 側が安全装置を働かせて削除を拒否してくれます。
コミット前の下書き、不要になった生成画像、ビルドキャッシュ、一時ディレクトリの削除は rm -rf を全面禁止とし、macOS純正の /usr/bin/trash path1 path2 ... で1回のコマンドにまとめてゴミ箱へ移動させます。小刻みな複数回実行は厳禁です。
記事執筆で使わなかった実機写真(10枚〜数十枚)の退避は、シェルで直接消すのではなく、Pure Rust製ゲートキーパーの media-scan --archive-to サブコマンドへ渡し、メタデータ検算と同時にアーカイブ領域へ安全に移動させます。
unlink して復元不能になる経路」がワークスペース上から 一切 なくなります。
macOS標準trashコマンドの実機仕様と高速性
「Macのターミナルからゴミ箱へ移動させるには、Homebrew でサードパーティ製の trash Formula や Node.js の trash-cli をインストールしなければならない」と思い込んでいる方が少なくありません。しかし、macOS 15 Sequoia 以降の現行 macOS 環境では、Apple 純正の /usr/bin/trash バイナリが最初から OS 標準でプリインストールされています。
実機のターミナルで /usr/bin/trash -h を実行した一次仕様を確認してみましょう。
$ which -a trash
/usr/bin/trash
$ /usr/bin/trash -h
usage: trash [-ulesv] <file> [<file> ...]
Move files/folders to the trash.
Options:
-h --help Show help.
-v --verbose Be verbose (show files as they are trashed).
-s --stopOnError Stop with an error if any move to the trash fails.
注目すべき技術的メリットは3つあります。
-
追加インストール不要でフルパス固定呼び出しが可能 :Homebrew の PATH(
/opt/homebrew/bin)が通っていないサンドボックス環境や非対話型サブシェルでも、/usr/bin/trashとフルパス指定するだけで100%確実に動作します。 -
ディレクトリもファイルも区別なく複数引数で一括処理(
-r不要) :rmのようにディレクトリだからといって危険な-rや-rfフラグを付ける必要がありません。/usr/bin/trash -v fileA.txt dirB/ imgC.webpのように、複数ファイルとフォルダをスペース区切りで並べるだけで1ターンで一括移動でき、-vを添えれば処理対象が明快にログへ残ります。 -
外付けSSDやRAMDiskでもボリューム内
.Trashes/<UID>へ瞬間移動(コピー負荷ゼロ) :ここが30年古参技術者として最も強調したい急所です。外付けSSDや APFS RAMDisk(/Volumes/RAMDisk/$USER等)にある大容量ファイルを/usr/bin/trashに渡したとき、起動ディスクの~/.Trashへバス越しにデータをコピーするわけではありません。macOS のファイルシステム機構により、そのボリューム自身のルート直下にある隠しフォルダ.Trashes/<UID>/へと同一ボリューム内のrename(ポインタ付け替え)で移動する ため、数GBのデータでもディスクI/O待ちゼロ(数ミリ秒)で完了し、Finder のゴミ箱から「元の場所に戻す(Put Back)」で元のフルパスへ正確に復元できます。
rmと純正trashとgit削除の徹底比較表
/bin/rm -rf、macOS純正 /usr/bin/trash、そして git rm の挙動とAIエージェント適性を一覧で比較します。
| 評価項目 | /bin/rm -rf(従来手癖) |
/usr/bin/trash(macOS純正) |
git rm(Git管理ファイル用) |
|---|---|---|---|
| 削除の内部メカニズム | unlink(2) / rmdir(2) で即座に inode 解放 |
同一ボリューム内の .Trash / .Trashes/<UID> へ移動 |
作業ツリー削除+Gitインデックスへ削除記録 |
| 誤削除時の復元性 | 復元不能(0%) | Finderの「元の場所に戻す」で100%復元可能 | git restore / git checkout で100%復元可能 |
| 未保存差分の保護 | 警告なしで強制消去 | ゴミ箱内にそのまま完全保持 | 未コミット差分がある場合はエラーで停止し保護 |
| ディレクトリ削除時の引数 | -r / -rf が必須(暴走の温床) |
オプション不要でそのままフォルダ移動可能 | -r が必要だがGit追跡対象のみに限定 |
| AIエージェント運用判定 | 原則全面禁止(PreToolUseで遮断) | 未追跡ファイル・フォルダ削除の第一選択 | Git追跡済みファイル整理の第一選択 |
PreToolUseフックと代替案内による二段防衛
どれほど優れた削除ルールを策定しても、GEMINI.md や CLAUDE.md にテキストで「rm -rf を使うな」と書くだけでは、長文セッションの後半でAIが手癖に引きずられて禁を破ることがあります。そこで不可欠になるのが、ツール実行直前に割り込む PreToolUse フックによる機械的検問と、代替コマンドへの即時ナビゲーション です。
ルール記述だけでは止まらない手癖回帰の壁
LLM(大規模言語モデル)は、事前学習の過程で世界中のGitHubリポジトリやStack Overflow、Linuxチュートリアルに含まれる何億回もの rm -rf と mkdir -p を浴びるように学習しています。そのため、コンテキストウィンドウが膨らんでシステムプロンプトへの注意力(Attention)が薄れてくると、無意識のうちに「一番確率の高いトークン列=rm -rf」を出力してしまう現象(手癖回帰)が必ず発生します。
このとき、フック側で単に exit 2(実行拒否)だけを返して「コマンドが禁止されています」と突き放すと、AIは「なぜ拒否されたのか? パーミッションの問題か? パスが違うのか?」と混乱し、引数を変えて何度も rm をリトライする無限ループに陥りがちです。
代替コマンドを即座に教える検問フックスクリプト
AIを1ターンも迷わせずに正しい行動へ誘導するコツは、PreToolUse フックのエラーメッセージ(標準エラー出力)の中に「今あなたが叩こうとしたコマンドは何故ブロックされ、次のターンで代わりにどのコマンドを叩くべきか」を具体的な構文で差し戻すこと です。
以下は、Claude Code や Antigravity のコマンド検問フックに組み込める、軽量かつ実践的なガードロジック(シェルスクリプト構成例)です。
#!/usr/bin/env bash
# PreToolUse フック: 危険な rm -rf と無駄な単独 mkdir を検問し代替手段へ即時誘導する
set -euo pipefail
# 標準入力からツール呼び出しJSONを受け取り、実行コマンド文字列を抽出
INPUT_JSON="$(cat)"
CMD="$(printf '%s' "$INPUT_JSON" | jq -r '.tool_input.command // .tool_input.CommandLine // empty')"
if [[ -z "$CMD" ]]; then
exit 0
fi
# 1. rm -rf / rm -fr のブロックと /usr/bin/trash・git rm への誘導
if printf '%s' "$CMD" | grep -qE '(^|[;&|[:space:]])(/bin/)?rm[[:space:]]+(-[a-zA-Z]*r[a-zA-Z]*f|-[a-zA-Z]*f[a-zA-Z]*r|--recursive)'; then
cat >&2 <<'EOF'
🚫 [SECURITY GATE] `rm -rf` による不可逆な強制削除はブロックされました。
代わりに以下の100%復元可能なコマンドを1回にまとめて実行してください:
- 未追跡ファイル・フォルダの削除: `/usr/bin/trash -v <path1> <path2> ...`
- Git管理下ファイルの削除: `git rm <path1> <path2> ...`
EOF
exit 2
fi
# 2. 単独 mkdir / mkdir -p のブロックと write_file 直実行への誘導
if printf '%s' "$CMD" | grep -qE '^[[:space:]]*(/bin/)?mkdir([[:space:]]+-p)?[[:space:]]+[^;&|]+$'; then
cat >&2 <<'EOF'
🚫 [EFFICIENCY GATE] ファイル作成前の単独 `mkdir` は不要なためブロックされました。
専用ツール `write_file`(または画像変換CLIの `--out-dir`)は親ディレクトリを自動生成します。
`mkdir` を叩かず、直接 `write_file` を呼び出してください(1ターン節約になります)。
EOF
exit 2
fi
exit 0
このように「禁止理由」と「代替コマンドの完全な構文」をセットで返すと、AIエージェントは次のターンで迷うことなく /usr/bin/trash -v ... や write_file へと切り替え、人間の介入なしで安全にタスクを完遂します。詳しいフック基盤のPure Rust実装については、OpenAIがLinuxカーネルで948件の特権昇格を発見した衝撃とClaudeフック×Rust検問の実装 でも解説しています。

なるほど! ただ「ダメ!」と怒るのではなく、「rm -rf はブロックしたから /usr/bin/trash -v を使ってね」とエラーメッセージで道案内してあげるんですね。これならAIも迷わず一発で正しいコマンドに直せます!

その通り! そして上のスクリプトの後半にちらっと出てきた「単独 mkdir -p のブロック」、実はこれもAIエージェントの速度とトークン効率を劇的に改善するもう一つの急所なんだ。
親自動生成を無視する事前mkdirの謎と全面禁止
新規記事や新しいコンポーネントを作成する際、AIエージェントの行動ログを観察していると、ほぼ毎回のように write_file を呼ぶ直前のターンで、わざわざシェルを起動して mkdir -p src/content/blog/review/new-post/images だけを単独実行する という奇妙な手癖に遭遇します。
なぜAIは不要なmkdirを単独で叩くのか
現代のAIエージェントに搭載されているファイル作成ツール(Antigravity の write_file や Claude Code の Write 等)は、仕様として 「指定されたパスの親ディレクトリが存在しない場合、内部で自動的に再帰作成(fs::create_dir_all / mkdir -p 相当)してからファイルを書き込む」 ように作られています。当ラボの専用画像変換CLI(run_gemini_gate.sh convert-image --out-dir)も同様に親フォルダを自動生成します。
つまり、ファイルを書き込む前の mkdir -p は技術的に 一切不要な空振り操作 です。それなのになぜAIは律儀に mkdir -p を叩いてしまうのでしょうか。
-
人間向け技術チュートリアルの強い学習バイアス(推論) :世の中のあらゆるプログラミング入門書やREADMEが「ステップ1:
mkdir my-appでフォルダを作る」「ステップ2:その中にファイルを作る」という順序で書かれているため、LLMが「新しいパスにファイルを書く前には必ずmkdirを先行させなければならない」という強い条件反射を持っているためです。 -
POSIX低水準APIの失敗パターンへの過剰防衛(推論) :標準ライブラリの単純な
open()やecho "text" > dir/file.txtは親ディレクトリがないとNo such file or directoryで失敗するため、AIが専用ツールwrite_fileの仕様(親自動生成あり)を忘れてシェル時代の防衛行動を取ってしまうのです。
たった1回の mkdir -p でも、AIエージェントにとっては「ツール呼び出し1ターン分のコンテキスト再送(数万〜十数万トークン)+サンドボックスプロセス起動+推論往復の数秒」という確実なコストになります。事前 mkdir を全面禁止するだけで、新規ファイル作成タスクの初動が常に1ターン短縮されます。
シェル4大操作の完全制圧マトリクスと物理保護
先行記事の AIエージェントのシェル手癖を禁止してPure Rust専用CLIで7倍高速化した実測録 で確立した「読む(cat 禁止)」「探す(ls/find/grep 禁止)」に、今回の「作る(事前 mkdir 禁止)」「消す(rm -rf・小刻み rm 禁止)」を加えることで、AIエージェントのファイルシステム4大操作すべてから旧世代のシェル手癖を追放できます。
-
ファイル作成前に毎回
mkdir -p:write_fileが親フォルダを自動生成するのに、単独でシェルを呼び出して1ターンと数万トークンを浪費。 -
小刻みな
rm連打 :不要ファイルを1個ずつ別ターンで削除し、推論往復待ちが何倍にも膨張。 -
rm -rfの暴走リスク :ディレクトリ削除時にいきなりunlink系の強制削除を走らせ、未コミットの原稿や画像素材を永久消失。
-
事前
mkdir全面禁止 :親ディレクトリが存在しなくても直接write_fileや--out-dir付きCLIを呼び出し、初動1ターンを確実に削減。 -
1回へのバッチ統合 :複数ファイルの削除・移動は必ず1回のコマンド引数に統合して推論往復を最小化。
-
git rm×/usr/bin/trash二段ガード :追跡済みは Git インデックス保護、未追跡はボリューム内ゴミ箱へ瞬間移動し、復元率100%を担保。
さらに、ソフトウェア層のガード(git rm・/usr/bin/trash・PreToolUse フック)に加えて、ローカル開発環境の強靱性(レジリエンス)を完璧にするなら、物理的な外付け高速SSDへの Time Machine 自動バックアップと重要アーカイブ退避 を併用するのが鉄則です。当ラボでは Mac 親和性の高い小型NVMeポータブルSSDを接続し、論理ガードと物理バックアップの二重防壁を敷いています。
そのまま使えるルール定義とAI自己監査プロンプト
最後に、読者の皆さまがご自身の GEMINI.md、CLAUDE.md、.cursorrules 等へそのまま組み込めるルール定義文と、AIエージェント自身に現在の環境を自己点検させるためのコピペ用プロンプトを公開します。
エージェント設定ファイルへのコピペ用ルール
以下のブロックをプロジェクトルートの指示書(GEMINI.md や CLAUDE.md)に追記するだけで、作成・削除まわりのシェル乱用を明文化して抑止できます。
## ファイル作成・削除の安全統制ルール(事前mkdir禁止・rm -rf禁止)
- **事前 `mkdir` の全面禁止**: `write_file` 等のファイル作成ツールは親ディレクトリを自動生成するため、ファイル作成前に単独で `mkdir` / `mkdir -p` を実行することを禁じる(直接 `write_file` を呼び出すこと)。
- **小刻み `rm` と `rm -rf` 乱用の禁止**:
1. 複数ファイルを削除・整理する際は、1ファイルずつ小刻みにコマンドを分けず必ず1回の呼び出しに統合すること。
2. Git管理下の追跡済みファイルの削除は `git rm <file...>` を使用すること。
3. 未追跡ファイルやディレクトリの削除は `rm -rf` を禁じ、macOS標準の `/usr/bin/trash -v <path...>` を優先してゴミ箱から100%復元可能な状態を保つこと。
最上位モデル用2段階監査・導入プロンプト
既存のプロジェクトにこの安全機構を導入する際は、いきなり設定ファイルを書き換えさせるのではなく、最上位の推論・コーディングモデル(Gemini 4 Carbon / Gemini 4 Argon、または Claude 4.6 Opus 等)を指定し、「フェーズ1:現状の危険な削除経路とフックの調査」→「フェーズ2:合意後の実装」の2段階 で進めさせるのが最も安全です。
【推奨モデル】:Gemini 4 Carbon (High) / Gemini 4 Argon (High) などの最上位推論モデル
あなたは熟練したシニアシステムエンジニア兼AIセキュリティアーキテクトです。
以下の参考記事の設計思想に基づき、このプロジェクトにおけるAIエージェントの「危険な rm -rf 実行」と「無駄な事前 mkdir・小刻み rm によるターン浪費」を防止する安全機構を導入したいと考えています。
参考URL: https://lab.chihouzakki.com/blog/review/ai-agent-rm-rf-guard-macos-trash-mkdir-ban-guide/
【重要:いきなりファイルを書き換えず、必ず以下の2段階で進めてください】
■ フェーズ1:現状環境の事前調査と導入計画の提示(まずはここまでを実行して停止してください)
1. 現在のOS環境で `/usr/bin/trash` が利用可能か(`which -a trash` 等)、および Git リポジトリの構成を確認してください。
2. プロジェクト内のエージェント指示書(`GEMINI.md`、`CLAUDE.md`、`.cursorrules` 等)と、既存のフックスクリプト(`.claude/settings.json` や `PreToolUse` フック等)の有無・内容を調査してください。
3. 既存の設定やワークフローを一切壊さずに「①事前 `mkdir` 禁止」「②小刻み `rm` 禁止(1回への統合)」「③ `rm -rf` 禁止と `git rm` / `/usr/bin/trash` への誘導(ルール追記+PreToolUseフック検問)」を組み込むための具体的な変更差分案を提示し、私の承認を待ってください。
■ フェーズ2:承認後の実装と動作検証
私がフェーズ1の計画を承認したら、指示書およびフックスクリプトを更新し、テスト用のダミー入力で `rm -rf` や単独 `mkdir` が適切にブロック&代替コマンドへ案内されることを検証して報告してください。まとめ:不可逆な消去を封じ安全なAI開発環境へ
AIコーディングエージェントがなぜ消去時だけシェルへ逃げて rm -rf を叩くのかという構造的理由から、macOS 純正 /usr/bin/trash と git rm による復元率100%の削除ガード、そして事前 mkdir 禁止までを一気通貫で検証してきました。
-
専用削除ツール不在の罠を理解する :AIエージェントには不可逆操作の責任境界から専用の
delete_fileツールがなく、放置すると汎用シェルでrm -rfの誤爆や1ファイルずつの小刻みrmを引き起こします。 -
Git管理下は
git rm、未追跡は/usr/bin/trashへ1回で統合 :macOS 15 Sequoia 以降で標準搭載された/usr/bin/trashは、外付けSSDやRAMDisk上でも同一ボリューム内の.Trashes/<UID>へ瞬間移動するためコピー負荷が一切かからず、Finderから100%元の場所へ復元できます。 -
事前
mkdirの全面禁止とPreToolUseフックの代替案内 :write_fileの親フォルダ自動生成を活かして単独mkdirを封じ、万が一AIが手癖でrm -rfや単独mkdirを叩いてもPreToolUseフックが代替コマンド構文を即座に差し戻す二段防衛で、安全性と開発速度を両立できます。

rm -rf を禁止して /usr/bin/trash と git rm に置き換えるだけで、「うっかり消されたらどうしよう」という不安がゼロになるうえに、無駄な mkdir や小刻み rm が消えて動作まで速くなるなんて一石二鳥ですね!

そうなんだよ。「安全性」と「スピード」は二律背反(トレードオフ)に見えて、実はOS標準の仕組みとツールの仕様を正しく噛み合わせれば同時に手に入るんだ。ぜひ今日から自分の GEMINI.md やフックに組み込んで、安心してAI相棒にファイル整理を任せてみてね!
