Jak uporządkować agentów sieci neuronowych w projekcie bez chaosu i przypadkowego rm -rf

Jeden częsty problem pojawia się przy autonomicznych asystentach AI w kodzie. Dajesz modelowi dostęp do terminala i systemu plików, prosisz, żeby zbudował projekt lub naprawił błąd, a kilka minut później postanawia wyczyścić cache i usuwa coś wartościowego. Albo zaczyna improwizować, całkowicie zapominając o architektonicznych ustaleniach, które omówiliście godzinę temu.

Repozytorium vudovn/ag-kit oferuje systematyczne rozwiązanie tego problemu. To gotowy zestaw kontraktów, reguł i narzędzi dla środowiska Google Antigravity. Przekształca chaotyczne interakcje sieci neuronowych w przewidywalny proces z podziałem ról i ochroną przed niebezpiecznymi działaniami.

Co zawiera zestaw

Po inicjalizacji AG Kit tworzy strukturę .agents/ w głównym katalogu projektu. Znajdziesz tam deklaratywne opisy wyspecjalizowanych ról, umiejętności, gotowych przepływów pracy i pamięci długoterminowej.

Kiedy projekt otwiera się w Google Antigravity, środowisko odczytuje tę konfigurację. Zamiast jednego uniwersalnego chat-bota próbującego robić wszystko na raz, zadania zaczynają być dystrybuowane do wąskich specjalistów.

Repozytorium zawiera następujące komponenty:

• 20 wąsko wyspecjalizowanych agentów do różnych zadań deweloperskich
• 47 umiejętności z regułami i logiką walidacji
• 13 gotowych scenariuszy wywoływanych za pomocą poleceń slash
• 6 ogólnych reguł przestrzeni roboczej
• Moduł pamięci długoterminowej w .agents/memory/ do zachowywania decyzji architektonicznych

Ochronny hak dla poleceń konsolowych

Najbardziej praktyczną częścią zestawu jest wbudowany interceptor PreToolUse. Przed wykonaniem polecenia w terminalu, system uruchamia je przez lokalny skrypt validate-tool-call.mjs.

Jeśli agent próbuje wykonać rm -rf /, sformatować dysk lub nadpisać partycje systemowe, skrypt natychmiast blokuje wykonanie i wyświetla błąd. Tymczasem rutynowe czyszczenie, jak usuwanie node_modules lub dist, przebiega bez opóźnień.

Konfiguracja haka jest zdefiniowana w .agents/hooks.json:

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

Ten mechanizm nie zastępuje regularnych kontrol uprawnień ani sandboxingu, ale chroni przed śmiertelnymi błędami sieci neuronowych.

Zrozumiałe scenariusze za pomocą poleceń slash

Zamiast za każdym razem pisać od nowa szczegółowe instrukcje na czacie, zestaw oferuje gotowe procesy. Wystarczy wpisać polecenie slash w interfejsie.

Oto kilka przykładów z 13 dołączonych scenariuszy:

• /plan najpierw tworzy szczegółowy plan implementacji i listę kontrolną bez dotykania kodu źródłowego
• /coordinate uruchamia kilka zadań badawczych równolegle, a następnie kompiluje zunifikowane podsumowanie
• /debug koncentruje agenta na znajdowaniu przyczyn błędów z logów i faktów, zabraniając dzikich domysłów
• /remember zapisuje ważne decyzje techniczne i ustalenia do stałej pamięci projektu
• /verify uruchamia sprawdzenia i testy, aby udowodnić, że kod faktycznie działa

Wersjonowanie i bezpieczne aktualizacje

Twórcy projektu potraktowali prompty i reguły jak zwykły kod źródłowy. Każdy agent, scenariusz i reguła ma wyraźną wersję semantyczną. Stan zestawu jest przechwytywany w plikach .agents/manifest.json i .agents/manifest.lock.json.

Aktualizacje są również przemyślane. Polecenie ag-kit update nie nadpisuje lokalnych ustawień. Scala zmiany i automatycznie tworzy dokładną kopię zapasową w folderze .ag-kit-backups/.

Jeśli nowa aktualizacja coś zepsuje, możesz przywrócić poprzedni stan jednym poleceniem:

ag-kit rollback

Jak wypróbować to w swoim projekcie

Będziesz potrzebować Node.js w wersji 22 lub nowszej oraz Pythona 3.10+. Zainicjuj w istniejącym repozytorium jednym poleceniem:

npx @vudovn/ag-kit init

Aby zweryfikować, że konfiguracja została poprawnie wdrożona i haki działają, projekt zawiera wbudowane skrypty walidacyjne:

npm run check:agents
npm run check:antigravity

Możesz przetestować hak ochronny bez wykonywania rzeczywiście niebezpiecznych poleceń, wysyłając ładunek testowy bezpośrednio do skryptu walidacyjnego:

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

Odpowiedź powinna wyświetlić komunikat BLOCKED by AG Kit, a proces powinien zakończyć się z kodem niezerowym.

Dla kogo jest to narzędzie

AG Kit będzie przydatny dla zespołów i indywidualnych deweloperów, którzy wybrali Google Antigravity jako główne środowisko i chcą wprowadzić porządek w przepływach pracy z AI. W dużych projektach, gdzie kontekst szybko się zaśmieca, ścisły podział na 20 ról i zapisywanie decyzji do pamięci oszczędza sporo czasu.

Warto jednak pamiętać o ograniczeniu: pełna kompatybilność jest gwarantowana tylko w Antigravity. Inni edytorzy mogą odczytywać pliki znaczników w .agents/, ale reakcje haków i automatyczne routowanie nie będą tam działać.