GEMINI LABEN
SHEETS — Fill with Geminiが28言語に拡大しました。中国語・トルコ語ほか各言語のまま自然文で表を組めますALPHAEVOLVE — Gemini Enterpriseに、コードをAIが自律的に最適化するAlphaEvolveが一般提供されましたSPARK — macOS向けの個人AIエージェントGemini Sparkが、フォルダ整理やWorkspace横断の作業を代行しますOMNI — Gemini Omniがテキスト・写真・動画を掛け合わせた高品質な動画作成と、自分に似たAIアバターに対応しますGEMINI35 — Gemini 3.5 Proがアーキテクチャ刷新のため7月17日へ延期。200万トークンとDeep Thinkを導入予定ですDEEPTHINK — 3.5 Proは数学的推論・SVGシーン生成・画像品質の改善を狙って再設計されていますSHEETS — Fill with Geminiが28言語に拡大しました。中国語・トルコ語ほか各言語のまま自然文で表を組めますALPHAEVOLVE — Gemini Enterpriseに、コードをAIが自律的に最適化するAlphaEvolveが一般提供されましたSPARK — macOS向けの個人AIエージェントGemini Sparkが、フォルダ整理やWorkspace横断の作業を代行しますOMNI — Gemini Omniがテキスト・写真・動画を掛け合わせた高品質な動画作成と、自分に似たAIアバターに対応しますGEMINI35 — Gemini 3.5 Proがアーキテクチャ刷新のため7月17日へ延期。200万トークンとDeep Thinkを導入予定ですDEEPTHINK — 3.5 Proは数学的推論・SVGシーン生成・画像品質の改善を狙って再設計されています
記事一覧/Workspace 連携
Workspace 連携/2026-07-12上級

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

ローカルのフォルダ整理を自律エージェントに任せる前に、内容ハッシュのマニフェスト・許可リスト・実行後の差分検証で不可逆な操作を防ぐガードレールを設計した実務メモです。

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

プレミアム記事

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

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

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

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

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

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

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

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

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

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

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

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

順に見ていきます。

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

この記事の続きを読む

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

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

この記事を購入する

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

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

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

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

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

関連記事

Workspace 連携2026-05-27
Google Play 多言語レビュー返信を Gemini と作る — 11 言語の温度感を維持する運用設計
Google Play のレビューに、日本語・英語・繁体字・韓国語・タイ語・イタリア語・ロシア語・ペルシャ語・ウクライナ語・ポーランド語の 11 言語で返信し続けるための運用ルールと、Gemini に何を任せて何を任せないかの線引きを、実際に 2 セッション 71 件返信した記録から書きます。
Workspace 連携2026-05-24
NotebookLM と Gemini Deep Research を Firebase SPM 移行調査で2週間並行運用した所感
個人開発のiOS壁紙アプリ群(累計5,000万DL超)をCocoaPodsからSPMに移行する下調べに、NotebookLMとGemini Deep Researchを2週間並行で使った所感を整理。どちらが何に強いかをそのまま記録します。
API / SDK2026-07-04
Managed Agents を並列で回すと同じリポジトリを奪い合う ― 隔離サンドボックスに効く外部リースとフェンシング
Managed Agents は実行ごとに隔離サンドボックスが立つため、複数実行が同じリポジトリやレコードに同時に触れてもローカルロックが効きません。外部リースとフェンシングトークンで単一実行を保証する実装をまとめました。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →