Ammattimaiset kirjoitustyylit
Journalistinen, vakuuttava, ohjeistava ja tekninen kirjoitustapa.
Ammattimaiset kirjoitustyylit on ilmainen Tekoälyn prompt engineering-oppitunti CoddyKitissä. Tämä on oppitunti 3/4. Voit lukea tästä oppimispolusta kokonaan mitkä tahansa 3 oppituntia ilmaiseksi — sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä käytännön harjoittelun sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Oppitunti kuuluu Tekoälyn prompt engineering-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. Tekoälyn prompt engineering-kurssilla on yhteensä 4 oppituntia.
Ajattelua jäsentävät tyylit
Ammattimaisessa kirjoittamisessa ei ole kyse vain sävystä – myös rakenne ja tarkoitus ovat olennaisia. Eri ammattialoille on kehittynyt omaleimaisia kirjoitustyylejä, joista kukin palvelee tiettyä viestintätavoitetta.
Kun tunnette nämä tyylit ja osaatte pyytää niitä, käytettävissänne on kokoelma hyväksi havaittuja kirjoitusmalleja: journalistinen, vakuuttava, opastava ja tekninen.
Journalistinen tyyli: käänteinen pyramidi
Journalistisessa tyylissä käytetään käänteistä pyramidia: tärkeimmät tiedot ensin, niitä tukevat yksityiskohdat seuraavaksi ja taustatiedot viimeisenä.
Ominaispiirteet:
- Aloitusvirke vastaa kysymyksiin kuka, mitä, milloin, missä ja miksi
- Jokainen kappale toimii itsenäisesti
- Ei alustusta – siirtykää heti asiaan
- Lyhyet virkkeet ja kappaleet
- Ei johtopäätöksiä – juttu puhuu puolestaan
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=200,
messages=[{
'role': 'user',
'content': (
'Write in journalistic inverted-pyramid style. '
'Lead immediately with the most important fact. '
'No setup, no preamble. Short sentences, short paragraphs. '
'Max 100 words.\n\n'
'Announce: Anthropic has released Claude 4, achieving a new benchmark score of 94% '
'on a standard reasoning test, surpassing previous models by 8 percentage points. '
'Available via API today. Pricing unchanged.'
)
}]
)
print(response.content[0].text)Journalistinen tyyli liiketoimintasisällössä
Käänteinen pyramidi toimii muussakin kuin uutisissa. Käyttäkää journalistista tyyliä seuraavissa:
- Sisäiset muistiot, joiden ensimmäisen kappaleen johtajat silmäilevät
- Tuotteen julkaisutiedotteet, joita kiireiset insinöörit lukevat
- Johtotason katsaukset, joissa aika on erittäin rajallinen
- Sähköpostien aiherivit ja aloituslauseet
Pyytäkää esimerkiksi: ”Kirjoittakaa tämä journalistiseen tyyliin – tärkein fakta ensimmäiseen virkkeeseen ja muu sen tueksi.”
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Write an internal engineering memo using journalistic style. '
'Most critical information in sentence 1. Max 3 short paragraphs.\n\n'
'Facts: We will have a 30-minute planned downtime on Saturday, March 15 at 2 AM UTC. '
'Cause: database migration to PostgreSQL 16. '
'Impact: all API endpoints unavailable. '
'Action needed: engineers should not deploy during this window. '
'Status page will show updates.'
)
}]
)
print(response.choices[0].message.content)Vakuuttava tyyli: ongelma–ratkaisu
Vakuuttava kirjoittaminen noudattaa selkeää rakennetta: ensin määritetään ongelma, sitten esitetään ratkaisu vastauksena siihen. Tätä kutsutaan myös PAS-malliksi:
- P – Ongelma — tuokaa esiin lukijan kokema kipukohta
- A – Kärjistäminen — syventäkää ongelman herättämää tunnevaikutusta
- S – Ratkaisu — esittäkää tarjouksenne ongelman ratkaisuna
Käyttäkää tätä myyntiteksteissä, ehdotuksissa, pitch-esityksissä, apurahahakemuksissa ja muutosjohtamisen muistioissa.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=250,
messages=[{
'role': 'user',
'content': (
'Write landing page copy using the Problem-Agitate-Solution (PAS) persuasive framework.\n'
'Structure:\n'
'- Paragraph 1 (Problem): name the pain clearly\n'
'- Paragraph 2 (Agitate): make the reader feel how serious this problem is\n'
'- Paragraph 3 (Solution): introduce the product as the answer\n'
'Product: A tool that automatically generates commit messages from git diffs.\n'
'Audience: developers who write bad or no commit messages under time pressure.\n'
'Max 150 words total.'
)
}]
)
print(response.content[0].text)Suostutteleva tyyli: AIDA-viitekehys
AIDA-viitekehys on toinen markkinoinnissa laajasti käytetty suostutteleva rakenne:
- Attention (huomio) — kiinnittäkää lukijan huomio heti
- Interest (kiinnostus) — herättäkää uteliaisuus ja osoittakaa asian merkitys
- Desire (halu) — herättäkää ratkaisua kohtaan tunneperäinen tarve
- Action (toiminta) — selkeä CTA (toimintakehotus)
Pyyntö: 'Kirjoittakaa tämä AIDA-viitekehystä käyttäen: Attention, Interest, Desire, Action.'
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Write a cold email using the AIDA framework. '
'Label each section: [ATTENTION], [INTEREST], [DESIRE], [ACTION].\n'
'Product: AI-powered code review tool that catches security bugs.\n'
'Audience: CTO at a 50-150 person software company.\n'
'Length: max 150 words. Tone: direct, professional, no hype.'
)
}]
)
print(response.choices[0].message.content)Ohjeistava tyyli: vaiheittain
Ohjeistava teksti opastaa lukijaa prosessin läpi. Siinä painotetaan seuraavia asioita:
- Numeroidut vaiheet — jokainen toiminto erotellaan selkeästi
- Käskymuotoiset verbit — 'Napsauttakaa', 'Syöttäkää', 'Valitkaa', 'Suorittakaa'
- Yksi toiminto vaihetta kohden — ei useita toimintoja sisältäviä vaiheita
- Selkeät ennakkoedellytykset — mitä lukija tarvitsee ennen aloittamista
- Varmistusvaiheet — miten varmistetaan kunkin vaiheen onnistuminen
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{
'role': 'user',
'content': (
'Write step-by-step instructional documentation for setting up a Python virtual environment.\n'
'Style rules:\n'
'- Begin with Prerequisites (1-3 items)\n'
'- Number every step\n'
'- Start each step with an imperative verb\n'
'- Maximum one action per step\n'
'- Include the exact command to run in a bash code block where applicable\n'
'- Add a verification command after every 2-3 steps\n'
'Audience: first-year developer who knows Python basics but never used a terminal.'
)
}]
)
print(response.content[0].text)Ohjeistava tyyli: how-to-artikkelit
How-to-artikkelit ovat verkkosisällöissä käytettävä ohjeistavan tekstin erityismuoto. Niissä noudatetaan seuraavaa rakennetta:
- Huomionherättäjä — miksi tämä on tärkeää 1–2 lauseella
- Mitä lukija oppii (lyhyesti)
- Ennakkoedellytykset
- Vaiheet (numeroidut ja selkeät)
- Tulos — mitä lukijalla on suorituksen jälkeen
- Seuraavat vaiheet tai lisälukemista
Pyytäkää jokainen osio erikseen, jotta rakenne muodostuu oikein.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Write a how-to article outline (headings + 1-sentence descriptions only) '
'for "How to Set Up GitHub Actions for Python Testing".\n'
'Include exactly:\n'
'- 1 hook sentence\n'
'- What You Will Learn section (3 bullets)\n'
'- Prerequisites section (3 bullets)\n'
'- 5 numbered steps with H3 headings\n'
'- Final Result section (1 sentence)\n'
'- 2 Next Steps bullets\n'
'No body content — outline only.'
)
}]
)
print(response.choices[0].message.content)Tekninen tyyli: täsmällinen ja ytimekäs
Teknisessä tekstissä täsmällisyys on suostuttelua tärkeämpää ja ytimekkyys lämpimyyttä tärkeämpää. Ominaisuudet:
- Määritelkää kaikki termit ensimmäisellä käyttökerralla
- Käyttäkää johdonmukaista terminologiaa koko tekstissä (älkää käyttäkö teknisille termeille synonyymeja)
- Lyhyitä ja suoria lauseita — keskimäärin 12–15 sanaa
- Käyttäkää pääasiassa aktiivimuotoa
- Määrällistäkää kaikki, minkä voi määrällistää
- Älkää käyttäkö metaforia tai vertauksia, elleivät ne lisää täsmällisyyttä
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=250,
messages=[{
'role': 'user',
'content': (
'Write technical documentation for a Python function that rate-limits API calls.\n'
'Technical style rules:\n'
'- Define every parameter and return value precisely\n'
'- Include type annotations in the description\n'
'- Quantify all behaviors (e.g., "raises ValueError after 3 retries")\n'
'- Active voice, no passive\n'
'- Max 15 words per sentence\n'
'- No analogies or metaphors\n'
'Function: takes a callable, max_calls (int), window_seconds (int). '
'Returns a wrapped callable that enforces the rate limit.'
)
}]
)
print(response.content[0].text)Oikean tyylin valinta
Tyylin sovittaminen tavoitteeseen on keskeinen taito:
- Journalistinen: uutiset, muistiot ja ilmoitukset, joissa lukijan odotetaan silmäilevän tekstiä
- Suostutteleva (PAS/AIDA): myynti, markkinointi, muutosjohtaminen ja ehdotukset
- Ohjeistava: toimintaohjeet, perehdytys ja tekniset opastusmateriaalit
- Tekninen: API-dokumentaatio, määrittelyasiakirjat ja suunnittelun RFC:t
Useimmissa käytännön teksteissä yhdistellään tyylejä: blogikirjoituksen johdanto voi olla journalistinen, leipäteksti ohjeistava ja lopun toimintakehotus suostutteleva.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
# Hybrid style: journalistic intro + instructional body + persuasive CTA
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Write a 3-section technical blog post intro for "How to Cut Your AWS Bill by 40%".\n'
'Section 1 (Journalistic): 1 sentence hook — state the key finding immediately.\n'
'Section 2 (Instructional): 3-bullet overview of what the reader will learn/do.\n'
'Section 3 (Persuasive): 1 sentence CTA to continue reading.\n'
'Audience: AWS-using startup CTOs. Tone: direct, no hype.'
)
}]
)
print(response.choices[0].message.content)Tyylin johdonmukaisuus eri osioissa
Tyylin vaihtuminen saman asiakirjan sisällä häiritsee lukemista. Suostutteleva aloitus ja sitä seuraava kuiva tekninen teksti rikkovat lukemisen rytmin. Noudattakaa tyylejä yhdistellessänne seuraavia sääntöjä:
- Käyttäkää hallitsevaa tyyliä vähintään 70 prosentissa sisällöstä
- Siirtymäilmaukset helpottavat tyylin vaihtamista (esimerkiksi 'Näin pääsette alkuun:')
- Määritelkää kunkin osion tyyli erikseen kehotteessa, jos tarvitsette yhdistelmän
- Lopettakaa aina samalla tyylillä, jolla aloititte — kokonaisuus tuntuu silloin valmiilta
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=300,
messages=[{
'role': 'user',
'content': (
'Write a product launch announcement combining three styles — '
'label each section.\n\n'
'[JOURNALISTIC LEAD]: 2-sentence news-style announcement of the launch.\n'
'[PERSUASIVE VALUE]: 2-sentence why-it-matters with problem-solution framing.\n'
'[INSTRUCTIONAL NEXT STEP]: 3 numbered steps to get started.\n\n'
'Product: Sentry AI — error monitoring with automatic root cause analysis.\n'
'Audience: developer teams who currently spend hours debugging production errors.'
)
}]
)
print(response.content[0].text)Tyylin nimeäminen kehotteessa
Yksinkertaisin tapa ottaa käyttöön ammattimainen kirjoitustyyli on nimetä se suoraan kehotteessa:
- 'Kirjoittakaa tämä journalistiseen käänteisen pyramidin tyyliin'
- 'Käyttäkää PAS (Problem-Agitate-Solution) -viitekehystä'
- 'Kirjoittakaa vaiheittaiset ohjeet'
- 'Kirjoittakaa teknisen dokumentaation tyylillä — täsmällisesti ja ytimekkäästi'
Malli tunnistaa nämä tyylinimet ja soveltaa niihin liittyviä rakenteita automaattisesti. Lisäkuvausta ei yleensä tarvita.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
style_names = [
'journalistic inverted-pyramid style',
'PAS (Problem-Agitate-Solution) persuasive framework',
'step-by-step instructional documentation style',
'technical documentation style — precise and concise'
]
topic = 'how to reset a forgotten password in our web app'
for style in style_names:
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=80,
messages=[{
'role': 'user',
'content': f'Write about {topic} using {style}. Max 3 sentences or 3 steps.'
}]
)
print(f'Style: {style[:45]}...')
print(response.content[0].text.strip())
print()Osaamisen tarkistus
Kehittäjä kirjoittaa uuden API:n perehdytysdokumentaatiota. Hän haluaa, että käyttäjät pystyvät suorittamaan todennuksen asetukset onnistuneesti ilman yhteydenottoa tukipalveluun. Mikä kirjoitustyyli sopii ensisijaiseksi tyyliksi parhaiten?
Ammattimaiset kirjoitustyylit — yhteenveto
Neljä ammattimaista kirjoitustyyliä ja niiden käyttötarkoitukset:
- Journalistinen: käänteinen pyramidi, tärkein asia ensin, lyhyet lauseet — muistioihin, ilmoituksiin ja uutisiin
- Suostutteleva (PAS/AIDA): ongelma → kärjistäminen → ratkaisu tai huomio → kiinnostus → halu → toiminta — myyntiin, markkinointiin ja ehdotuksiin
- Ohjeistava: numeroidut vaiheet, käskymuotoiset verbit, yksi toiminto vaihetta kohden ja varmistus — toimintaohjeisiin, opastusmateriaaleihin ja perehdytykseen
- Tekninen: täsmällinen ja ytimekäs, termit määritelty, toiminnot määrällistetty — API-dokumentaatioon, RFC:iin ja määrittelyihin
Nimetkää tyyli kehotteessa, niin malli soveltaa sen rakenteita automaattisesti.
Opi Tekoälyn prompt engineering tekoälytuutorin avulla — ilmaiseksi
Kirjoita ja suorita oikeaa koodia selaimessa, saa välitöntä apua tekoälytuutorilta ympäri vuorokauden ja jatka siitä, mihin jäit, verkossa tai sovelluksessa.
- Kurssit
- 53
- Oppitunnit
- 199
Usein kysytyt kysymykset
Onko oppitunti ”Ammattimaiset kirjoitustyylit” ilmainen?
Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa Tekoälyn prompt engineering-oppimispolun 3 oppituntia, myös oppitunnin “Ammattimaiset kirjoitustyylit”. Sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä interaktiiviset harjoitukset sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Tekoälyn prompt engineering-kurssilla on yhteensä 4 oppituntia.
Mitä opin oppitunnilla ”Ammattimaiset kirjoitustyylit”?
Journalistinen, vakuuttava, ohjeistava ja tekninen kirjoitustapa. Harjoittelet Tekoälyn prompt engineering-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.
Tarvitsenko kokemusta aloittaakseni Tekoälyn prompt engineering-opiskelun?
Aiempi kokemus ei ole tarpeen. CoddyKitin Tekoälyn prompt engineering-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 3/4.
Kuinka kauan ”Ammattimaiset kirjoitustyylit”-oppitunnin suorittaminen kestää?
Useimmat CoddyKitin oppitunnit kestävät noin 5–10 minuuttia. Jokainen oppitunti on lyhyt ja interaktiivinen, joten edistyt tasaisesti ja voit jatkaa siitä, mihin jäit – sekä verkossa että sovelluksessa.
Voinko kirjoittaa ja suorittaa koodia tällä Tekoälyn prompt engineering-oppitunnilla?
Kyllä. Jokainen Tekoälyn prompt engineering-oppitunti sisältää sisäänrakennetun koodieditorin, joten voit kirjoittaa ja suorittaa oikeaa koodia suoraan selaimessa ja saada välitöntä palautetta tekoälyltä – paikallista asennusta ei tarvita.
Kaikki tämän kurssin oppitunnit
- Muodollinen ja epämuodollinen sävy
- Kohderyhmän määrittäminen
- Ammattimaiset kirjoitustyylit
- Sanaston tason säätäminen