Stilguide

Syfte

Detta kontextblock definierar en stilguide för hur AI-genererade texter ska skrivas och formateras. Syftet är att skapa konsekvent tonalitet, språkbruk och struktur i AI-svar eller dokument. Blocket används i AI-prompter där man vill säkerställa att text följer samma skrivprinciper oavsett ämne eller uppgift.

Förklaring

En stilguide anger hur text ska formuleras och presenteras. Den fungerar som en uppsättning riktlinjer för ton, språk, struktur och formatering. I AI-sammanhang gör en stilguide det möjligt att styra hur modellen uttrycker sig och hur information organiseras.

Stilguiden kan innehålla riktlinjer för flera områden.

Tonalitet

Texten ska ha en ton som är:

• saklig och neutral
• pedagogisk och tydlig
• professionell men lättläst

Undvik:

• onödigt komplicerade formuleringar
• överdriven marknadsföringston
• informellt eller slangbetonat språk

Språkbruk

När begrepp introduceras bör de:

• förklaras kort första gången de används
• användas konsekvent genom hela texten
• skrivas tydligt och utan onödig jargong

Föredra:

• klara meningar
• konkret språk
• tydliga definitioner

Undvik:

• mycket långa meningar
• oklara formuleringar
• överdriven teknisk terminologi om målgruppen inte kräver det

Struktur

Texter ska vara tydligt strukturerade och lätta att skanna.

Använd:

• rubriker för större avsnitt
• korta stycken
• punktlistor för uppräkningar
• logisk ordning (översikt → fördjupning → exempel)

Rekommenderad struktur:

• titel eller huvudrubrik
• introduktion eller översikt
• huvudsektioner
• eventuell sammanfattning

Markdown-struktur

När markdown används bör följande konventioner följas:

• # för huvudrubrik
• ## för huvudsektioner
• ### för undersektioner
• punktlistor (-) för uppräkningar
• numrerade listor för steg-för-steg-processer

Fetstil kan användas för att markera viktiga begrepp.

Kod eller kommandon bör placeras i kodblock.

Formatering

Formatering ska stödja läsbarheten.

Rekommendationer:

• håll stycken relativt korta
• använd mellanrubriker i längre texter
• undvik stora textblock utan struktur

Tabeller kan användas när information behöver jämföras eller sammanfattas.

Konsekvens

Den viktigaste principen i en stilguide är konsekvens.

Det innebär att:

• samma typ av struktur används i liknande texter
• begrepp används på samma sätt genom hela texten
• tonaliteten hålls stabil oavsett ämne

Användning

Detta kontextblock används för att styra hur AI skriver och formaterar sina svar.

Typiska användningsfall:

• standardisera skrivstil i AI-assisterade dokument
• skapa konsekventa kunskapsartiklar
• styra tonalitet i AI-genererade rapporter
• säkerställa tydlig struktur i längre svar

Begränsningar att vara uppmärksam på:

• En stilguide bör vara tillräckligt generell för att fungera i många sammanhang.
• Specifika projekt kan behöva komplettera med egna stilregler.

Exempelprompter:

• "Utgå från kontextblocket om Stilguide när du skriver en introduktion till AI-säkerhet."
• "Använd kontexten om Stilguide för att strukturera en artikel om referensarkitektur."
• "Baserat på kontexten om Stilguide: skriv en pedagogisk förklaring av promptdesign."

Relaterat

• Skrivstil och format
• Svarsmallar
• Promptdesign