Korduvkasutatavate promptide teegi loomine: tekstikatketest jagatud mallideni

Kui kasutad AI-d korduvas töös, võid märgata, et kirjutad aina sama liiki prompte: viisakas, kuid kindel keeldumiskiri, dokumendi ülevaatus, struktureeritud otsustustugi või pildiloome lähteülesanne. Struktuuri iga kord uuesti kirjutades muudad ka juhiseid, mistõttu on tulemusi raskem võrrelda.

Üks praktiline lahendus on prompt-teek: väike, hoolikalt valitud mallide kogum, mida saad üles leida, testida ja täiendada. Vaatame, kuidas sellist teeki ehitada, mida talletada, kuidas seda korrastada ja kuidas valida sobiv salvestuskoht.

Jagatud prompt-teek ei ole hunnik tekstikatkeid. Igal korduvkasutataval promptil peab olema kasutusjuhtum, omanik, versioon, näited, piirid ja ülevaatuse kuupäev. Muidu muutub teek aegunud nõuandeks ilusa pealkirjaga.

Miks teek, mitte “nutikamad promptid”

Edasijõudnud promptimisest lugedes tekib kiusatus koguda aina nutikamaid tehnikaid. Korduva töövoo puhul tasub hoopis testida hüpoteesi, et püsiv mall vähendab välditavat varieeruvust. Võrdle seda esinduslike juhtumite peal oma praeguse töövõttega, mitte ära eelda, et korduskasutus iseenesest tulemust parandab.

Kolm konkreetset kasu teegist:

Vähendad korduvat ettevalmistust. Ülesande struktuur ja täiteviisid on juba olemas, kuigi igal kasutuskorral tuleb lisada õiged sisendid ja teha ülevaatus.

Muudatused muutuvad testitavaks. Uuendatud malli saab enne eelmise versiooni asendamist käitada samadel juhtumitel ja samade vastuvõtukriteeriumidega.

Tiim saab jagada lähtepunkti. Inimesed saavad kasutada sama heakskiidetud versiooni, selle asemel et seda vestlusajaloost uuesti kokku panna.

Tiimide jaoks on neljas kasu: kvaliteet muutub ülevaadatavaks. Kellegi vestlusajaloos olevat prompti ei saa tiim üle vaadata, versioonida ega parandada. Teegis olevat prompti saab.

Mis kuulub teeki

Kasulikul prompt-teegil on kolm kihti. Ehitame iga kihi eraldi üles.

1. kiht: sagedasti kasutatavad mallid

Alusta korduvatest promptidest, mille tulemused on piisavalt olulised, et neid testida. Iga kirje peaks olema terviklik täiteviisidega mall koos märkega, kuidas seda hinnati.

Võimalikud kandidaadid on järgmised.

Struktureeritud kirjamustand.

Kirjuta kiri minu häälega. Kontekst: {{olukord}}. Adressaat: {{saaja ja tema eelistused}}. Eesmärk: {{mida ma tahan, et juhtuks}}. Piirangud: alla {{N}} sõna, lõpeta konkreetse järgmise sammuga, ilma “loodan, et leiate selle kirja heas tujus.” Tee kolm versiooni: lühike, keskmine, pikem. Märgista iga.

Kolme käiguga dokumendiülevaataja.

Vaata dokument, mida ma kohe jagan, üle kolmes käigus:

1. käik — esimene mulje. Mis dokument see on, millised on selle kolm peamist sõnumit, milline on üldine struktuur? 2. käik — riskid ja punased lipud. Millised punktid/lõigud võivad mulle kahju teha? Tsiteeri iga, selgita riski lihtsas keeles. 3. käik — otsused ja tegevused. Mida ma pean otsustama, küsima või tegema? Loetle, lisades tähtajad, kui need on välja toodud.

Märgi ebakindlus [ebaselge]. Kontekstiks minu kohta: {{sinu roll ja huvi}}.

Otsuse sparringukaaslane.

Otsustan {{otsus}}. Enne kui midagi ütled, küsi ainult küsimused, mida on vaja valikute, piirangute, edukriteeriumide ja minu suurima võimaliku kahetsuse täpsustamiseks. Oota vastuseid. Seejärel loetle iga valiku tugevaimad argumendid, valikud, mis võisid mul märkamata jääda, kõige olulisem mõõde ja minu nõrgim eeldus. Mängi minu eelistuse vastu kuradi advokaati. Lõpuks anna tingimuslik soovitus ja nimeta tõendid, mis seda muudaksid; ära käsitle mudeli enda kindlushinnangut kalibreeritud tõendina.

Struktureeritud analüsaator.

Analüüsi {{asja}} selle struktuuriga:

Mis see on (üks lõik) Kolm kõige olulisemat omadust (igale tõendid) Kus see on tugev (kuhu ma seda kasutaks) Kus see on nõrk (kuhu ma seda ei kasutaks) Sagedased vead selle kasutamisel Kaks tõeliselt sisukat tähelepanekut, mida juhuslik lugeja ei märkaks

Ole konkreetne. Ei mingeid üldsõnalisi ühisfraase.

Häält jälgiv ümberkirjutaja.

Kirjuta see mustand minu häälele vastavaks ümber, kus hääl on defineeritud nende näidetega: {{näide 1}} {{näide 2}} {{näide 3}}

Toimeta kirurgiliselt — säilita struktuur, muuda ainult seda, mis häälega ei sobi. Tsiteeri iga muudatust ja selgita ühe lühilausega, miks.

Ehita ainult need kirjed, mida sinu enda korduv töö õigustab. Konkreetne komplekt erineb inseneril, turundajal ja juristil. Ühine muster on selgete täiteviiside ja sõnaselge ülevaatuspiiriga testitud mall.

2. kiht: valdkonnapõhised raamistused

Mõned tööliigid vajavad omi raamistusi, mis erinevad üldistest mallidest. Näiteid:

Kliendiintervjuu süntees.

Eralda selle kliendiintervjuu transkriptist:

1. Kliendi täpsed sõnad valupunktide kohta (otseseid tsitaate koos ajatemplitega)
2. Funktsioonid või parandused, mida ta mainis soovivat, järjestatuna intensiivsuse järgi
3. Toode, mida ta täna kasutab, ja mida ta seal armastab/vihkab
4. Mistahes täitumata vajadused, mida ta vihjas, kuid otse välja ei öelnud
5. Kuidas ta kirjeldab iseennast ja oma tööd — täpseid fraase

Tsiteeri klienti igal võimalusel. Märgi kõik järeldatud kohad [minu tõlgendus]. Ole konkreetne.

Tehnilise spetsifikatsiooni genereerimine.

Selle funktsioonikirjelduse põhjal koosta tehniline spetsifikatsioon meie tiimi vormingus:

1. Probleemipüstitus (kasutaja valu, tema sõnadega)
2. Pakutud lahendus (üldjoontes)
3. Detailsed kasutusvood (õnnelik tee + 2–3 äärejuhtu)
4. Reguleerimisalast väljas (selgesõnalised mitte-eesmärgid)
5. Lahtised küsimused (asjad, mis vajavad enne arendust otsustamist)
6. Riskid (inseneri-, toote-, äri-)
7. Edu mõõdikud (mille järgi me teame, et see töötas)

Toon: otsekohene, ilma kõhklemiseta. Tsiteeri mind, kus mu sõnad hästi istusid. Märgi kohad, kuhu pidid detailid ise välja mõtlema, [kinnita].

Koodiülevaatuse abimees.

Vaata allolev kood üle. Järjekorras:

1. Vead — kood, mis annab vale tulemuse. Tsiteeri ja selgita.
2. Turvaprobleemid — kõik, mis avab ründepinda. Tsiteeri ja selgita.
3. Jõudlusmured — kõik, mis tõenäoliselt mastaabis aeglane on, koos suurusjärgu hinnanguga.
4. Hooldatavus — kõik, mis ajab järgmise lugeja segadusse.
5. Stiilinurad — märgi ainult siis, kui hoolikale ülevaatajale läheks see korda; jäta norimine vahele.

Ära kirjuta ümber. Viita reanumbritele. Lõpeta üksiku kõige olulisema parandusega.

Iga selline on kalibreeritud ühele tööliigile. Ehita 2. kihi mall iga sinu töövoos korduva ülesande liigi jaoks.

3. kiht: kaasatav võrdlusmaterjal

Mõned promptid vajavad lisaks juhistele tugifaile. Sinu teek peaks sisaldama:

• Brändihääle näiteid. Esinduslik lühitekstide kogum, mis tabab soovitud hääle.
• Stiilijuhendeid. Sinu ettevõtte toimetamisstandardid, sinu tiimi koodistiil, sinu disainitokenid.
• Valdkonna sõnastikke. Sisemine terminoloogia, koodnimed, lühendid, mida mudel muidu valesti tõlgendaks.
• Malle. Tegelikud mallistruktuurid, mille mudel täidaks.
• Antinäiteid. Asju, mida vältida — üldsõnalisi, brändist mööda, halvasti struktureeritud näiteid, mis näitavad mudelile, mida mitte toota.

Nende salvestamine promptide kõrval tähendab, et iga malli kasutaja saab vajaduse korral ka õiged tugimaterjalid kaasa võtta.

Kus teeki hoida

Vali salvestuskoht vajalike kontrollide ja töövoo, mitte üldise paremusjärjestuse järgi. Võrdle järgmisi mõõtmeid.

Ligipääs ja õigused. Kes võib kirjet lugeda, käitada, muuta, heaks kiita ja kasutuselt kõrvaldada?

Leidmise ja talletamise hõõrdumine. Kas inimesed leiavad heakskiidetud versiooni töö tegemise ajal ning saavad kandidaadi talletada ilma konteksti kaotamata?

Versioonimine ja ülevaatus. Kas saad muudatusi võrrelda, ajalugu säilitada, heakskiitu nõuda ja eelmise versiooni taastada?

Hindamis- ja kasutustõendid. Kas saad siduda testjuhtumid ja tulemused ning eristada tegelikku kasutust kirjest, mis lihtsalt olemas on?

Auditeeritavus. Kas saad tuvastada omaniku, aktiivse versiooni, seadistuse, heakskiidu ja kasutuspiiri?

Kulu ja teisaldatavus. Millised on tellimuse, juurutuse, migratsiooni ja teenusepakkujast sõltuvuse kulud?

Eri salvestusmustrid võivad täita nende nõuete erinevaid kombinatsioone.

Kerge ja isiklik salvestus

Tekstilaiendustööriistad, näiteks Raycasti katked, Espanso või TextExpander. Üksikkasutajal võib leidmine olla kiire, kuid õiguste, hindamistulemuste ja muudatuste ülevaatuse jaoks võib vaja minna eraldi süsteemi.

Dokumendi- või teadmustööriistad, näiteks Apple Notes, Notion, Obsidian või Confluence. Neis saab hoida prompte, juhiseid ja näiteid koos. Kontrolli, kas õigused, versiooniajalugu, heakskiidud ja ekspordivõimalused vastavad sinu vajadustele.

Hallatud ja tiimipõhine salvestus

Struktureeritud tekstifailidega git-repositoorium. See võib pakkuda diffe, kollegiaalset ülevaatust, omandireegleid ja taastamist. Kõige paremini toimib see siis, kui kasutajad tunnevad repositooriumi töövoogu või eraldi kasutajaliides hoolitseb leidmise eest.

Promptide haldus- ja jälgitavustööriistad. PromptHubi, Langfuse’i või Helicone’i taolised tooted võivad siduda promptide versioonid juurutuste, hindamiste ja kasutusandmetega. Kontrolli toote praeguseid funktsioone, andmete liikumist, õigusi ja hinnastust oma nõuete järgi. Näiteks Langfuse’i promptide halduse dokumentatsioon kirjeldab versioonitud prompte ja juurutusmärgiseid.

Salvestatud assistendid hallatud tööruumides. Custom GPT-d ja Claude Projects võivad pakkida juhised ning viitematerjali vestlusliidese taha. ChatGPT Team nimetati 2025. aastal ümber ChatGPT Businessiks; Businessi ja Enterprise’i tööruumides saab GPT-sid jagada tööruumi kontrollide piires. Claude Teami ja Enterprise’i projekte saab Claude’i Projectsi dokumentatsiooni järgi jagada konkreetsete liikmete või kogu organisatsiooniga ning määrata projektipõhiseid õigusi. Enne sisematerjali lisamist kontrolli kehtivaid jagamis-, säilitamis-, andmekasutus- ja ekspordireegleid.

Võid mustreid kombineerida, kuid määra üks autoriteetne versioon, et mugav koopia ei hakkaks ülevaadatud kirjest märkamatult erinema.

Versioonimine on oluline

Versioonimata teeki võivad koguneda vastuolud ja katkised mallid. Versiooni prompte nii, et kasutajad saaksid tuvastada aktiivse kirje, muudatused üle vaadata ja vajaduse korral eelmise versiooni taastada.

Talleta vähemalt järgmine:

• Identiteet, omanik ja leping: kirje nimi, versioon, omanik, heakskiidetud kasutusjuhtum, vajaduse korral kinnitaja, mall, nõutud sisendid, oodatud väljund ja inimülevaatuse reegel.
• Viimati testitud seadistus: teenusepakkuja, täpne mudel või mudelitõmmis, kui see on saadaval, asjakohased süsteemi- või arendajajuhised, tööriistad, otsinguallikad ning arutlus- või genereerimisseaded.
• Hindamistõendid ja piirid: viimase testi kuupäev, esinduslikud juhtumid, vastuvõtukriteeriumid, tulemused, olulised tõrked, keelatud kasutused, tundlike andmete piir, teadaolevad tõrkerežiimid ja tingimused, mis nõuavad kvalifitseeritud ülevaatust.
• Varuplaan ja muudatuste ajalugu: mida teha puuduvate sisendite, ebaõnnestunud kontrolli või kättesaamatu heakskiidetud seadistuse korral; mis muutus, miks, kes selle heaks kiitis ja millised testid uuesti tehti.

Kasulik muster: kui teed malli juures sisulise muudatuse, salvesta vana versioon arhiivi ja lase uuel selle koha üle võtta. Saad alati tagasi vaadata ja meenutada, miks muudatuse tegid.

Tiimi prompt-teekides suuna olulised muudatused töövoo riskile vastavasse ülevaatusse. Kollegiaalne ülevaatus võib vigu tabada, kuid ei asenda hindamist ega kvalifitseeritud heakskiitu seal, kus see on nõutud.

Mida lisaks promptile endale talletada

Pelk prompt-mall ilma kontekstita ei tee imet. Kasulikus teegikirjes on:

1. Prompt ise, koos {{täiteviisidega}}.
2. Mõeldud kasutusjuhtum — üks lause, mis kirjeldab, millal selle poole pöörduda.
3. Töötatud näide — selgelt sünteetilisena märgistatud, välja arvatud juhul, kui see pärineb heakskiidetud ja dokumenteeritud juhtumist.
4. Teadaolevad piirid — mida see mall halvasti teeb, mille peale tähelepanu pöörata.
5. Testitud seadistus — mudel, asjakohased seaded ja tööriistad, testi kuupäev ning võrdluse lähtevariant.
6. Autor ja viimati muudetud — kes ehitas, millal ja miks viimane muudatus tehti.
7. Ülevaatusreegel — millist inimülevaatuse tüüpi on vaja enne, kui väljundit kasutatakse.
8. Tõrkerežiim — kuidas see mall tavaliselt viltu läheb.

See lisab hooldustööd. Seda, kas töö end ära tasub, tuleks mõõta praeguse töövoo suhtes: kulunud aeg, tõrgete sagedus, ülevaatuskoormus ja auditeeritava versiooni väärtus.

Selle artikliga kaasnev eestikeelne mall annab lähtekuju. Enne kui käsitled kirjet tootmiskõlbulikuna, täienda seda eespool kirjeldatud viimati testitud mudeli ja seadistuse, hindamistõendite, piiride ning varuplaani väljadega.

Hoolduse distsipliin

Teek vajab selgeid hoolduspäästikuid.

Muudatusest käivituv ülevaatus. Tee asjakohane hindamine uuesti, kui muutub prompt, mudel, süsteemijuhis, tööriist, otsinguallikas, väljundileping või põhimõte. Ära kanna „testitud“ märgist üle sisuliselt erinevale seadistusele.

Riskist käivituv ülevaatus. Vaata kirje üle, kui see liigub tagajärjerikkamasse kasutusse, saab ligipääsu tundlikele andmetele või toimingutele või tekitab olulise mõjuga tõrke. Lisa kvalifitseeritud ülevaatus ja valideeritud kontrollid seal, kus valdkond seda nõuab.

Kasutusest käivituv ülevaatus. Uuri kirjeid, millel esineb korduvaid tõrkeid, möödakirjutusi, vähest kasutust või ootamatut kulu. Vähene kasutus võib viidata halvale leitavusele, nõrgale mallile või ülesandele, mis ei vaja jagatud prompti; kasutusandmed üksi ei näita, milline selgitus on õige.

Talleta koos tõenditega. Salvesta paljulubav prompt kandidaadina ja testi seda enne heakskiidetuks märkimist. Säilita sisend ja väljund ainult siis, kui põhimõtted seda lubavad, ning eemalda tundlik materjal.

Koonda tahtlikult dubleeritud kirjed. Kui mitu kirjet on mõeldud sama ülesande jaoks, võrdle neid enne kanoonilise versiooni valimist samadel juhtumitel. Hoia eraldi variante siis, kui need teenivad dokumenteeritud kontekste või põhimõtteid.

Töötatud näide: ühe teegikirje ehitamine

Et see konkreetseks muuta, vaatame sünteetilist kirjet. See näitlikustab skeemi, kuid ei tõenda, et mall töötab päris kliendi, saaja või organisatsiooni puhul.

Nimi: Kolme versiooni kirjamustandaja

Kasutusjuhtum: Mistahes kirja koostamine, kus adressaat, toon või pikkus pole veel paigas ja ma tahan valikuid.

Versioon: v0.3 (näitlik kandidaat)

Kandidaatseadistus: organisatsiooni heakskiidetud vestlusmudel ja tööruum. Võrdle tavaseadistust suurema arutlusega alternatiiviga ainult siis, kui hindamine näitab asjakohast võitu.

Viimati testitud: pole veel testitud. Enne heakskiitu kasuta esinduslikke sünteetilisi või lubatud kirju, mis katavad selge palve, tundliku piiri, puuduva konteksti ja pika kirjavahetuse.

Mall:

Kirjuta kiri minu häälega.

Kontekst: {{olukord, sh varasem lõim, kui on}}

Adressaat: {{kes on saaja — nimi, roll, meie suhe, tema suhtluseelistused, kui teada}}

Eesmärk: {{mida ma tahan, et selle kirja tulemusena juhtuks}}

Piirangud:
- Alla {{N}} sõna
- Lõpeta selge järgmise sammuga
- Ilma "loodan, et leiate selle kirja heas tujus", "tahtsin teiega ühendust võtta" või "andke teada, kui teil on küsimusi"
- {{muud konkreetsed piirangud}}

Tee kolm versiooni, märgistatud:

1. **Lühike ja otsekohene** ({{N1}} sõna)
2. **Soe ja tavapärane** ({{N2}} sõna)
3. **Pikem ja detailsem** ({{N3}} sõna)

Iga versiooni alla anna üks lühike märkus: "saada see, kui..."

Kontrollimist vajavad kandidaadi piirid:

• Pikad lõimed võivad sisaldada ebaolulist, vastuolulist või tundlikku ajalugu; lisa ainult ülesandeks vajalik minimaalne heakskiidetud kontekst ja kontrolli, et ükski vajalik kohustus ei jäänud välja.
• Kolm versiooni ei pruugi sisuliselt erineda; määra mitmekesisuse kriteeriumid või küsi vähem variante, kui testimine näitab kordusi.
• Märkus „saada see, kui…“ võib anda üldsõnalist nõu; eemalda see, kui märkus hindamist ei läbi.

Näitlik muudatuste logi:

• v3: lisatud keelatud alustused; enne heakskiitu tee tooni ja juhiste järgimise testid uuesti.
• v2: lisatud märkus „saada see, kui…“; kontrolli, et märkus oleks konkreetne ja ohutu.
• v1: algne kandidaat.

Kui kirje on hindamise ja heakskiidutee läbinud, saab kasutaja ülevaadatud versiooni avada, täiteviisid täita ja luua inimülevaatuseks kirjamustandi kandidaadi.

Tiimi vaatenurk

Tiimiteegi puhul tuleb arvestada veel mõne asjaoluga:

Jagatud sõnavara. Veendu, et mallid on kirjutatud tiimile, mitte konkreetselt sulle. Asenda “minu hääl” “[brändinime] häälega”; dokumenteeri, mis see hääl on.

Sissejuhatamine. Näita uutele kasutajatele, kuidas leida autoriteetne versioon, mõista selle kasutuspiiri, esitada heakskiidetud sisendeid ja tõrgetest teatada. Eelista nende tööga seotud kirjeid, mitte kindlat arvu malle.

Omanikud. Igal heakskiidetud mallil peab olema omanik, kes vastutab ülevaatuspäästikute, tõendite ja kasutuselt kõrvaldamise otsuse eest.

Heakskiidu töövoog. Kohanda heakskiit tõrke tagajärgedega. Kliendile suunatud, regulatiivsed, õiguslikud, finants-, meditsiini- või ohutusega seotud töövood võivad enne muudatuste avaldamist nõuda autoriteetseid allikaid, kvalifitseeritud ülevaatust, valideeritud kontrolle ja säilitatud tõendeid.

Väike harjumus, mis liitub

Vaata teek üle enda määratud päästikute järgi. Talleta paljulubavad promptid kandidaatidena, lisa lubatud tõendid ja võrdle neid enne edutamist praeguse versiooniga. Talleta ka tõrked, et valik ei põhineks ainult meelde jäänud näidetel.

Eesmärk on teek, mille aktiivsetel kirjetel on omanikud, praegused seadistused, esinduslikud hindamised ja selged varuplaanid. Kõrvalda kasutuselt kirjed, mille väärtus ei õigusta enam hoolduskulu.

Eelista väikest testitud teeki ülevaatamata kogumikule

Prompt-teegist võib kasu olla siis, kui korduvad ülesanded õigustavad selle hooldamist. Alusta mallidest, mida juba korduvalt kirjutad, ning mõõda, kas korduskasutus parandab järjepidevust, ülevaatuskoormust, ülesande edukust või kulu.

Talleta iga kandidaat koos täiteviiside, kasutusjuhtumi, testitud seadistuse, tõendite, teadaolevate piiride, ülevaatuspäästikute ja varuplaaniga. Hoia alles ainult kirjed, mis jäävad nende kontrollide all kasulikuks.