Documentație / Agentul
Memorie, skills și reguli
Cum îi oferi agentului context durabil prin memoria proiectului, skills, prompturi, hooks și reguli, și cum învață din greșelile sale.
Agentul nu o ia de la zero în fiecare conversație. Își amintește ce este important despre proiect, încarcă proceduri în funcție de sarcină și respectă regulile echipei tale.
Totul se gestionează în panoul proiectului, fila Agent, cu subfilele Skills, Prompturi, Hooks, Reguli și Instalează. Sus alegi domeniul: Platform (agentul Yuli) sau Abonamente (Claude Code, Kiro, Codex și Antigravity).
Memoria proiectului
Ce trebuie să rețină agentul: instrucțiuni, decizii, convenții și date despre proiect.
- Salvare: spune-i „ține minte că…” în chat sau adaug-o manual.
- Vizualizare și editare: antetul chatului → Mai multe acțiuni → Memoria proiectului.
- Unde se află:
.ai/memory/, versionabilă împreună cu proiectul.
| Grup | Exemplu |
|---|---|
| Instrucțiuni | „Răspunde întotdeauna cu exemple în Java 17.” |
| Decizii | „Folosim arhitectură hexagonală în modulul de plăți.” |
| Convenții | „DTO-urile se termină în Dto și stau în api/dto.” |
| Date despre proiect | „Profilul local folosește baza orders_dev.” |
Intrările care vin odată cu depozitul apar ca „din depozit — neconfirmat” și nu sunt trimise modelului până nu le confirmi. Astfel, un depozit străin nu-i poate da instrucțiuni agentului.
Memoria echipei
Memoria partajată a echipei se află în .ai/team.json, versionată împreună cu proiectul. O vezi în Opțiuni globale → Echipă.
Skills
Un skill este o procedură pe care agentul o încarcă doar când sarcina are nevoie de ea. Yuli include 19:
| Domeniu | Skills |
|---|---|
| Cod | Explicarea codului, Implementarea unei funcționalități, Refactorizare sigură, refactor-or-evolve |
| Teste | Scrierea testelor unitare, Strategia de testare |
| Calitate și revizuire | Revizuirea codului, Revizuirea securității, Revizuirea integrării |
| Diagnostic | Depanare până la cauza principală, Repararea erorilor de compilare, gradle-java-build |
| Design | Analiza cerințelor, Proiectarea arhitecturii, ui-ux-design |
| Date | Explorator de baze de date |
| Documentație | document-system (documentarea sistemului la cerere), sdlc-documentation |
| Git | Mesaj de commit |
Skills-urile incluse sunt Doar citire și se actualizează odată cu aplicația. Pentru a adapta unul, folosește Duplică pentru a personaliza.
Skills proprii
Creează-le pe ale tale în subfila Skills sau importă-le cu Importă skills, prompturi și hooks. Yuli acceptă SKILL.md, PROMPT.md, comenzi Claude Code, .prompt.md din Copilot și hooks.json.
Skills-urile, prompturile și hooks-urile tale se salvează în folderul tău de utilizator (în Windows, %APPDATA%\.yulicode\), astfel încât te însoțesc în toate proiectele.
Cum se combină
În Configurația agentului:
| Mod | Ce folosește |
|---|---|
| Automată | Doar ce vine de la Yuli. |
| Personalizată | Doar ce este al tău. |
| Recomandată + ale mele (implicit) | Ambele. Dacă un nume coincide, câștigă al tău. |
Prompturi
Prompturile sunt instrucțiunile de bază ale agentului: identitate, ciclul de viață al sarcinilor mari, liderul echipei, sub-agent… Yuli le livrează calibrate. Le poți duplica și ajusta.
Prompturile interne sunt în engleză, pentru mai multă precizie și mai puțini tokeni. Răspunsul vine întotdeauna în limba celui care scrie.
Hooks
Un hook interceptează o acțiune a agentului: de exemplu, formatarea a ceea ce s-a modificat sau validarea unei propuneri înainte de aplicare. Scripturile sunt Node.js, primesc evenimentul în JSON, iar un cod de ieșire diferit de zero blochează acțiunea. Motivul blocării ajunge la agent, ca să-și ajusteze planul.
| Eveniment | Când |
|---|---|
| Înainte de folosirea unei unelte | Înainte de fiecare unealtă. |
| După folosirea unei unelte | După fiecare unealtă. |
| La finalizarea unei propuneri | Când agentul termină de propus o modificare. |
| Înainte de autorizare | Înainte să aprobi. |
| După aplicarea modificărilor | Când modificarea a ajuns pe disc. |
Yuli include hooks gata făcute: Blochează comenzile periculoase, Nu citi secretele, Protejează fișierele sensibile, Fără secrete în cod, Fără marcaje de conflict și Fără fișiere uriașe.
Regulile proiectului
Regulile sunt instrucțiuni pe care agentul le respectă întotdeauna în acel proiect.
| Fișier | Domeniu |
|---|---|
.agentrules, yuli.md sau .cursorrules în rădăcină |
Tot proiectul. |
.agentrules într-un subfolder |
Acel folder. Câștigă fișierul cel mai apropiat. |
.ai/rules/*.md |
Regulile echipei. |
În subfila Reguli: + Creează .agentrules, Reguli recomandate și Importă pachet (.zip).
Reguli învățate
Yuli învață din greșelile repetate. Când aceeași constatare apare de 3 ori sau mai mult în cel puțin 2 sarcini în decurs de 30 de zile, devine o regulă în .ai/rules/learned.md.
Revizuiește-le în Centrul de guvernanță → Agenți → Învățare. Poți respinge o regulă candidată; este propusă din nou doar dacă dovezile pentru ea se dublează.
Pentru agentul tău cu abonament
În domeniul Abonamente, fiecare agent are secțiunea lui cu fișierul de reguli pe care i-l transmite Yuli, starea acestuia și „Ce îi transmite Yuli”: regulile sesiunii și fiecare skill Yuli cu costul său în tokeni.