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

Säti eesmärgid selgelt

Õppetund 6 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Eesmärgi selgus määrab tulemuse
  2. Ebamääraste eesmärkide lõks
  3. Tehnikad selgete eesmärkide sõnastamiseks
  4. Komplekssete eesmärkide struktureerimine
  5. Peamised punktid

Eesmärgi selgus määrab tulemuse

Tõhus prompt mudelile grok-build-0.1 ei seisne ainult tegevuse kirjeldamises, vaid selles, mida sa tegelikult saavutada soovid. Erinevus on peen, kuid fundamentaalne: „mida teha“ jätab mudeli sinu ootustega arvama, samas kui „oodatav tulemus“ annab talle täpse sihtmärgi.

Ebamääraste eesmärkide lõks

Vaatame näidet:

„Loo toidujälgija“

Mudel peab arvama: milline kasutajaliides? Millised funktsioonid? Kui detailselt tuleb toitumist jälgida? Millist tehnoloogiat kasutada? Ta loob küll midagi, kuid see on tema nägemus projektist, mitte sinu oma.

Nüüd aga selge eesmärgiga:

„Loo toidujälgija, mis näitab sisestatud toidu põhjal päevast kalorite jaotust toitainete kaupa. Soovin üldist ülevaadet ja kõrgtasemel trende.“

Mudel teab täpselt, mida sa ootad: toidu sisestamine, kalorite arvutamine, toitainete jaotus, päevavaade ja trendid. Ta suudab esimesest iteratsioonist alates asjakohase tulemuse luua.

Tehnikad selgete eesmärkide sõnastamiseks

Kirjelda lõpptulemust

Tegevuse kirjeldamise („lisa funktsioon“) asemel kirjelda, mida kasutaja näeb või mida kood teeb:

  • Ebamäärane: „Lisa lehtedeks jagamine“
  • Selge: „Kui nimekiri ületab 20 elementi, kuva allservas nupud „Eelmine“ ja „Järgmine“. Praegune leht peab olema esile tõstetud. URL peab kajastama aktiivset lehte parameetriga ?page=N”

Määra piirangud

Piirangud kõrvaldavad mitmetimõistetavuse:

  • „Lisamata uusi sõltuvusi“
  • „Säilitades tagasiühilduvuse API v1-ga“
  • „Vastamisaeg peab jääma alla 200 ms“
  • „Ühilduv Node.js 18+ versioonidega“

Too sisendi/väljundi näiteid

Andmete teisendamise või abifunktsiooniga töötamisel on üks näide väärt tuhat sõna:

„Loo funktsioon, mis teisendab slugi pealkirjaks. Näide: ‘my-blog-post’ → ‘My Blog Post’. Side sõnad (of, the, a) ei kirjutata suure tähega, välja arvatud siis, kui need asuvad esimesel kohal.“

Täpsusta, mida sa ei soovi

Mõnikord on selle ütlemine, mida sa ei taha, sama kasulik kui selle ütlemine, mida soovid:

„Refaktori komponent, et kasutada konksusid (hooks), kuid ära muuda avalikku liidest (rekvisiite/props). Olemasolevad testid peavad jätkama läbimist ilma muudatusteta.“

Komplekssete eesmärkide struktureerimine

Päringute puhul, mis hõlmavad mitut muudatust, struktureeri oma eesmärgid sammude või punktidena:

„Soovin autentimissüsteemi moderniseerida:

  1. Asenda küpsise-põhised sessioonid JWT-dega
  2. Lisa värskendustoken pöörlemisega (rotation)
  3. Jäta /logout marsruut funktsionaalseks
  4. Tokenid aeguvad 15 minuti pärast”

Iga punkt on mõõdetav eesmärk, mida mudel saab kontrollida.

Peamised punktid

  • Kirjelda oodatavat tulemust, mitte ainult tehtavat tegevust
  • Lisa piirangud mitmetimõistetavuse kõrvaldamiseks
  • Too sisendi/väljundi näiteid, kui see on asjakohane
  • Loetle, mida sa muuta ei soovi
  • Struktureeri komplekssed eesmärgid nummerdatud punktidena