Treci la conținutul principal

Skill-uri și instrumente

Skill-urile comune se află în .agents/skills/. Editați aceste surse, apoi rulați yarn ai-workflow:sync pentru a genera .claude/skills/ pentru Claude Code. Codex descoperă skill-urile direct în .agents/skills/.

Prompturile comune pentru roluri se află în .agents/roles/*.md. Acesta este un format sursă specific depozitului, nu o cale nativă de descoperire a agenților. scripts/ai-workflow-files.mjs convertește aceste surse în fișierele specifice fiecărei aplicații, enumerate mai jos; yarn ai-workflow:sync le scrie. Includeți fișierele generate în commit împreună cu sursele lor, astfel încât un checkout proaspăt să aibă configurația nativă fără a rula mai întâi un generator. După eliminarea unei surse, eliminați explicit ieșirile generate devenite inutile; validatorul le raportează, în loc să șteargă fișiere în tăcere.

Căi native de descoperire​

Verificat în raport cu documentația oficială la 2026-09-12:

AplicațieInstrucțiuni de proiectSkill-uri folosite de acest depozitAgenți personalizați folosiți de acest depozit
CodexAGENTS.md.agents/skills/<name>/SKILL.md.codex/agents/<name>.toml, generat
Claude CodeCLAUDE.md importă @AGENTS.md.claude/skills/<name>/SKILL.md, generat.claude/agents/<name>.md, generat

Surse: Skill-uri Codex, Subagenți Codex, Memoria Claude, Skill-uri Claude, Subagenți Claude.

Nu înlocuiți directoarele native de agenți cu .agents/roles și nu presupuneți că Claude descoperă .agents/skills. Claude poate totuși citi un fișier de acolo, la care se face referire, ca simplu context de proiect.

Directoarele AI folosesc terminații de linie LF prin .gitattributes, astfel încât textul generat să rămână identic pe toate platformele. Resursele auxiliare ale skill-urilor sunt copiate octet cu octet.

Skill-uri​

SkillScop
commitCreează commit-uri locale autorizate și bine delimitate
commit-format, issue-formatFormatează sugestii, la cerere
make-closed-issueCreează un issue autorizat, un commit bine delimitat și un PR
review-and-merge-prTriază feedbackul la PR-uri; corectează, publică sau face merge doar în limitele cererii
fix-merge-conflictsRezolvă conflictele și verifică rezultatul integrat
releasePregătește textul release-ului și execută pașii de release autorizați
code-quality-reviewRevizuiește diff-uri netriviale sau o problemă de calitate cerută explicit
retroTransformă greșelile demonstrate în verificări sau îndrumări țintite, care previn repetarea lor
refactor-pass, deslopCurățarea cerută a modificărilor existente
debug-agentDepanare bazată pe dovezi, cu instrumentare atunci când este nevoie
you-might-not-need-an-effectRevizuire țintită a efectelor și a memoizării
vercel-react-best-practicesÎndrumări aplicabile de performanță React; regulile pentru Next.js sau doar pentru server se omit la acest client Vite
translateGenerează traduceri, apoi aplică hărțile printr-un singur proces de scriere
playwright-cli, inspect-elementsVerificare în browser și maparea DOM-ului la sursă
profile-browsingProfilare delimitată a browserului și a React
test-apkVerifică un wrapper Android însoțitor primit
impeccable, improve-threejsDesign de interfață delimitat și revizuirea randării Three.js
implement-planExecută un plan, cu delegare opțională în limite clare
readmeÎntreține documentație de proiect verificată
context7Obține documentația bibliotecilor potrivită versiunii
find-skillsGăsește skill-uri suplimentare, când se cere explicit

Roluri și modele​

Păstrați rolurile personalizate pentru browser-check, profiler, test-apk, translator și reviewer. Pentru implementarea obișnuită și descoperirea codului, folosiți rolul integrat al harness-ului de tip worker/general-purpose sau explorer. Agentul părinte stabilește criteriile de acceptare și proprietatea; un singur proprietar rulează verificările grele.

Fișierele de agent Codex includ name, description și developer_instructions. .codex/config.toml limitează la patru numărul subagenților concurenți prin max_concurrent_threads_per_session. Metadatele comune ale rolurilor conțin numele, descrierea și modul sandbox opțional; în mod deliberat, nu au câmpuri de model.

Lăsați câmpurile de model și de raționament în afara skill-urilor și agenților personalizați incluși în depozit. Astfel rămân posibile alegerile făcute la invocare, valorile implicite ale utilizatorului și moștenirea de la părinte, conform ordinii de precedență documentate a fiecărei aplicații. Aliasurile de familie Claude reduc întreținerea legată de versiuni, dar tot aleg o familie. Păstrați astfel de alegeri în setările utilizatorului sau ale sesiunii, când este nevoie. Moștenirea nu garantează alegerea automată a celui mai bun model actual. Nu inventați un alias latest și nu adăugați cercetarea catalogului de modele la sarcinile de rutină. Consultați selecția în Codex și selecția în Claude.

sandbox-mode: read-only corespunde sandboxului din Codex. Lista de instrumente a lui Claude și instrucțiunile rolului îi restricționează fluxul de revizuire, dar accesul la Bash nu este un sandbox la nivelul sistemului de operare.

Frontmatter-ul skill-urilor comune folosește disable-model-invocation: true pentru fluxurile invocate de utilizator, acolo unde se aplică. Setarea corespunzătoare din Codex se află în agents/openai.yaml, sub forma policy.allow_implicit_invocation: false; validatorul le cere pe amândouă. Metadatele de invocare completează regulile explicite de autorizare; o cerere de revizuire nu autorizează niciodată publicarea doar pentru că un skill include pași de publicare.

Verificări și descoperire​

  • yarn ai-workflow:sync regenerează ieșirile de compatibilitate folosind pachetele instalate js-yaml și smol-toml.
  • yarn ai-workflow:check parsează sursele, frontmatter-ul și configurațiile și verifică ieșirile generate, metadatele de invocare, amplasarea câmpurilor de model și conectarea hook-ului care doar formatează. Nu verifică identificatorii de model în catalogul vreunui furnizor.
  • yarn ai-workflow:test rulează fixture-uri Node izolate pentru payload-urile hook-urilor și pentru generarea și validarea fluxului de lucru.
  • După actualizarea unei aplicații de agent, verificați în acea aplicație descoperirea skill-urilor și a rolurilor. Verificările de sintaxă și de paritate nu înlocuiesc o verificare a încărcătorului. Reîncărcați aplicația dacă o sesiune existentă păstrează un catalog vechi.
  • Hook-urile necesită încrederea în proiect și revizuirea hook-urilor din harness; nu ocoliți mecanismul de încredere ca să treacă o verificare. Consultați hooks-setup.md.

Menținerea unor instrucțiuni utile​

Urmați îndrumările OpenAI despre skill-uri și prompturi (consultate la 2026-09-12): păstrați descrierile precise, încărcați detaliile doar când sunt relevante și respectați domeniul cerut de utilizator. Skill-urile comune servesc modele diferite; păstrați invarianții specifici proiectului, lăsând totodată loc alegerilor de implementare de rutină.

Păstrați în SKILL.md scopul unui skill, limitele lui de decizie și constrângerile esențiale. Legați comenzile sau exemplele ample, specifice unui anumit mod, ca referințe opționale. Puneți condițiile de declanșare la începutul descrierilor scurte; un simplu cuvânt-cheie care se potrivește nu ar trebui să extindă sarcina. Păstrați metadatele de invocare existente, cu excepția cazului în care comportamentul lor este schimbat intenționat.

După o modificare substanțială a instrucțiunilor, încercați câteva cereri reprezentative, mici și mari. Verificați ce skill-uri și referințe au fost selectate, dacă acțiunile au rămas în limitele cererii, dacă verificarea s-a potrivit cu modificarea și dacă lucrul autorizat a fost dus la capăt. Testele de schemă și fixture-urile stabilesc corectitudinea instrumentelor, nu calitatea deciziilor agentului.

Instrumente și proprietatea browserului​

Preferați catalogul existent de skill-uri și instrumente și CLI-urile instalate ale proiectului. Folosiți gh pentru GitHub, playwright-cli pentru verificarea în browser și documentația oficială, specifică versiunii, atunci când contează comportamentul bibliotecii. Evitați instalarea de skill-uri duplicate sau descărcarea unui pachet nefixat doar pentru a rula un formator existent.

Costul suplimentar al MCP depinde de harness: încărcarea amânată a instrumentelor poate evita încărcarea tuturor schemelor de la început. Păstrați integrările relevante, în loc să tratați MCP ca fiind depășit în sine. Alegerile existente bazate pe CLI rămân utile pentru reproductibilitate și pentru controlul resurselor.

Toate sesiunile de browser folosesc ./scripts/pw-session.sh, care impune un singur browser activ la nivelul întregii mașini. Implicit, folosiți o sesiune nouă, izolată. Accesul la browserul personal curent necesită autorizare explicită; refolosiți acea autorizare în pașii următori. Alegeți browserele și viewporturile în funcție de comportamentul afectat, rulați secvențial motoarele selectate, închideți la curățare exact sesiunea denumită și nu folosiți niciodată close-all/kill-all. Consultați skill-ul playwright-cli și verification.md.