プロジェクトでニューラルネットワークエージェントを整理し、誤ったrm -rfを避ける方法

コードで自律型AIアシスタントを使用する場合、よくある問題がしばしば発生します。モデルにターミナルとファイルシステムへのアクセス権を付与し、プロジェクトのビルドやバグ修正を依頼すると、数分後にキャッシュをクリアしようとして重要なファイルを削除してしまうことがあります。また、1時間前に議論したアーキテクチャの合意を完全に忘れて、即興で作業を始めたりすることもあります。

リポジトリ vudovn/ag-kit はこの問題に対する体系的な解決策を提供します。これはGoogle Antigravity環境向けの契約、ルール、ツールの готовый セットです。ニューラルネットワークの予測できないやり取りを、役割の分離と危険な操作からの保護を備えた予測可能なプロセスに変換します。

キットの内容

初期化の後、AG Kitはプロジェクトルートに構造 .agents/ を作成します。内部には specialized roles、スキル、 готовые workflows、長期メモリの宣言的説明があります。

プロジェクトがGoogle Antigravityで開かれると、環境はこの設定を読み込みます。すべてを同時に実行しようとする1つの汎用チャットボットではなく、タスクが narrow specialists に分配され始めます。

リポジトリには以下のコンポーネントが含まれています：

• 異なる開発タスク向けの20の narrow-focused agents
• ルールと検証ロジックを含む47のスキル
• スラッシュコマンドで呼び出す13の готовые scenarios
• 6つの一般的なワークスペースルール
• アーキテクチャの決定を保存するための .agents/memory/ 内の長期メモリモジュール

コンソールコマンド用の保護フック

キットで最も実用的な部分は、組み込みの interceptor PreToolUse です。ターミナルでコマンドを実行する前に、システムがそれをローカルスクリプト validate-tool-call.mjs で処理します。

エージェントが rm -rf / の実行、ディスクのフォーマット、システムパーティションの上書きしようとすると、スクリプトは即座に実行をブロックしてエラーを出力します。一方、 node_modules や dist の削除のような日常的なクリーンアップは遅延なく続行されます。

フックの設定は .agents/hooks.json で定義されています：

{
  "enabled": true,
  "PreToolUse": [
    {
      "matcher": "run_command",
      "command": "node .agents/hooks/validate-tool-call.mjs",
      "timeout": 10
    }
  ]
}

このメカニズムは通常の権限管理やサンドボックス化を置き換えるものではありませんが、致命的なニューラルネットワークの間違いから保護します。

スラッシュコマンドによる明確なシナリオ

毎回チャットで長い指示をゼロから書く代わりに、キットは готовые プロセスを提供します。インターフェースでスラッシュコマンドを入力するだけです。

含まれている13のシナリオからの例をいくつか紹介します：

• /plan はソースコードに触れることなく、詳細な実装計画とチェックリストを作成します
• /coordinate は複数の研究タスクを並行して実行し、統合サマリーをコンパイルします
• /debug はエージェントをログと事実からバグの原因を見つけることに集中させ、むやみな推測を禁止します
• /remember は重要な技術的決定と合意をプロジェクトの永続メモリに記録します
• /verify はチェックとテストを実行して、コードが実際に動作することを証明します

バージョン管理と安全なアップデート

プロジェクトの作成者は、プロンプトとルールを通常のソースコードと同様に扱いました。各エージェント、シナリオ、ルールには明確なセマンティックバージョンがあります。キットの状態は .agents/manifest.json と .agents/manifest.lock.json ファイルにキャプチャされます。

アップデートも丁寧に処理されています。 ag-kit update コマンドはローカルの設定を上書きしません。変更をマージし、 .ag-kit-backups/ フォルダに正確なバックアップを自動的に作成します。

新しいアップデートで何かが壊れた場合、1つのコマンドで以前の状態を復元できます：

ag-kit rollback

自分のプロジェクトで試す方法

Node.jsバージョン22以上とPython 3.10以上が必要です。1つのコマンドで既存のリポジトリを初期化します：

npx @vudovn/ag-kit init

デプロイされた設定とフックが動作していることを確認するために、プロジェクトには組み込みの検証スクリプトが含まれています：

npm run check:agents
npm run check:antigravity

実際の危険なコマンドを実行せずに保護フックをテストするには、テストペイロードを検証スクリプトに直接送信します：

printf '%s' '{"tool_args":{"CommandLine":"rm -rf /"}}' \
  | node .agents/hooks/validate-tool-call.mjs

レスポンスにはメッセージ BLOCKED by AG Kit が表示され、プロセスはゼロ以外のコードで終了するはずです。

このツールの対象者

AG Kitは、Google Antigravityを主要な環境として選択し、AIワークフローに秩序をもたらしたいチームや個人開発者に役立ちます。コンテキストがすぐに乱雑になる大規模プロジェクトでは、20のロールへの厳格な分離と決定のメモリへの保存が相当な時間を節約します。

ただし、覚えておくべき制限があります：完全な互換性はAntigravity内でのみ保証されています。他のエディタは .agents/ 内のマークアップファイルを読み取れますが、フックの反応と自動ルーティングはそこで動作しません。