Määritä tavoitteet selkeästi
Tällä sivulla
Tavoitteen selkeys määrittää lopputuloksen
Tehokas kehotus grok-build-0.1:lle ei ole pelkkä tehtävän kuvaus, vaan se kertoo, mitä haluat saavuttaa. Ero on hienovarainen mutta perustavanlaatuinen: pelkkä “mitä tehtävä” jättää mallin arvailemaan odotuksiasi, kun taas “odotettu tulos” antaa sille tarkan maalin.
Epämääräisten tavoitteiden ansa
Tässä esimerkki:
“Luo ruokaseuranta”
Mallin on arvattava: millainen käyttöliittymä? Mitkä ominaisuudet? Kuinka yksityiskohtainen seurannan tulee olla? Mikä teknologia? Se tuottaa jotain, mutta se on sen oma näkemys projektista, ei sinun.
Nyt selkeällä tavoitteella:
“Luo ruokaseuranta, joka näyttää päivittäisen kalorijakauman ravintoaineittain, kun syötän ruoan. Haluan yleiskatsauksen ja korkean tason trendit.”
Malli tietää tarkalleen, mitä odotat: ruoan syöttö, kalorilaskenta, ravintoainejakauma, päivänäkymä ja trendit. Se pystyy tuottamaan osuvan tuloksen jo ensimmäisellä iteroinnilla.
Tekniikat selkeiden tavoitteiden muotoiluun
Kuvaile lopputulos
Älä kuvaile toimintoa (“lisää ominaisuus”), vaan kuvaile, mitä käyttäjä näkee tai mitä koodi tekee:
- Epämääräinen: “Lisää sivutus”
- Selkeä: “Kun lista ylittää 20 kohdetta, näytä Edellinen/Seuraava-painikkeet alareunassa. Nykyinen sivu on korostettava. URL-osoitteen on heijastettava aktiivinen sivu muodossa ?page=N”
Määritä rajoitteet
Rajoitteet poistavat epäselvyydet:
- “Ilman uusien riippuvuuksien lisäämistä”
- “Yhteensopivuus API v1:n kanssa säilytettävä”
- “Vasteajan on pysyttävä alle 200 ms”
- “Yhteensopiva Node.js 18+:n kanssa”
Anna syöte- ja tulosteesimerkkejä
Kun työskentelet datan muunnoksen tai apuohjelman parissa, esimerkki kertoo enemmän kuin tuhat sanaa:
“Luo funktio, joka muuntaa slug-merkkijonon otsikoksi. Esimerkki: ‘my-blog-post’ → ‘My Blog Post’. Side sanat (of, the, a) eivät ole isoja alkukirjaimia, ellei ne ole ensimmäisessä paikassa.”
Määritä, mitä et halua
Joskus sen sanominen, mitä et halua, on yhtä hyödyllistä kuin sen sanominen, mitä haluat:
“Refaktoroi komponentti käyttämään hookseja, mutta älä muuta julkista rajapintaa (propseja). Olemassa olevien testien on jatkettava läpäisyä ilman muutoksia.”
Monimutkaisten tavoitteiden jäsentäminen
Kun pyyntö sisältää useita muutoksia, jäsennä tavoitteesi vaiheittain tai luettelona:
“Haluan modernisoida tunnistautumisjärjestelmän:
- Korvaa evästeistunnot JWT-tunnuksilla
- Lisää päivitystunnus (refresh token) kierrätyksellä
- Pidä /logout-reitti toiminnassa
- Tunnukset vanhenevat 15 minuutin kuluttua”
Jokainen kohta on mitattava tavoite, jonka malli voi varmistaa.
Keskeiset asiat
- Kuvaile odotettu tulos, äläkä vain suoritettavaa toimintoa
- Lisää rajoitteita epäselvyyksien poistamiseksi
- Anna syöte- ja tulosteesimerkkejä, kun se on aiheellista
- Listaa asiat, joita et halua muuttaa
- Jäsennä monimutkaiset tavoitteet numeroituina kohtina