◉GEMINI LABEN
●ARGON — gemini-4-argon が 10/13 に GA。複雑なコーディング・エージェント・数学・科学向けです●DEEP RES — deep-research-pro-preview-12-2025 は 10/23 に停止、残り6日。移行先は deep-research-preview-04-2026●NANO — gemini-nano-banana-2.1 が GA(10/06)。gemini-3.1-flash-image は非推奨で停止日は未発表です●MCP — ツール結果が 8.5万トークンに膨らんだ事例を、ADK で 310 トークンに包んで抑えた報告が出ています●FLASH — gemini-3.7-flash と 3.5-flash は新しい Flash モデルに自動で回されます(10/08)●NEW — クラッシュ報告を毎回ゼロから読ませない — 既知バグ早見表を先に grep し…●ARGON — gemini-4-argon が 10/13 に GA。複雑なコーディング・エージェント・数学・科学向けです●DEEP RES — deep-research-pro-preview-12-2025 は 10/23 に停止、残り6日。移行先は deep-research-preview-04-2026●NANO — gemini-nano-banana-2.1 が GA(10/06)。gemini-3.1-flash-image は非推奨で停止日は未発表です●MCP — ツール結果が 8.5万トークンに膨らんだ事例を、ADK で 310 トークンに包んで抑えた報告が出ています●FLASH — gemini-3.7-flash と 3.5-flash は新しい Flash モデルに自動で回されます(10/08)●NEW — クラッシュ報告を毎回ゼロから読ませない — 既知バグ早見表を先に grep し…
記事一覧/Workspace 連携
◧ Workspace 連携/2026-07-12上級

ローカルのファイルを任せる前に決めたこと — Gemini Spark を迎えるためのフォルダ境界とガードレール設計

ローカルのフォルダ整理を Gemini Spark に任せる前に設計したガードレールの実務メモです。実行前の内容ハッシュのマニフェスト、許可リストによる操作範囲の宣言、実行後の差分検証という3段構えと、任せる作業と自分で持つ作業の線引きを共有します。

Gemini Sparkエージェント16ファイル操作ガードレール個人開発121

✦ プレミアム記事

macOS に来た Gemini Spark に、まず頼みたくなったのはフォルダの整理でした。個人開発で溜まっていく画像アセット、書きかけの資料、App Store や Google Play 向けに書き出した成果物が、ひとつのワークスペースに何百と積み上がっています。「これを意味のある構造に並べ直して」と一言で任せられるなら、確かに助かります。

けれど、実際に走らせる前に手が止まりました。整理という作業は、突き詰めれば移動と削除の連続です。そして移動と削除は、多くの場合あとから取り消せません。任せたいのに、任せた瞬間に取り返しがつかなくなるかもしれない。その落差をどう埋めるかを、しばらく考えていました。

ここで共有するのは、Spark のようなローカルのファイルを触るエージェントに整理を委ねるにあたって、私自身が実際に組んだガードレールです。エージェントの賢さを疑うのではなく、不可逆な操作にだけ人間側の検証を挟むという発想です。

何が怖かったのかを言葉にする

漠然と「怖い」で止めていては設計になりません。まず、自分が何を恐れているのかを分解しました。

恐れていたこと具体的に起きうる事故取り返しのつきやすさ
意図しない削除「不要そう」と判断された下書きが消える低い(バックアップ次第)
範囲外への移動公開済み成果物が作業用フォルダへ紛れる中程度
静かな上書き同名ファイルが別内容で置き換わる低い
把握できない変更数百件を一括処理され差分が追えない低い

こうして並べてみると、怖さの正体は「操作そのもの」ではなく「操作の結果を自分が確認できないこと」だと分かりました。だとすれば、対策は明快です。エージェントに何をさせるかを制限するより先に、エージェントが何をしたかを後から必ず確認できる状態を作ればよいのです。

起点は「任せる作業」と「自分で持つ作業」を分けること

ガードレールのコードに入る前に、線引きの原則を決めました。私は次のように分けています。

分類・並べ替え・命名の提案といった「元に戻せる、あるいは提案にとどまる作業」は積極的に任せます。一方で、削除・ワークスペース外への移動・既存ファイルの上書きといった「取り返しのつかない作業」は、エージェントに直接実行させず、必ず人間の承認を経由させます。

この原則をそのまま仕組みに落とすと、三つのガードレールになりました。

  1. 実行前にワークスペースの状態を内容ハッシュで記録する
  2. 許可した範囲だけを触れるように許可リストで宣言する
  3. 実行後に宣言と実際の差分を照合し、違反を承認待ちに回す

順に見ていきます。

✦

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

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦実行前に内容ハッシュのマニフェストを取り、エージェントが触れた範囲を後から機械的に検証する仕組み
✦許可リストで「移動してよい範囲」と「絶対に消させない範囲」を宣言し、違反を自動でロールバックする設計
✦手元のワークスペースで実測した誤操作検知の結果と、任せる作業・自分で持つ作業の線引き表
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

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

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

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

関連記事

◧ Workspace 連携2026-07-16
=GEMINI() を420行に貼って気づいたこと — カスタム関数をやめ、値で書き戻すまでの実測
Sheets のカスタム関数から Gemini を呼ぶ構成は、動いた瞬間がいちばん美しく、そこから伸びません。30秒の壁・制御できない再計算・書き戻せない結果という3つの性質を実測で確かめ、値で書き戻す設計へ移すまでの手順とコードを残します。
◧ Workspace 連携2026-05-27
Google Play 多言語レビュー返信を Gemini と作る — 11 言語の温度感を維持する運用設計
Google Play のレビューに、日本語・英語・繁体字・韓国語・タイ語・イタリア語・ロシア語・ペルシャ語・ウクライナ語・ポーランド語の 11 言語で返信し続けるための運用ルールと、Gemini に何を任せて何を任せないかの線引きを、実際に 2 セッション 71 件返信した記録から書きます。
⬡ 高度な活用2026-09-05
長い動画を Gemini に辿らせるとき、見つける問いと「無い」を確かめる問いは別々に投げています
9月1日に来たエージェント的動画理解では、どこを観るかをモデル自身が決めます。見つける問いには効きますが、映り込みが無いことの確認には被覆の保証がありません。問いの形で処理モードを分ける判断と、被覆を自分で担保する実装を書き残します。