# Antigravityの機能と実践的な使い方 🚀 エージェントの実行ループに「割り込み」を仕込めたら、安全性も再現性も一気に上がります。Antigravityのライフサイクルフックは、まさにそのための仕組みです。 📌 タイトルと機能のURL タイトル: Hooks URL: 📝 概要 Hooksは、Antigravityのエージェント実行ループの特定のタイミングで、自前のスクリプトやシェルコマンドを差し込む仕組みです。ツール呼び出しの前後やセッション終了時などのイベントに反応して、ルールの強制・ロギング・ガードレールを自動化できます。人手の監視に頼らず、組織のポリシーをエージェントに守らせる土台になります。 🔧 機能の説明 フックはイベント単位で発火し、用途によって性質が分かれます。 ・PreToolUse：ツール実行の前に発火し、引数を検査して許可/拒否を判断できます ・PostToolUse：ツール完了後に発火し、結果のロギングや監査に使えます ・PreInvocation：モデル呼び出しの前に発火します ・PostInvocation：各モデル呼び出しが完了した直後に発火します ・Stop：実行ループの終了時に発火します ・性質による分類として、観測専用で非ブロッキングの「Inspect」、許可/拒否を返してブロックする「Decide」、データを書き換える「Transform」があります ・Decide系はallow/denyの判断結果（HookResult）を返し、ポリシー違反を未然に止められます 🛠 実践的な使い方 ・PreToolUseで危険なコマンド引数を検査し、条件に合えばdenyを返して実行を止めます ・PostToolUseで実行内容を構造化ログに残し、メトリクスや監査証跡を蓄積します ・モデル呼び出し前にシステム指示を注入し、社内規約をプロンプトに反映します ・Stopを停止条件のチェックに使い、必須テストやLintの通過を強制します ・実行順序は「判断（Decide）→操作の実行→観測（Inspect）」で、検証を先に走らせTOCTOU的な抜けを防ぎます 🎯 ユースケース ・本番DBへの破壊的操作をエージェントが実行する前にブロックする ・すべてのツール呼び出しを記録し、後から振り返れる監査ログを自動生成する ・モデル呼び出し前にコーディング規約や禁止事項を毎回注入する ・セッション終了時にLint・型チェック・テストの実行を強制する ⚠️ 注意点 ・Inspect/Decide系は読み取り専用で、データそのものは変更できません（書き換えはTransform系） ・拒否ロジックを誤るとエージェントが正常な作業まで止めてしまうため、条件は慎重に設計してください ・設定の置き場所やJSONの入出力仕様はバージョンや配布形態で異なる場合があるため、最新ドキュメントで確認してください ・フックは実行ループに割り込むため、重い処理を入れると全体のレスポンスが遅くなります #Antigravity# #DevTools#