Ghid operator pentru agenți AI autonomi
Ce face
autonomous-ai-agents este skill-ul umbrelă pentru orchestrarea agenților externi de dezvoltare: Claude Code, Codex, OpenCode și lane-uri similare. Nu este un agent unic și nu garantează că vreun CLI anume este instalat în runtime-ul curent.
Rolul lui este să aleagă modelul de lucru potrivit pentru delegare: coding, implementare de feature, refactorizare, review de PR, debugging sistematic, plan writing sau o bandă izolată de execuție pentru un task mai mare. Separă conversația principală de execuția autonomă și păstrează responsabilitatea pe orchestrator: alegere, lansare, verificare, raportare și handoff.
Acoperă și lucrul pe Hermes Agent însuși: CLI, configurare, modele, provideri, tool-uri, skill-uri, voice, gateway, pluginuri, extensii și contribuții. Pentru Hermes Agent, documentația publică oficială rămâne sursa autoritativă.
Când îmi folosește
Îți folosește când munca este suficient de mare, repetitivă sau izolabilă încât merită trimisă într-un agent autonom, dar rezultatul trebuie verificat înainte să fie tratat ca adevăr.
Cazuri tipice:
- delegare de coding, feature implementation, refactoring sau PR review;
- review-uri sau batch reviews unde vrei concluzii separate de conversația principală;
- debugging sistematic sau plan writing asistat de agent;
- parallel issue fixing cu worktrees, dacă runtime-ul și agentul ales permit asta;
- lucru pe configurarea sau extensiile Hermes Agent;
- lane izolată pentru un worker Kanban, în timp ce orchestratorul păstrează lifecycle-ul, testarea și handoff-ul.
Nu se folosește pentru a ocoli verificarea umană sau pentru a acorda unui agent autonomie nelimitată. Agentul poate propune, modifica sau testa doar în limitele task-ului primit și ale permisiunilor runtime-ului.
Cum îl invoc / declanșez
Nu există o comandă universală publică pentru toate runtime-urile. Declanșarea este conceptuală: formulezi cererea ca delegare către un agent autonom și precizezi scopul, limitele, ce are voie să modifice și ce trebuie verificat.
Exemple de declanșatori:
- „delegă implementarea acestui feature unui agent autonom”;
- „fă PR review cu Codex/Claude Code/OpenCode”;
- „rulează o lane izolată pentru acest task”;
- „folosește agent delegation pentru debugging sistematic”;
- „lucrează la configurarea Hermes Agent”.
Decision flow-ul documentat este:
- Claude Code disponibil și task-ul se potrivește punctelor forte Anthropic → zona Claude Code
- Codex preferat sau deja autentificat → zona Codex
- OpenCode cerut explicit → zona OpenCode
- lucru intern Hermes sau skill system → zona Hermes Agent
- nevoie de lane Kanban izolată → zona Kanban Codex Lane
Dacă numești explicit un script existent care deja orchestrează Hermes sau alt agent, regula este să fie rulat scriptul direct, nu învelit într-un alt worker delegat.
Vezi și All guides pentru restul ghidurilor publicate.
Exemplu practic
Cerere slabă:
„Uită-te peste PR.”
Cerere mai bună:
„Fă PR review cu agent autonom. Verifică riscuri, bug-uri probabile, acoperire de teste, schimbări care pot rupe compatibilitatea și ce rămâne incert. Nu aplica modificări fără să raportezi propunerea.”
Skill-ul direcționează spre agentul potrivit în funcție de disponibilitate și preferință explicită. Claude Code este descris pentru moduri print și interactive, integrare MCP, hooks, slash commands și workflow-uri de PR review. Codex este descris pentru one-shot tasks, background mode, PR reviews, batch reviews și execuții paralele cu worktrees. OpenCode urmează tipare similare pentru feature work și PR review.
Rezultatul util nu este „agentul a zis că e bine”. Rezultatul util este lista verificărilor făcute, problemele găsite, patch-urile propuse sau aplicate, testele rulate și incertitudinile rămase.
Output / unde aterizează
Output-ul depinde de agent, runtime și task. Poate fi un raport de stare, un review, un plan, un patch, rezultate de test, un handoff sau un run id/status dacă sistemul expune așa ceva.
Pentru scripturi existente de orchestrare, verificarea trebuie să confirme artifactul promis și boundary-ul de side effect: status, metadate relevante, count-uri independente pentru rapoarte bazate pe numărări și dovada că task-urile proposal-only nu au mutat sau modificat surse. Fișierele de zgomot trebuie tratate ca zgomot, nu ca input real.
Nu se sumarizează conținut sensibil doar ca să demonstrezi că ai verificat. Verificarea trebuie să dovedească existență, număr, status și efecte laterale, nu să expună date inutile.
Limite / gotchas
Nu presupune disponibilitatea Claude Code, Codex sau OpenCode doar pentru că sunt menționate. Skill-ul descrie orchestration patterns; instalarea și autentificarea sunt dependente de runtime.
Nu dubla orchestrarea. Dacă există un script care deja dispatch-uiește agentul potrivit, rulează scriptul direct.
Nu trata output-ul agentului ca verdict final. Verifică artifactele, testele, count-urile, statusul și efectele laterale înainte de a raporta succes.
Nu lăsa agentul să extindă singur scopul. Pentru modificări distructive, credențiale, publicare, cheltuieli, acces la date sensibile sau schimbări de autoritate, este nevoie de escalare și confirmare separată.
Nu confunda „proposal-only” cu „a modificat puțin”. Proposal-only înseamnă fără mutări și fără modificări ale surselor. Verificarea trebuie să poată demonstra asta.