ANTIGRAVITY LABEN
記事一覧/Editor View
Editor View/2026-06-30上級

組み込み Guide スキルは助言にすぎない — Antigravity の出力を機械的に弾くゲートを併設する

v2.2.1 の組み込み Guide スキルはエージェントの遵守率を引き上げますが、確率的な助言である点は変わりません。残った違反を確実に止める決定論的な検証ゲートの設計を、動くコードと実測値で示します。

Antigravity293Guide スキルAGENTS検証ゲートエージェント運用6

プレミアム記事

v2.2.1 の組み込み Guide スキルを使い始めて2週間ほど経った頃、私はひとつのコミットを危うくそのまま通しかけました。Guide には「テーブルは HTML の <table> で書く」と明記してあり、それまでの15コミットすべてが従っていたので、16本目もざっと眺めて承認しようとしたのです。実際にはそのコミットだけ Markdown のパイプ記法に戻っていました。

問題はエージェントが間違えたことではありません。遵守率が上がったことで、私が見るのをやめかけたことです。Guide スキルは確かに効きます。けれども効くからこそ、残った数パーセントの違反が一番見えにくい場所に隠れます。助言レイヤと、確実に違反を止める決定論レイヤをどう噛み合わせるか。私が個人開発で複数のリポジトリを回す中で固めた設計を、順を追ってお見せします。

組み込み Guide スキルは確率的な遵守率の引き上げ

v2.2.1 で入った組み込みの Guide スキルは、リポジトリやプロジェクトに紐づく恒常的な指示をエージェントに持たせるための仕組みです。AGENTS.md に散らばっていた「このリポジトリではこう書く」というルールを、エージェントが毎セッション参照する前提の場所へ集約できます。

私の手元では、導入前後で体感がはっきり変わりました。Guide を置く前は、5〜6コミットに1回くらいの頻度で「規約から外れた出力」が混ざっていました。Guide を置いたあとは、その頻度がぐっと下がります。

ただし、ここで誤解してはいけない点があります。Guide スキルがやっているのは遵守率の引き上げであって、保証ではありません。モデルの出力は確率的なので、同じ Guide を読んでいても、文脈が長くなったり似た指示が競合したりすると、ときどき外します。「ほぼ守る」と「必ず守る」の間には、運用上は大きな溝があります。

遵守率が上がるほど、残った違反は見えにくくなる

ここが今回の核心です。直感に反しますが、Guide スキルの遵守率が高いほど、レビューする側の注意力は落ちます。

人間のレビューは、違反を「ときどき見つける」状態だと緊張感が保たれます。ところが10本中9本以上がきれいに通ると、無意識に流し読みへ移行します。私が16本目を承認しかけたのは、まさにこの状態でした。Guide が効くほど、私自身が検出器として鈍化していたわけです。

この性質は、率で考えると整理できます。仮に1本あたりの違反確率が25%から5%へ下がったとします。違反は5分の1になりますが、人間が各コミットへ割く注意は、頻度が下がるほど比例以上に薄くなります。結果として「すり抜けた1本が本番に届く確率」は、必ずしも下がりません。 助言だけで運用を閉じてはいけない理由は、品質が悪いからではなく、品質が良くなったがゆえの油断にあります。

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

この記事の続きを読む

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

この記事で得られること
Guide スキル導入で違反率が約4本に1本から約20本に1本へ下がる一方、見落としリスクがむしろ上がる理由
残存違反を100%止める決定論的ゲート(Python)と、違反をエージェントへ差し戻す再実行ループの実装
Guide だけ/Guide+ゲートを並べた検証マトリクスと、レビュー差し戻し時間が約3分の1になった実測
Stripe による安全な決済 · いつでもキャンセル可能

この記事を購入する

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

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

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

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

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

関連記事

Editor View2026-06-22
入れ子になったAGENTS.mdの優先順位 — 複数プロジェクトを一つのワークスペースで束ねる合流設計
一つのワークスペースに複数のプロジェクトを置き、それぞれにAGENTS.mdを持たせると、エージェントはどの指示に従うのか曖昧になります。ルートと各プロジェクトの指示が静かに衝突し、片方だけが効いたり両方が混ざったりします。「近いほど強い」を基本則に、上書きと追記を区別して合流させる設計を、動くPython実装と運用の所感つきでまとめました。
Editor View2026-06-28
高速化した部分文字列検索を、大規模リポジトリでエージェントに正しい文脈を渡す土台にする
Antigravity の部分文字列検索が高速化したことを単なる体感速度の向上で終わらせず、巨大なコードベースでエージェントに過不足ない文脈を渡すための検索設計へどう接続するかを、具体的な手順と落とし穴とともにまとめます。
Editor View2026-06-26
Antigravity が一気に書いた巨大な差分を、意味単位のコミットに分け直す
エージェントが書いた数百行の差分を、そのままコミットしていませんか。レビューできない一括コミットを、関心ごとに分け直すための実践的なワークフローとスクリプトを紹介します。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →