Promptaustekniikat koodaukseen: system prompt, ajatusketju ja few-shot

Jatko-opas kokeneemmalle: system promptit, chain-of-thought, few-shot-esimerkit ja iteratiivinen ohjaus koodaukseen, valmiilla koodiesimerkeillä.

VVibekoodausPäivitetty 12.11.202610 min

Olet todennäköisesti huomannut saman asian kuin kaikki muutkin: välillä tekoäly tuottaa täydellistä koodia, välillä täyttä sotkua. Ero ei ole sattumaa. Se johtuu siitä, miten promptaat.

Etsitkö perusteita? Jos haluat tietää, mikä prompti on ja mitä promptaus tarkoittaa, aloita artikkelista Mikä on prompti? Selitys ja esimerkit. Tämä opas on jatko-osa kokeneemmalle ja käytännön tekniikkakirja. Jokainen tekniikka esitetään konkreettisella koodiesimerkillä, jonka voit kopioida ja soveltaa omaan projektiin.


Miksi tekniikoilla on väliä

Promptaus on tekoälylle annettavien ohjeiden suunnittelua ja muotoilua. Se ei ole yksi taito vaan kokoelma tekniikoita, joiden avulla ohjaat kielimallia tuottamaan tarkalleen sen, mitä tarvitset.

Ajattele sitä näin: koodaamisessa debuggaat koodia, promptauksessa debuggaat kommunikaatiota. Molemmat vaativat systemaattista lähestymistapaa.

Vibekoodauksessa promptaus on kaikki. Et kirjoita koodia - kirjoitat ohjeita, joista koodi syntyy. Promptauksen laatu määrittää suoraan sen, tuottaako Cursor tai Claude Code toimivan komponentin ensimmäisellä yrityksellä vai kymmenennellä.


Promptauksen perustekniikat

Nämä neljä tekniikkaa kattavat 90 % tilanteista, joihin törmäät vibekoodauksessa.

1. System prompt - aseta rooli ja konteksti

System prompt kertoo tekoälylle, kuka se on ja miten sen pitää toimia. Se on kuin työsopimus: määrittelet odotukset ennen kuin yksikään tehtävä alkaa.

Olet senior React-kehittäjä, joka noudattaa seuraavia periaatteita:
- TypeScript strict mode, ei any-tyyppejä
- Funktionaaliset komponentit ja hookit
- Tailwind CSS tyylitykseen, ei inline-tyylejä
- Virhetilanteet käsitellään aina Error Boundarylla
- Kommentit englanniksi, muuttujanimet kuvaavia

Tämä on tehokkain yksittäinen asia, jonka voit tehdä. Cursorissa tämä menee .cursorrules-tiedostoon, Claude Codessa CLAUDE.md-tiedostoon. Kerran kirjoitettuna se ohjaa jokaista vastausta.

2. Chain-of-thought - ajattele ääneen

Chain-of-thought (CoT) tarkoittaa, että pyydät tekoälyä purkamaan ongelman osiin ennen ratkaisua. Yksinkertaisimmillaan lisäät promptiin yhden lauseen.

Suunnittele autentikaatio Next.js 15 -sovellukseen.

Ajattele ensin vaihe vaiheelta:
1. Mitä autentikaatiotapoja on käytettävissä?
2. Mikä sopii parhaiten App Routerille?
3. Mitä tiedostoja tarvitaan?
4. Miten session hallitaan?

Toteuta sitten ratkaisu TypeScriptillä.

Ilman CoT-ohjausta tekoäly saattaa hypätä suoraan koodiin ja valita jonkin lähestymistavan satunnaisesti. Vaiheittainen ajattelu pakottaa sen perustelemaan valintansa - ja huomaamaan ongelmat ennen kuin ne päätyvät koodiin.

3. Few-shot - näytä esimerkillä

Few-shot-promptauksessa annat tekoälylle 1-3 esimerkkiä halutusta tuloksesta ennen varsinaista tehtävää. Tämä on ylivoimainen tekniikka silloin, kun haluat tietyn tyylin tai rakenteen.

Kirjoita React-komponentti samalla tyylillä kuin nämä esimerkit:

Esimerkki 1:
export function UserCard({ user }: { user: User }) {
  return (
    <div className="rounded-lg border p-4 shadow-sm">
      <h3 className="text-lg font-semibold">{user.name}</h3>
      <p className="text-muted-foreground">{user.email}</p>
    </div>
  );
}

Esimerkki 2:
export function ProjectCard({ project }: { project: Project }) {
  return (
    <div className="rounded-lg border p-4 shadow-sm">
      <h3 className="text-lg font-semibold">{project.title}</h3>
      <p className="text-muted-foreground">{project.description}</p>
    </div>
  );
}

Tehtävä: Kirjoita TeamCard-komponentti, joka näyttää tiimin nimen,
jäsenten määrän ja tiimin kuvauksen.

Tekoäly ymmärtää esimerkeistä rakenteen, nimeämiskäytännöt, Tailwind-luokat ja TypeScript-tyypit. Sinun ei tarvitse selittää näitä erikseen.

4. Iteratiivinen promptaus - tarkenna kierros kierrokselta

Harvoin paras tulos syntyy yhdellä promptilla. Iteratiivinen promptaus tarkoittaa, että aloitat laajasti ja tarkennat vaihe vaiheelta.

Kierros 1 - suunnittelu:

Suunnittele tietokantaskeema blogisovellukselle.
Taulut: käyttäjät, postaukset, kommentit, tagit.
Käytä PostgreSQL:ää ja Drizzle ORM:ää.
Älä kirjoita koodia vielä - listaa taulut, kentät ja relaatiot.

Kierros 2 - toteutus:

Hyvä suunnitelma. Toteuta nyt Drizzle-skeema TypeScriptillä.
Lisää created_at ja updated_at jokaiseen tauluun.
Käytä uuid:tä primary keynä.

Kierros 3 - viimeistely:

Lisää indeksit hakukenttiin ja Zod-validointiskeemat
insert- ja update-operaatioille.

Tämä on luonnollisin tapa työskennellä. Et yritä mahduttaa kaikkea yhteen jättipromptiin, vaan rakennat ratkaisua kerroksittain.


Koodauspromptien rakenne

Toimiva koodausprompt koostuu viidestä osasta. Kaikkia ei tarvita joka kerta, mutta mitä useampi on mukana, sitä parempi tulos.

OsaEsimerkki
Rooli"Olet TypeScript-kehittäjä"
Konteksti"Next.js 15, App Router, Tailwind v4"
Tehtävä"Luo lomakekomponentti käyttäjärekisteröintiin"
Rajoitteet"Käytä React Hook Formia ja Zodia"
Tuloksen muoto"Yksi tiedosto, exporttaa default-komponentti"

Käytännössä tämä näyttää tältä:

Konteksti: Next.js 15 App Router, TypeScript strict,
Tailwind CSS v4, React Hook Form + Zod.

Tehtävä: Luo käyttäjärekisteröintilomake, joka kerää
nimen, sähköpostin ja salasanan.

Rajoitteet:
- Client component
- Zod-validointi: salasana vähintään 8 merkkiä,
  sähköposti validi
- Näytä kenttäkohtaiset virheilmoitukset suomeksi
- Ei ulkoisia UI-kirjastoja, käytä Tailwindia

Tuloksen muoto: RegisterForm.tsx, yksi tiedosto

Edistyneet tekniikat

Kun perustekniikat ovat hallussa, näillä pääset seuraavalle tasolle.

Negatiivinen ohjaus - kerro mitä ET halua

Tekoälyllä on taipumus valita yleisimmät ratkaisut. Jos tiedät, mitä et halua, sano se suoraan.

Refaktoroi tämä komponentti.
ÄLÄ käytä useEffectiä datan hakemiseen - käytä server componenttia.
ÄLÄ lisää loading-tilaa clientiin - käytä Suspensea.
ÄLÄ asenna uusia riippuvuuksia.

Negatiivinen ohjaus on yllättävän tehokas tapa estää yleisimmät väärät ratkaisut.

Roolin vaihtaminen - pyydä arviota

Kun olet saanut koodin, pyydä tekoälyä arvioimaan se eri näkökulmasta.

Arvioi edellinen koodi tietoturva-asiantuntijana.
Onko SQL-injektioriskejä? Onko inputin validointi riittävä?
Listaa löydökset kriittisyysluokittain.

Rajoitettu konteksti - pidä fokus

Pitkissä keskusteluissa tekoälyn konteksti-ikkuna täyttyy ja vastausten laatu heikkenee. Aloita uusi keskustelu kun vaihdat aihetta. Ja viittaa tiedostoihin nimellä sen sijaan, että kopioit koodia promptiin - erityisesti Cursorissa ja Claude Codessa tämä toimii erinomaisesti, koska ne lukevat tiedostot suoraan projektistasi.

Kun keskustelu on venynyt ja aihe jatkuu, pyydä ensin yhteenveto ja aloita uusi keskustelu sillä:

Tiivistä mitä olemme tehneet tähän mennessä:
- Mitkä tiedostot olemme luoneet
- Mitkä päätökset olemme tehneet
- Mitä on vielä tekemättä

Merkki täyttyneestä kontekstista on se, että tekoäly alkaa unohtaa aiemmin sovittuja asioita tai kirjoittaa koodia, joka on ristiriidassa aiempien päätösten kanssa. Pysyvät säännöt kannattaa kirjoittaa projektin ohjetiedostoon, jonka työkalu lukee jokaisen keskustelun alussa: Claude Codessa CLAUDE.md.

Anna vain relevantti osa

Jokainen sana ja koodirivi, jonka annat tekoälylle, vie tokeneita. API-käytössä maksat niistä, ja pitkä syöte hidastaa vastausta. Tärkeämpää on, että olennainen ei huku: kielimallit huomioivat promptin alun ja lopun paremmin kuin keskikohdan.

Huono:

Tässä on koko tiedostoni (500 riviä). Korjaa virhe rivillä 247.

Hyvä:

Tämä funktio heittää virheen "Cannot read property 'map' of undefined"
kun data on tyhjä. Korjaa se lisäämällä null-tarkistus:

function UserList({ users }) {
  return users.map(u => <li>{u.name}</li>)
}

Pitkä tarina taustasta ei auta tekoälyä koodaamaan paremmin. Anna vaatimukset listana.

Ketjutus: pilko iso tehtävä osiin

Pyyntö "rakenna verkkokauppa autentikoinnilla, tuotelistalla, ostoskorilla, maksuilla ja admin-paneelilla" tuottaa yleensä sekavan kokonaisuuden. Ketjutuksessa iso tehtävä pilkotaan sarjaksi prompteja, joissa edellisen vastaus syötetään seuraavaan:

1. Suunnittele verkkokaupan arkkitehtuuri: sivut ja reitit,
   tietokantaskeema, API-reitit ja autentikointitapa.
   Käytä Next.js App Routeria ja Supabasea.
2. Luo Supabase-migraatio tälle skeemalle: [edellisen vastauksen skeema]
   Lisää RLS-policyt niin, että käyttäjä näkee vain omat tilauksensa.
3. Luo Next.js API-reitit tuotteille ja tilauksille tälle skeemalle.
   Lisää validointi Zodilla ja virheenkäsittely.
4. Luo tuotelistasivun komponentit: ProductCard, ProductGrid ja FilterBar.

Jokainen vaihe on niin pieni, että tekoäly pystyy tekemään sen hyvin, ja näet jokaisen välituloksen ennen seuraavaa.

Virheen kanssa anna konteksti, ei pelkkää virheilmoitusta

Virhe: "Hydration mismatch" React-komponentissa.

Komponentti: UserProfile
Ympäristö: Next.js 15, App Router, server component
Tilanne: Server-renderöinti näyttää "Loading...",
client-puolella näkyy oikea nimi.

Koodi:
[liitä komponentti]

Miksi tämä tapahtuu ja miten korjaan sen?

Satunnaisessa virheessä pyydä tekoälyä rajaamaan ongelma järjestelmällisesti: lisää lokitus jokaiseen vaiheeseen, tarkista tietokantayhteys ja ympäristömuuttujat ja testaa reunatapaukset. Lisää debuggauksesta: vibekoodaus ja debuggaus.

Pyydä tekoälyä kirjoittamaan prompti

Kun et tiedä, miten pyyntö kannattaa muotoilla, pyydä tekoälyä kirjoittamaan se: "Kirjoita minulle prompti, jolla saan tähän käyttötapaukseen sopivan React-komponentin." Vastauksesta näet, mitä tietoja tekoäly olisi tarvinnut.


Yleisimmät virheet

Nämä virheet toistuvat kerta toisensa jälkeen. Tunnista ne ja säästät tunteja.

1. Liian laaja prompti. "Tee sovellus joka tekee kaiken" tuottaa sotkua. Pilko tehtävä osiin: ensin tietokanta, sitten API, sitten UI.

2. Kontekstin puuttuminen. Jos et kerro tech stackia, tekoäly arvaa. Ja arvaus on usein väärä. "Tee nappi" voi tuottaa vanilla HTML:ää, Reactia tai Vue-komponenttia - riippuen mallin mielialasta.

3. Liian monta asiaa kerralla. Yksi prompti, yksi tehtävä. Jos pyydät "luo lomake, lisää validointi, kytke tietokantaan ja kirjoita testit", jokin menee pieleen. Iteratiivinen lähestymistapa toimii paremmin.

4. Korjaus ilman selitystä. "Tämä ei toimi, korjaa se" ei kerro tekoälylle mitään. Kerro mikä ei toimi: "Lomake ei näytä virheilmoituksia validoinnin epäonnistuessa - Zod-virheet eivät välity React Hook Formin errors-objektiin."

5. Koko koodipohjan syöttäminen. Tekoäly ei tarvitse kaikkea koodiasi - se tarvitsee relevantin kontekstin. Anna vain ne tiedostot, jotka liittyvät tehtävään.


Promptausvinkit vibekoodaukseen

Vibekoodauksessa promptaus on erilaista kuin ChatGPT:n kanssa jutustelu. Käytät erikoistuneita työkaluja, jotka lukevat koko projektisi ja muokkaavat tiedostoja suoraan. Tässä vinkit, jotka toimivat nimenomaan vibekoodauskontekstissa.

Käytä project-level prompteja. Cursorin .cursorrules ja Claude Coden CLAUDE.md ovat tehokkaimmat aseet. Kirjoita niihin projektin konventiot kerran, niin jokainen generoitu tiedosto noudattaa samaa tyyliä. Lue lisää CLAUDE.md:n kirjoittamisesta.

Viittaa tiedostoihin, älä kopioi. Sanomalla "katso src/components/Button.tsx ja tee vastaava" saat paremman tuloksen kuin kopioimalla koodin promptiin. Työkalu näkee tiedoston kokonaisuudessaan ja ymmärtää kontekstin.

Testaa heti. Generoi koodi, aja testit, ja anna virheilmoitus takaisin tekoälylle. Tämä feedback-loop on vibekoodauksen ydin. Mitä nopeammin saat palautteen, sitä parempi.

Aloita pienestä. Älä promptaa kokonaista sovellusta kerralla. Aloita yhdellä komponentilla, varmista että se toimii, ja laajenna siitä. Löydät lisää promptiesimerkkejä ja -pohjia valmiina käytettäväksi.

Tallenna toimivat promptit. Kun löydät promptin joka tuottaa erinomaista koodia, tallenna se. Ajan myötä sinulle kertyy promptikirjasto, joka nopeuttaa työtä merkittävästi.


Yhteenveto

Promptaus ei ole mystiikkaa. Se on käytännön taito, joka paranee harjoittelemalla. Neljä tekniikkaa - system promptit, chain-of-thought, few-shot ja iteratiivinen promptaus - kattavat valtaosan tilanteista.

Tärkeintä on aloittaa. Kokeile näitä tekniikoita seuraavassa projektissasi, seuraa mikä toimii ja mikä ei, ja rakenna omaa promptausosaamistasi askel kerrallaan.

Seuraavaksi: lue Mikä on prompti? jos haluat kertauksen perusteista, tai tutustu promptipohjiin valmiiden esimerkkien kautta.

Usein kysytyt kysymykset

Mitä promptaus tarkoittaa käytännössä?

Promptaus tarkoittaa tekoälylle annettavien ohjeiden suunnittelua ja muotoilua niin, että saat mahdollisimman tarkan ja hyödyllisen vastauksen. Se on systemaattinen taito, ei arvailua.

Mikä on paras promptaustekniikka koodaukseen?

Tehokkain yksittäinen tekniikka on kontekstin antaminen: kerro tech stack, tiedostorakenne ja haluttu lopputulos. Yhdistä tämä chain-of-thought-tekniikkaan, jossa pyydät tekoälyä ajattelemaan vaihe vaiheelta.

Miten opin promptaamaan paremmin?

Kokeile ja iteroi. Aloita yksinkertaisella promptilla, arvioi tulos ja tarkenna. Tallenna toimivat promptit ja käytä niitä pohjana. Vibekoodaustyökaluissa kuten Cursorissa ja Claude Codessa oppii nopeimmin.

Pitääkö promptata englanniksi vai suomeksi?

Molemmat toimivat. Nykyiset kielimallit ymmärtävät suomea hyvin. Koodauksessa on kätevää käyttää englantia teknisille termeille ja suomea ohjeistukselle - mutta puhtaasti suomenkieliset promptit tuottavat yhtä laadukasta koodia.

Promptaustekniikat koodaukseen: system prompt, ajatusketju ja few-shot