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.