Scrieți o competență reutilizabilă
Pe această pagină
Dacă instrucțiunile unui GPT sunt inima sa, competența (skill) este inima unui plugin. Acesta este formatul pe care îl utilizați pentru a scrie un flux de lucru reutilizabil: instrucțiuni, resurse și scripturi, dacă este necesar. Competențele OpenAI urmează un standard deschis numit „agent skills“ (agentskills.io), ceea ce înseamnă că o competență bine scrisă nu este blocată într-un singur instrument. Această lecție vă învață cum să scrieți una.
Anatomia unei competențe
O competență este un dosar care conține un fișier obligatoriu, SKILL.md, și elemente opționale.
synthese-document/
├── SKILL.md ← obligatoriu: instrucțiuni + metadate
├── scripts/ ← opțional: cod executabil
├── references/ ← opțional: documentație
├── assets/ ← opțional: șabloane, resurse
└── agents/
└── openai.yaml ← opțional: aspect și dependențe
Fișierul SKILL.md trebuie să includă un name și o description. Iată un exemplu minimal:
---
name: synthese-document
description: Sumarizează un document furnizat în trei părți (prezentare generală, puncte cheie, întrebări deschise). Utilizați când utilizatorul solicită un rezumat sau un raport al unui document atașat.
---
# Rezumatul documentului
1. Citiți întregul document înainte de a scrie.
2. Scrieți trei secțiuni: Prezentare generală (3 propoziții), Puncte cheie (maxim 5 puncte), Întrebări deschise.
3. Bazați-vă doar pe document; dacă lipsesc informații, scrieți „nefurnizat“.
4. Utilizați șablonul din `assets/modele.md` pentru formatare.
Descrierea este piesa centrală
ChatGPT și Codex activează o competență în două moduri. Fie o apelați explicit – tastând @ în ChatGPT sau /skills și $ în Codex – fie instrumentul o selectează automat atunci când cererea dumneavoastră corespunde descrierii sale. De aceea documentația pune accent pe acest câmp: aveți nevoie de o descriere concisă care începe cu cazul de utilizare principal și cuvintele declanșatoare, și care precizează clar limitele sale.
Un mecanism specific impune această cerință: divulgarea progresivă. Inițial, ChatGPT și Codex citesc doar numele și descrierea fiecărei competențe instalate; ele încarcă instrucțiunile complete din SKILL.md doar atunci când utilizează efectiv competența. Acest lucru vă permite să instalați multe competențe fără a aglomera contextul, dar înseamnă și că o descriere vagă duce la o competență care fie nu este aleasă niciodată la momentul potrivit, fie este aleasă la momentul nepotrivit.
Setări opționale
Fișierul agents/openai.yaml vă permite să rafinați afișarea în aplicația desktop (nume, descriere scurtă, pictograme, culoare, prompt implicit), să declarați instrumentele de care depinde competența – un server MCP, de exemplu – și să setați o politică de invocare. Setarea allow_implicit_invocation: false împiedică ChatGPT să aleagă competența singur: util pentru fluxurile de lucru sensibile pe care doriți să le declanșați doar la cerere.
Unde locuiesc competențele și cum le partajați
O competență independentă funcționează în aplicația desktop ChatGPT, în Codex prin linia de comandă și în extensia sa de editor; în Codex, competențele de proiect merg în dosarul .agents/skills al depozitului. Pentru a pune o competență la dispoziția altora, OpenAI recomandă împachetarea acesteia într-un plugin: un plugin poate grupa mai multe competențe și poate adăuga conexiuni la servere MCP sau elemente de prezentare. Competențele incluse într-un plugin devin apoi disponibile în modurile Chat și Work din ChatGPT, pe web, desktop și mobil. În ChatGPT pe web, fila Skills din directorul de plugin-uri vă permite, de asemenea, să creați o competență prin conversație (folosind competența integrată skill-creator), cu un editor sau prin import, și să o partajați în spațiul de lucru; această filă este rezervată planurilor eligibile Business, Enterprise, Healthcare și Edu.
Rândul dumneavoastră
De la GPT la competență. Luați instrucțiunile de la GPT-ul pe care l-ați construit în lecțiile 4 până la 7. Transformați-le într-un SKILL.md: un nume scurt, o descriere care spune când să-l utilizați și când nu, pași numerotați și fișierele dumneavoastră de cunoștințe stocate în references/. Apoi testați competența de două ori: o dată apelând-o cu @ și o dată cu o cerere obișnuită care ar trebui să o declanșeze.
Surse oficiale: Build skills (Documentația ChatGPT: SKILL.md, descriere, locații) · Skills in ChatGPT (Centrul de ajutor OpenAI: fila Skills, planuri, partajare)
Puncte cheie
- O competență este un dosar cu un
SKILL.md(nume + descriere obligatorii) și resurse opționale; aceasta urmează standardul deschis agent skills - Descrierea decide când este aleasă competența: începeți cu cazul de utilizare, cuvintele declanșatoare și limitele
- Divulgare progresivă: doar numele și descrierea sunt citite mai întâi; instrucțiunile se încarcă la momentul utilizării
- Pentru a partaja o competență, împachetați-o într-un plugin
Testați-vă cunoștințele
De la GPT-uri la plugin-uri: validați întregul parcurs.
1. Custom Instructions, Memory, GPT: care este diferența?
Răspuns: Custom Instructions colorează toate conversațiile dumneavoastră; Memory reține fapte despre dumneavoastră în timp; un GPT este un asistent împachetat – instrucțiuni, cunoștințe, instrumente – partajabil cu alții.
2. Ce conține o bună instrucțiune de sistem pentru un GPT?
Răspuns: Rolul, domeniul de aplicare (ce face și ce nu face), tonul, formatul răspunsului și gestionarea cazurilor limită – scrise ca o fișă de post, nu ca o listă de dorințe.
3. La ce servește baza de cunoștințe?
Răspuns: Să ofere GPT-ului documente de referință pe care le consultă pentru a răspunde – ghidurile, cataloagele sau procedurile dumneavoastră, în loc să se bazeze doar pe memoria sa de antrenament.
4. Ce se întâmplă cu acțiunile unui GPT la migrarea către un plugin?
Răspuns: Acestea nu sunt transferate: trebuie să verificați dacă există deja o aplicație în directorul de plugin-uri, altfel reconstruiți integrarea, de exemplu cu un server MCP. Instrucțiunile devin o competență, iar baza de cunoștințe devine fișiere de referință.
5. Înainte de a partaja un GPT sau un plugin, ce verificați?
Răspuns: Teste pe cazuri reale și cazuri limită, conformitatea cu politicile de utilizare, claritatea descrierii, o politică de confidențialitate pentru orice acțiune publică și faptul că nu există date sensibile ascunse în instrucțiuni sau fișiere.
Un instrument partajat angajează creatorul său: testați ca și cum utilizatorii dumneavoastră ar fi deja acolo și migrați-vă GPT-urile înainte de 11 decembrie 2026.