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

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

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

Antigravity377Guide スキルAGENTS検証ゲートエージェント運用18

✦ プレミアム記事

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/月 または ¥2,480 の永久アクセス
メンバーシップを見る →

関連記事

⟐ Editor View2026-09-17
VS Code から持ってきた拡張が Open VSX に無いとき、どこまで追いかけるか
Antigravity へ移したあと、拡張機能だけが付いてこない理由と、足りない分を機械で洗い出して埋め方を決めるまでの手順です。Open VSX の公開者を確かめる方法、VSIX を台帳で固定する運用、レジストリ差し替えの副作用まで扱います。
⟐ Editor View2026-09-10
日英で本数が合っていても、コードブロックは 148 ペアでずれていました
日本語版と英語版のファイル数が 1,057 対 1,057 で揃っていても、本文の構造までは揃っていませんでした。コードブロックと H2 の個数を数え直して出たずれ、文字数比では捕まえられなかった理由、40 行の検査スクリプトを書き残します。
⟐ Editor View2026-09-03
Antigravity の自動コミットメッセージを、どこまで受け入れるか決めました
Review ペインの自動コミットメッセージを、どこまで受け入れてどこから自分で書くか。prepare-commit-msg に Why 行を足す実装と、リベースやリバートで手が止まった実測を書き残します。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます