HooksHooks
Hooks är deterministiska skript som harnessen kör vid bestämda punkter i agentens arbete och som kan tillåta, spärra eller fråga innan en handling genomförs.
En hook är ett litet skript som harnessen kör automatiskt vid en bestämd punkt: innan ett verktyg anropas, efter att en fil ändrats eller när agenten vill avsluta. Skriptet får veta vad agenten tänker göra och svarar med tillåt, spärra eller fråga människan.
Hooks fungerar som jordfelsbrytaren i ett elskåp. Den slår till varje gång strömmen går fel väg, oavsett vad elektrikern tänkt sig.
Råd eller spärr
En instruktion i systeminstruktionen eller en skill är ett råd som modellen troligen följer. En hook körs utanför modellen och ger samma svar varje gång. Regler som måste hålla utan undantag hör därför hemma i en hook, medan regler som kräver omdöme passar bättre i en skill.
Vanliga användningar
Skyddade sökvägar. Spärra ändringar i genererad kod, frysta paket eller agentens egen konfiguration.
Testlås. Hindra agenten från att ändra testfiler medan en bugg rättas, så att felet måste lösas i koden.
Verifiering före klart. En Stop-hook kör testsviten och skickar tillbaka agenten om något är rött.
Produktionsgrindar. Kräv mänskligt godkännande före deploy eller push till huvudgrenen.
En hook som spärrar bör alltid förklara varför och peka ut vägen vidare. Utan förklaring försöker agenten ofta samma sak igen, och falsklarm blir dyra när de upprepas. Hooks är en del av agentens guardrails.
Fördjupning
- varje-beslut-pa-vaggen — Hooks som spärrar i ett arbetssätt där varje beslut blir spårbart: ingen push till huvudgrenen, inga ändringar i agentens egna regler och inget klart med röda tester
- harness-design-principer — Hooks som ett av harnessens lager