Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Kirjuta uuesti kasutatav oskus

Õppetund 17 / 17 Värskendatud 5. november 2026 Kesktase
Sellel lehel
  1. Oskuse anatoomia
  2. Kirjeldus on keskne element
  3. Valikulised seaded
  4. Kus oskused asuvad ja kuidas neid jagada
  5. Sinu kord
  6. Peamised punktid
  7. Testi oma teadmisi

Kui GPT juhised on selle süda, siis oskus (skill) on pistikprogrammi süda. See on vorming, mida kasutad uuesti kasutatava töövoo kirjutamiseks: juhised, ressursid ja vajadusel skriptid. OpenAI oskused järgivad avatud standardit nimega „agent skills“ (agentskills.io), mis tähendab, et hästi kirjutatud oskus ei ole lukustatud ühele kindlale tööriistale. Selles õppetükis õpid, kuidas sellist oskust kirjutada.

Oskuse anatoomia

Oskus on kaust, mis sisaldab üht kohustuslikku faili SKILL.md ja valikulisi elemente.

synthese-document/
├── SKILL.md          ← kohustuslik: juhised + metaandmed
├── scripts/          ← valikuline: käivitatav kood
├── references/       ← valikuline: dokumentatsioon
├── assets/           ← valikuline: mallid, ressursid
└── agents/
    └── openai.yaml   ← valikuline: välimus ja sõltuvused

Fail SKILL.md peab sisaldama välju name ja description. Siin on minimaalne näide:

---
name: synthese-document
description: Summarizes a provided document into three parts (overview, key points, open questions). Use when the user requests a summary or report of an attached document.
---

# Dokumendi kokkuvõte

1. Loe kogu dokument enne kirjutamist läbi.
2. Kirjuta kolm jaotist: Ülevaade (3 lauset), Põhipunktid (max 5 loetelupunkti), Lahtised küsimused.
3. Tugine ainult dokumendile; kui teave puudub, kirjuta „pole esitatud“.
4. Kasuta vormindamiseks malli `assets/modele.md`.

Kirjeldus on keskne element

ChatGPT ja Codex aktiveerivad oskuse kahel viisil. Kas kutsud seda sõnaselgelt – trükkides ChatGPT-s @ või Codexis /skills ja $ – või valib tööriist selle automaatselt, kui sinu taotlus vastab selle kirjeldusele. Seetõttu rõhutab dokumentatsioon seda välja: vajad lühikest kirjeldust, mis algab peamise kasutusjuhu ja käivitussõnadega ning sätestab selgelt selle piirangud.

Seda nõuet ajendab spetsiifiline mehhanism: progressiivne avalikustamine (progressive disclosure). Algselt loevad ChatGPT ja Codex iga installitud oskuse kohta ainult nime ja kirjeldust; täielikud juhised failist SKILL.md laaditakse alles siis, kui oskust tegelikult kasutatakse. See võimaldab installida palju oskusi ilma konteksti ummistamata, kuid tähendab ka seda, et ebamäärane kirjeldus viib olukorrani, kus oskus kas ei valitu kunagi õigel ajal või valitakse valel ajal.

Valikulised seaded

Fail agents/openai.yaml võimaldab lihvida kuvamist töölauarakenduses (nimi, lühikirjeldus, ikoonid, värv, vaikekäsk), deklareerida tööriistu, millest oskus sõltub – näiteks MCP server – ja määrata kutsepoliitika. Seade allow_implicit_invocation: false takistab ChatGPT-l oskust iseseisvalt valimast: see on kasulik tundlike töövoogude puhul, mida soovid käivitada ainult nõudmisel.

Kus oskused asuvad ja kuidas neid jagada

Iseseisev oskus töötab ChatGPT töölauarakenduses, Codexis käsurea kaudu ja selle redaktori laienduses; Codexis paigutatakse projekti oskused repositooriumi kausta .agents/skills. Et teha oskus teistele kättesaadavaks, soovitab OpenAI pakendada see pistikprogrammiks: pistikprogramm saab koondada mitu oskust ja lisada ühendusi MCP serverite või esitluselementidega. Pistikprogrammi kaasatud oskused muutuvad seejärel kättesaadavaks vestlus- ja töörežiimis ChatGPT-s veebis, töölauarakenduses ja mobiilis. ChatGPT-s veebis võimaldab pistikprogrammide kataloogi vahekaart Skills luua oskust ka vestluse teel (kasutades sisseehitatud oskuse looja oskust), redaktori kaudu või importides ning jagada seda oma tööruumis; see vahekaart on reserveeritud õigustatud Business, Enterprise, Healthcare ja Edu plaanidele.

Oskuse anatoomia Kolm plokki: SKILL.md, kohustuslik, sisaldab nime, kirjeldust ja juhiseid; kaust references, valikuline, viitefailide jaoks; kaust scripts, valikuline, automatiseeritud sammude jaoks. ÜKS KAUST, ÜKS KOHUSLIK FAIL Oskuse anatoomia 1 SKILL.md Nimi, kirjeldus, juhised. Kohustuslik 2 references/ Viitefailid. Valikuline 3 scripts/ Automatiseeritud sammud. Valikuline Kirjeldus otsustab, millal oskus käivitub: ütle, millal oskust kasutada ja millal mitte kasutada.
Põhineb ChatGPT dokumentatsiooni lehel „Build skills“ (november 2026).

Sinu kord

GPT-st oskuseks. Võta juhised GPT-lt, mille lõid õppetundides 4 kuni 7. Teisenda need SKILL.md-ks: lühike nimi, kirjeldus, mis ütleb, millal seda kasutada ja millal mitte, nummerdatud sammud ning sinu teadmiste failid, mis on salvestatud kausta references/. Seejärel testi oskust kaks korda: üks kord, kutsudes seda märgiga @, ja teine kord tavalise taotlusega, mis peaks selle käivitama.

Ametlikud allikad: Build skills (ChatGPT dokumentatsioon: SKILL.md, kirjeldus, asukohad) · Skills in ChatGPT (OpenAI abikeskus: vahekaart Skills, plaanid, jagamine)

Peamised punktid

  • Oskus on kaust, mis sisaldab SKILL.md (kohustuslikud nimi ja kirjeldus) ja valikulisi ressursse; see järgib avatud agent skills standardit
  • Kirjeldus otsustab, millal oskus valitakse: too esile kasutusjuht, käivitussõnad ja piirangud
  • Progressiivne avalikustamine: esmalt loetakse ainult nimi ja kirjeldus; juhised laaditakse kasutamise hetkel
  • Oskuse jagamiseks pakenda see pistikprogrammiks

Testi oma teadmisi

GPT-dest pistikprogrammideni: valideeri kogu tee.

1. Kohandatud juhised, mälu, GPT: mis on erinevus?

Vastus: Kohandatud juhised mõjutavad kõiki sinu vestlusi; mälu säilitab faktide kohta teavet aja jooksul; GPT on pakendatud assistent – juhised, teadmised, tööriistad –, mida saab teistega jagada.

2. Mida sisaldab hea GPT süsteemi juhend?

Vastus: Roll, ulatus (mida see teeb ja mida mitte), toon, vastuse vorming ja piirjuhtude käsitlemine – kirjutatud nagu töökirjeldus, mitte soovinimekiri.

3. Milleks on teadmiste baas?

Vastus: Et pakkuda GPT-le viitedokumente, mida see vastamiseks konsulteerib – sinu juhendid, kataloogid või protseduurid, selle asemel et tugineda ainult selle treeningmälule.

4. Mis juhtub GPT tegevustega pistikprogrammi migreerimisel?

Vastus: Neid ei üledata: pead kontrollima, kas rakendus on juba pistikprogrammide kataloogis olemas, vastasel juhul tuleb integratsioon uuesti üles ehitada, näiteks MCP serveriga. Juhistest saab oskus ja teadmiste baasist viitefailid.

5. Mida kontrollid enne GPT või pistikprogrammi jagamist?

Vastus: Testid reaalsetel juhtudel ja piirjuhtudel, vastavus kasutuseeskirjadele, kirjelduse selgus, privaatsuspoliitika avalike tegevuste jaoks ja veendumine, et juhistes või failides ei peitu tundlikke andmeid.

Jagatud tööriist kohustab selle loojat: testi nii, nagu oleksid kasutajad juba kohal, ja migreeri oma GPT-d enne 11. detsembrit 2026.