refactor: convert prompt to skill format

Per reviewer feedback, migrate from prompts/ to skills/ format:
- Move prompt → skills/finnish-humanizer/SKILL.md with proper frontmatter
- Bundle references/patterns.md (26 AI patterns + 4 style markers)
- Regenerate README tables via npm start
This commit is contained in:
HassiumX
2026-02-16 17:01:12 +02:00
parent 422e4543c9
commit 3df3129695
4 changed files with 349 additions and 7 deletions

View File

@@ -75,7 +75,6 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi
| [Feature PRD Prompt](../prompts/breakdown-feature-prd.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fbreakdown-feature-prd.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fbreakdown-feature-prd.prompt.md) | Prompt for creating Product Requirements Documents (PRDs) for new features, based on an Epic. |
| [Fedora Linux Triage](../prompts/fedora-linux-triage.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Ffedora-linux-triage.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Ffedora-linux-triage.prompt.md) | Triage and resolve Fedora issues with dnf, systemd, and SELinux-aware guidance. |
| [Finalize Agent Prompt](../prompts/finalize-agent-prompt.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Ffinalize-agent-prompt.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Ffinalize-agent-prompt.prompt.md) | Finalize prompt file using the role of an AI agent to polish the prompt for the end user. |
| [Finnish AI Text Humanizer](../prompts/humanize-finnish-ai-text.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fhumanize-finnish-ai-text.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fhumanize-finnish-ai-text.prompt.md) | Detect and remove AI-generated markers from Finnish text, making it sound like a native Finnish speaker wrote it. Identifies 26 patterns across Finnish-specific and universal categories. |
| [Generate Application from OpenAPI Spec](../prompts/openapi-to-application-code.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md) | Generate a complete, production-ready application from an OpenAPI specification |
| [Generate C# MCP Server](../prompts/csharp-mcp-server-generator.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-mcp-server-generator.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-mcp-server-generator.prompt.md) | Generate a complete MCP server project in C# with tools, prompts, and proper configuration |
| [Generate Python MCP Server](../prompts/python-mcp-server-generator.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpython-mcp-server-generator.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpython-mcp-server-generator.prompt.md) | Generate a complete MCP server project in Python with tools, resources, and proper configuration |

View File

@@ -35,6 +35,7 @@ Skills differ from other primitives by supporting bundled assets (scripts, code
| [copilot-sdk](../skills/copilot-sdk/SKILL.md) | Build agentic applications with GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, GitHub SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent. | None |
| [create-web-form](../skills/create-web-form/SKILL.md) | Create robust, accessible web forms with best practices for HTML structure, CSS styling, JavaScript interactivity, form validation, and server-side processing. Use when asked to "create a form", "build a web form", "add a contact form", "make a signup form", or when building any HTML form with data handling. Covers PHP and Python backends, MySQL database integration, REST APIs, XML data exchange, accessibility (ARIA), and progressive web apps. | `references/accessibility.md`<br />`references/aria-form-role.md`<br />`references/css-styling.md`<br />`references/form-basics.md`<br />`references/form-controls.md`<br />`references/form-data-handling.md`<br />`references/html-form-elements.md`<br />`references/html-form-example.md`<br />`references/hypertext-transfer-protocol.md`<br />`references/javascript.md`<br />`references/php-cookies.md`<br />`references/php-forms.md`<br />`references/php-json.md`<br />`references/php-mysql-database.md`<br />`references/progressive-web-app.md`<br />`references/python-as-web-framework.md`<br />`references/python-contact-form.md`<br />`references/python-flask-app.md`<br />`references/python-flask.md`<br />`references/security.md`<br />`references/styling-web-forms.md`<br />`references/web-api.md`<br />`references/web-performance.md`<br />`references/xml.md` |
| [excalidraw-diagram-generator](../skills/excalidraw-diagram-generator/SKILL.md) | Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw. | `references/element-types.md`<br />`references/excalidraw-schema.md`<br />`scripts/.gitignore`<br />`scripts/README.md`<br />`scripts/add-arrow.py`<br />`scripts/add-icon-to-diagram.py`<br />`scripts/split-excalidraw-library.py`<br />`templates/business-flow-swimlane-template.excalidraw`<br />`templates/class-diagram-template.excalidraw`<br />`templates/data-flow-diagram-template.excalidraw`<br />`templates/er-diagram-template.excalidraw`<br />`templates/flowchart-template.excalidraw`<br />`templates/mindmap-template.excalidraw`<br />`templates/relationship-template.excalidraw`<br />`templates/sequence-diagram-template.excalidraw` |
| [finnish-humanizer](../skills/finnish-humanizer/SKILL.md) | Detect and remove AI-generated markers from Finnish text, making it sound like a native Finnish speaker wrote it. Use when asked to "humanize", "naturalize", or "remove AI feel" from Finnish text, or when editing .md/.txt files containing Finnish content. Identifies 26 patterns (12 Finnish-specific + 14 universal) and 4 style markers. | `references/patterns.md` |
| [gh-cli](../skills/gh-cli/SKILL.md) | GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line. | None |
| [git-commit](../skills/git-commit/SKILL.md) | Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping | None |
| [github-issues](../skills/github-issues/SKILL.md) | Create, update, and manage GitHub issues using MCP tools. Use this skill when users want to create bug reports, feature requests, or task issues, update existing issues, add labels/assignees/milestones, or manage issue workflows. Triggers on requests like "create an issue", "file a bug", "request a feature", "update issue X", or any GitHub issue management task. | `references/templates.md` |

View File

@@ -1,10 +1,9 @@
---
agent: 'agent'
description: 'Detect and remove AI-generated markers from Finnish text, making it sound like a native Finnish speaker wrote it. Identifies 26 patterns across Finnish-specific and universal categories.'
tools: ['edit/editFiles']
name: finnish-humanizer
description: 'Detect and remove AI-generated markers from Finnish text, making it sound like a native Finnish speaker wrote it. Use when asked to "humanize", "naturalize", or "remove AI feel" from Finnish text, or when editing .md/.txt files containing Finnish content. Identifies 26 patterns (12 Finnish-specific + 14 universal) and 4 style markers.'
---
# Finnish AI Text Humanizer
# Finnish Humanizer
<role>
Olet kirjoituseditori, joka tunnistaa ja poistaa suomenkielisen AI-tekstin tunnusmerkit. Et ole kieliopin tarkistaja, kääntäjä tai yksinkertaistaja. Tehtäväsi on tehdä tekstistä sellaista, jonka suomalainen ihminen olisi voinut kirjoittaa.
@@ -67,7 +66,7 @@ Käsittele suoraan. Palauta luonnollistettu teksti + muutosyhteenveto.
<examples>
## Esimerkkipatternit
26 AI-patternia on jaettu kahteen ryhmään: suomenkieliset (suomelle ominaiset rakenteet) ja universaalit (kaikissa kielissä esiintyvät, tunnistetaan ja korjataan suomeksi). Alla 7 kanonista esimerkkiä. Täysi 26 kategorian patternilista: https://github.com/Hakku/finnish-humanizer/blob/main/finnish-humanizer/references/patterns.md
26 AI-patternia on jaettu kahteen ryhmään: suomenkieliset (suomelle ominaiset rakenteet) ja universaalit (kaikissa kielissä esiintyvät, tunnistetaan ja korjataan suomeksi). Alla 7 kanonista esimerkkiä. Täysi 26 kategorian patternilista: ks. references/patterns.md
### Suomenkieliset patternit
@@ -90,7 +89,7 @@ Ennen: Tämän lisäksi, on tärkeää huomioida se tosiasia, että markkinat ov
Jälkeen: Markkinatkin ovat muuttuneet.
**#6 Genetiiviketjut**
Peräkkäiset genetiivimuodot kasautuvat kun AI yrittää ilmaista monimutkaisia suhteita yhdessä rakenteessa.
Peräkkäiset genetiivimuodot kasautuvat kun AI yrittää ilmaista monimutkaisia suhteita yhdessä rakenteella.
Ennen: Tuotteen laadun parantamisen mahdollisuuksien arvioinnin tulokset osoittavat kehityspotentiaalia.
Jälkeen: Arvioimme miten tuotteen laatua voisi parantaa. Kehityspotentiaalia löytyi.
@@ -139,3 +138,8 @@ Jos käyttäjä pyytää vain tekstiä ilman selityksiä, jätä muutosyhteenvet
- **Koodiesimerkkit ja tekninen sanasto.** Säilytä englanninkieliset koodiesimerkkit, tekniset termit ja lainaukset sellaisinaan.
- **Sekateksti (fi/en).** Käsittele vain suomenkieliset osat. Jätä englanninkieliset osiot koskematta.
</constraints>
## References
- Full 26-pattern list with examples: [references/patterns.md](references/patterns.md)
- Source repository: [Hakku/finnish-humanizer](https://github.com/Hakku/finnish-humanizer) (MIT)

View File

@@ -0,0 +1,338 @@
# Finnish Humanizer — Täysi patternilista
Kaikki 26 AI-patternia esimerkkeineen. SKILL.md sisältää 7 kanonista esimerkkiä; tämä tiedosto sisältää loput.
## Sisällysluettelo
- [Suomenkieliset AI-patternit (112)](#suomenkieliset-ai-patternit)
- [1. Passiivin ylikäyttö](#1-passiivin-ylikäyttö)
- [2. Nominaalirakenteet](#2-nominaalirakenteet)
- [3. Pronominien ylikäyttö](#3-pronominien-ylikäyttö)
- [4. Puuttuvat partikkelit](#4-puuttuvat-partikkelit)
- [5. Käännösrakenteet](#5-käännösrakenteet)
- [6. Genetiiviketjut](#6-genetiiviketjut)
- [7. Adjektiivikasaumat](#7-adjektiivikasaumat)
- [8. Ylipitkät virkkeet](#8-ylipitkät-virkkeet)
- [9. Joka/jotka-kasautuminen](#9-jokajotka-kasautuminen)
- [10. Virkakielisyys väärässä kontekstissa](#10-virkakielisyys-väärässä-kontekstissa)
- [11. Astevaihtelun välttely](#11-astevaihtelun-välttely)
- [12. Liiallinen kohteliaisuus](#12-liiallinen-kohteliaisuus)
- [Universaalit AI-patternit suomeksi (1326)](#universaalit-ai-patternit-suomeksi)
- [13. Merkittävyyden liioittelu](#13-merkittävyyden-liioittelu)
- [14. Mainosmainen kieli](#14-mainosmainen-kieli)
- [15. Mielistelevä sävy](#15-mielistelevä-sävy)
- [16. Liiallinen varautuminen](#16-liiallinen-varautuminen)
- [17. Täytesanat ja -lauseet](#17-täytesanat-ja--lauseet)
- [18. Geneerinen lopetus](#18-geneerinen-lopetus)
- [19. Epämääräiset viittaukset](#19-epämääräiset-viittaukset)
- [20. "Haasteista huolimatta" -kaava](#20-haasteista-huolimatta--kaava)
- [21. Kolmen sääntö ja synonyymikierto](#21-kolmen-sääntö-ja-synonyymikierto)
- [22. Partisiippirakenteet](#22-partisiippirakenteet)
- [23. Kopulan välttely](#23-kopulan-välttely)
- [24. Negatiivinen rinnastus](#24-negatiivinen-rinnastus)
- [25. Keinotekoiset skaalaviittaukset](#25-keinotekoiset-skaalaviittaukset)
- [26. Tietokatkos-vastuuvapauslausekkeet](#26-tietokatkos-vastuuvapauslausekkeet)
- [Tyylimerkinnät](#tyylimerkinnät)
- [Täysimittainen esimerkki](#täysimittainen-esimerkki)
---
## Suomenkieliset AI-patternit
### 1. Passiivin ylikäyttö
AI käyttää passiivia kaikkialla. Suomessa passiivi on luonnollinen, mutta AI ylikäyttää sitä välttääkseen tekijän nimeämistä.
Ennen: Sovellus on suunniteltu tarjoamaan käyttäjille mahdollisuus hallita omia tietojaan tehokkaasti.
Jälkeen: Sovelluksella hallitset omat tietosi.
Ennen: Tutkimuksessa havaittiin, että menetelmä tuottaa parempia tuloksia.
Jälkeen: Tutkimus osoitti menetelmän toimivan paremmin.
### 2. Nominaalirakenteet
Verbi muutetaan substantiiviksi ja lisätään tukiverbi. "Suorittaa tarkistuksen" kun voisi sanoa "tarkistaa".
Ennen: Järjestelmä suorittaa tietojen validoinnin ennen tallennuksen toteuttamista.
Jälkeen: Järjestelmä validoi tiedot ennen tallennusta.
Ennen: Tiimi tekee arvioinnin projektin etenemisestä.
Jälkeen: Tiimi arvioi projektin etenemisen.
### 3. Pronominien ylikäyttö
Suomessa pronomini jätetään pois kun konteksti on selvä. AI lisää "me", "se", "tämä" joka paikkaan englannin mallin mukaan.
Ennen: Me uskomme, että meidän ratkaisumme tarjoaa merkittävää arvoa.
Jälkeen: Ratkaisumme tuottaa arvoa.
Ennen: Se on työkalu, joka auttaa sinua parantamaan tuottavuuttasi.
Jälkeen: Työkalu parantaa tuottavuuttasi.
### 4. Puuttuvat partikkelit
AI ei käytä partikkeleita (-han/-hän, -pa/-pä, kyllä, vaan, nyt, sit) koska ne ovat epämuodollisia. Suomessa ne ovat normaalia kirjoituskieltä.
Ennen: Tämä on totta. Kyse on kuitenkin siitä, että tilanne on monimutkainen.
Jälkeen: Onhan se totta. Tilanne on vaan monimutkainen.
Ennen: Kokeile tätä. Se toimii hyvin.
Jälkeen: Kokeilepa tätä. Kyllä se toimii.
### 5. Käännösrakenteet
AI tuottaa suomea joka noudattaa englannin sanajärjestystä ja rakenteita. Tuloksena on teknisesti oikeaa mutta luonnotonta kieltä.
Ennen: Tämän lisäksi, on tärkeää huomioida se tosiasia, että markkinat ovat muuttuneet.
Jälkeen: Markkinatkin ovat muuttuneet.
Ennen: Se on juuri tämä seikka, joka tekee asiasta mielenkiintoisen.
Jälkeen: Juuri tämä tekee asiasta kiinnostavan.
### 6. Genetiiviketjut
Peräkkäiset genetiivimuodot kasautuvat kun AI yrittää ilmaista monimutkaisia suhteita yhdessä rakenteessa.
Ennen: Tuotteen laadun parantamisen mahdollisuuksien arvioinnin tulokset osoittavat kehityspotentiaalia.
Jälkeen: Arvioimme miten tuotteen laatua voisi parantaa. Kehityspotentiaalia löytyi.
Ennen: Yrityksen strategisen suunnittelun prosessin uudistamisen tavoitteena on tehokkuuden lisääminen.
Jälkeen: Yritys uudistaa strategista suunnitteluaan tehostuakseen.
### 7. Adjektiivikasaumat
AI kasaa useita adjektiiveja peräkkäin. Suomessa yksi osuva adjektiivi on parempi kuin neljä geneeristä.
Ennen: Moderni, innovatiivinen, käyttäjäystävällinen ja monipuolinen alusta tarjoaa kattavia ratkaisuja.
Jälkeen: Monipuolinen alusta, jota on helppo käyttää.
Ennen: Tehokas, luotettava, skaalautuva ja turvallinen infrastruktuuri.
Jälkeen: Luotettava ja skaalautuva infrastruktuuri.
### 8. Ylipitkät virkkeet
AI kirjoittaa yhden pitkän virkkeen johon pakataan useita ajatuksia pilkuilla ja konjunktioilla erotettuna.
Ennen: Uusi järjestelmä, joka otettiin käyttöön viime kuussa, on parantanut asiakastyytyväisyyttä merkittävästi, sillä se tarjoaa nopeamman vasteajan ja intuitiivisemman käyttöliittymän, minkä ansiosta käyttäjät löytävät tarvitsemansa tiedot helpommin ja voivat suorittaa tehtävänsä tehokkaammin.
Jälkeen: Uusi järjestelmä otettiin käyttöön viime kuussa. Asiakastyytyväisyys on parantunut selvästi. Vasteaika on nopeampi ja käyttöliittymä selkeämpi, joten tiedot löytyvät helpommin.
### 9. Joka/jotka-kasautuminen
AI ketjuttaa sivulauseita "joka"- ja "jotka"-pronomineilla. Suomessa partisiippirakenne tai erillinen virke on luontevampi.
Ennen: Tiimi, joka vastaa projektista, joka on saanut rahoituksen, jota haettiin viime vuonna, esitteli tulokset.
Jälkeen: Viime vuonna rahoituksen saanut projektitiimi esitteli tulokset.
Ennen: Raportti, joka sisältää tiedot, jotka kerättiin kyselystä, joka lähetettiin asiakkaille.
Jälkeen: Raportti perustuu asiakkaille lähetetyn kyselyn tuloksiin.
### 10. Virkakielisyys väärässä kontekstissa
AI käyttää virallista kieltä tilanteissa joissa se ei sovi. "Kyseinen" ja "edellä mainittu" kuuluvat lakitekstiin, eivät blogikirjoitukseen.
Ennen: Kyseinen tuote soveltuu erinomaisesti edellä mainittujen käyttötapausten toteuttamiseen.
Jälkeen: Tuote toimii hyvin näihin tarkoituksiin.
Ennen: Mikäli käyttäjä haluaa hyödyntää kyseistä toiminnallisuutta, tulee hänen ensisijaisesti suorittaa kirjautuminen.
Jälkeen: Kirjaudu ensin sisään, niin pääset käyttämään toimintoa.
### 11. Astevaihtelun välttely
AI saattaa välttää sanoja joissa astevaihtelu tuottaa vieraannäköisiä muotoja. Ei systemaattinen virhe vaan taipumus valita "turvallisempia" sanoja.
Tunnistus: Teksti käyttää toistuvasti samoja helppoja sanoja ja välttelee esim. muotoja kuten "luvun" (luku), "halvempi" (halpa), "leveämpi" (leveä).
Toimenpide: Ei automaattista korjausta. Tarkista käyttääkö teksti epätavallisen suppeaa sanastoa ja laajenna tarvittaessa.
### 12. Liiallinen kohteliaisuus
AI siirtää englannin kohteliaisuusnormit suomeen. Suomessa liiallinen kohteliaisuus kuulostaa epäaidolta tai jopa ironiselta.
Ennen: Olisin erittäin kiitollinen, mikäli voisitte ystävällisesti harkita mahdollisuutta osallistua tapahtumaemme.
Jälkeen: Tervetuloa tapahtumaamme.
Ennen: Haluaisin nöyrästi ehdottaa, että ehkäpä voisimme mahdollisesti tarkastella tätä asiaa uudelleen.
Jälkeen: Tarkastellaan tätä uudelleen.
---
## Universaalit AI-patternit suomeksi
Nämä esiintyvät kaikissa kielissä mutta tunnistetaan ja korjataan suomenkielisin esimerkein.
### 13. Merkittävyyden liioittelu
AI paisuttaa kaiken "merkittäväksi", "keskeiseksi" tai "ratkaisevaksi".
Merkkisanat: merkittävä, keskeinen, ratkaiseva rooli, olennainen, elintärkeä, kriittinen
Ennen: Tekoäly tulee olemaan merkittävässä ja keskeisessä roolissa tulevaisuuden ratkaisevien haasteiden ratkaisemisessa.
Jälkeen: Tekoälystä tulee tärkeä työkalu moniin ongelmiin.
### 14. Mainosmainen kieli
Teksti kuulostaa mainokselta vaikka konteksti on neutraali.
Merkkisanat: ainutlaatuinen, uraauurtava, vertaansa vailla, vallankumouksellinen, maailmanluokan
Ennen: Uraauurtava ja ainutlaatuinen alustamme tarjoaa vertaansa vailla olevan käyttökokemuksen.
Jälkeen: Alusta toimii hyvin ja erottuu kilpailijoista.
### 15. Mielistelevä sävy
AI kehuu kysyjää tai aihevalintaa. Suomessa tämä on erityisen kiusallista.
Merkkisanat: Hyvä kysymys!, Ehdottomasti!, Aivan oikein!, Erinomainen huomio!
Ennen: Hyvä kysymys! Tämä on ehdottomasti yksi tärkeimmistä aiheista tällä hetkellä.
Jälkeen: Aihe on ajankohtainen.
### 16. Liiallinen varautuminen
AI pehmentää jokaisen väitteen varmuuden vuoksi.
Merkkisanat: saattaisi mahdollisesti, voitaneen todeta, lienee perusteltua, on syytä olettaa
Ennen: Saattaisi olla mahdollista, että tämä lähestymistapa voisi potentiaalisesti tuottaa jonkinlaisia parannuksia tietyissä olosuhteissa.
Jälkeen: Lähestymistapa todennäköisesti parantaa tuloksia.
### 17. Täytesanat ja -lauseet
AI aloittaa tai täyttää kappaleita fraaseilla jotka eivät lisää sisältöä.
Merkkisanat: On syytä huomata, Tässä yhteydessä on tärkeää, Kuten aiemmin mainittiin, On hyvä muistaa
Ennen: On syytä huomata, että tässä yhteydessä on tärkeää ymmärtää alustan arkkitehtuuri ennen käyttöönottoa.
Jälkeen: Ymmärrä alustan arkkitehtuuri ennen käyttöönottoa.
### 18. Geneerinen lopetus
AI päättää tekstin tyhjällä optimismilla.
Merkkisanat: Tulevaisuus näyttää valoisalta, jatkaa kehittymistä, avaa uusia mahdollisuuksia
Ennen: Tulevaisuus näyttää valoisalta ja ala jatkaa kehittymistään, avaten uusia mahdollisuuksia kaikille toimijoille.
Jälkeen: [Poista kokonaan tai korvaa konkreettisella ennusteella]
### 19. Epämääräiset viittaukset
AI viittaa auktoriteetteihin nimeämättä niitä.
Merkkisanat: Asiantuntijoiden mukaan, Tutkimukset osoittavat, Alan johtavat toimijat
Ennen: Tutkimukset osoittavat, että asiantuntijoiden mukaan tämä on alan paras käytäntö.
Jälkeen: [Nimeä lähde] tai poista väite.
### 20. "Haasteista huolimatta" -kaava
AI tunnustaa haasteen mutta mitätöi sen välittömästi. Rakenne: "vaikka X, niin silti Y".
Merkkisanat: Haasteista huolimatta, Vaikka [ongelma], jatkaa kehittymistä
Ennen: Haasteista huolimatta yritys on onnistunut kasvattamaan markkinaosuuttaan ja jatkaa vahvaa kehitystään.
Jälkeen: Yritys on kasvattanut markkinaosuuttaan. Haasteitakin on: [nimeä ne].
### 21. Kolmen sääntö ja synonyymikierto
AI listaa asioita kolmen ryhmissä ja kierrättää synonyymejä välttääkseen toistoa. Suomessa toisto on luonnollista.
Ennen: Ratkaisu on tehokas, vaikuttava ja tuloksellinen. Se parantaa, kehittää ja optimoi prosesseja.
Jälkeen: Ratkaisu on tehokas. Se parantaa prosesseja.
Ennen: Alusta yhdistää, integroi ja kokoaa yhteen eri tietolähteet.
Jälkeen: Alusta yhdistää eri tietolähteet.
### 22. Partisiippirakenteet
AI ylikäyttää -malla/-mällä ja -en -muotoja korvikkeena konkreettisemmille ilmaisuille.
Ennen: Hyödyntämällä uusia teknologioita ja tarkastelemalla olemassa olevia prosesseja voidaan saavuttaa merkittäviä parannuksia.
Jälkeen: Uusilla teknologioilla ja prosessien tarkastelulla voidaan parantaa tuloksia.
Ennen: Ottamalla huomioon käyttäjien tarpeet ja analysoimalla käyttödataa voidaan kehittää parempia ratkaisuja.
Jälkeen: Käyttäjien tarpeet ja käyttödata ohjaavat kehitystä.
### 23. Kopulan välttely
AI välttelee yksinkertaista "on/olla" ja korvaa sen monimutkaisemmilla verbeillä: "toimii", "tarjoaa", "edustaa", "muodostaa".
Ennen: Alusta toimii keskeisenä työkaluna datan hallinnassa ja tarjoaa monipuolisia mahdollisuuksia.
Jälkeen: Alusta on hyvä työkalu datan hallintaan.
Ennen: Tämä ratkaisu edustaa modernia lähestymistapaa ja muodostaa perustan tulevalle kehitykselle.
Jälkeen: Tämä on moderni ratkaisu, jolle voi rakentaa jatkossa.
### 24. Negatiivinen rinnastus
"Ei pelkästään...vaan myös" / "ei ainoastaan...vaan" -kaavan ylikäyttö korostuskeinona.
Ennen: Alusta ei pelkästään tehosta työskentelyä, vaan myös parantaa tiimien välistä yhteistyötä.
Jälkeen: Alusta tehostaa työskentelyä ja parantaa yhteistyötä.
Ennen: Ratkaisu ei ainoastaan säästä aikaa, vaan tarjoaa myös uusia näkökulmia päätöksentekoon.
Jälkeen: Ratkaisu säästää aikaa ja tuo uusia näkökulmia.
### 25. Keinotekoiset skaalaviittaukset
"X:stä Y:hyn" -rakenne luo valheellista kattavuutta. AI käyttää sitä vaikuttaakseen kokonaisvaltaiselta.
Ennen: Alusta kattaa kaiken strategisesta suunnittelusta operatiiviseen toteutukseen.
Jälkeen: Alusta tukee sekä suunnittelua että toteutusta.
Ennen: Palvelu auttaa aina pienimmistä yksityiskohdista suurimpiin kokonaisuuksiin.
Jälkeen: Palvelu auttaa eri kokoisissa tehtävissä.
### 26. Tietokatkos-vastuuvapauslausekkeet
AI lisää tarpeettomia vastuuvapauslausekkeita omasta tietotasostaan.
Merkkisanat: viimeisimpien tietojeni mukaan, saatavilla olevien tietojen perusteella, tämänhetkisen ymmärrykseni mukaan
Ennen: Viimeisimpien tietojeni mukaan markkinatilanne on muuttunut merkittävästi viime vuosina.
Jälkeen: Markkinatilanne on muuttunut viime vuosina.
Ennen: Saatavilla olevien tietojen perusteella voidaan todeta, että kehitys on ollut positiivista.
Jälkeen: Kehitys on ollut positiivista.
---
## Tyylimerkinnät
Nämä eivät ole patterneita vaan muotoiluvalintoja joita AI suosii:
- **Lihavoinnin ylikäyttö** — AI lihavoi jokaisen avainsanan. Lihavoi vain se mikä oikeasti vaatii huomiota.
- **Emojit** — Poista ellei konteksti ole selvästi epämuodollinen (some, chat).
- **"Otsikko:" -listaus** — AI kirjoittaa "**Hyöty:** parempi suorituskyky" kun voisi sanoa "Suorituskyky paranee".
- **Kaarevat lainausmerkit** — AI (erit. ChatGPT) käyttää typografisia \u201clainausmerkkejä\u201d suorien "lainausmerkkien" sijaan. Suomessa käytetään suoria lainausmerkkejä.
---
## Täysimittainen esimerkki
### Ennen (AI-generoitu)
> **Kattava katsaus moderniin ohjelmistokehitykseen**
>
> Nykyaikainen ohjelmistokehitys on merkittävä ja keskeinen osa digitaalista transformaatiota. On syytä huomata, että alan kehitys on ollut erittäin nopeaa viime vuosina. Me näemme, että uudet teknologiat, innovatiiviset työkalut ja tehokkaat menetelmät ovat muuttaneet tapaa, jolla ohjelmistoja suunnitellaan, kehitetään ja ylläpidetään.
>
> Ketterät menetelmät, jotka ovat saaneet laajaa hyväksyntää, tarjoavat merkittäviä etuja perinteisiin lähestymistapoihin verrattuna. Kyseisten menetelmien avulla tiimit voivat suorittaa nopeamman reagoinnin muuttuviin vaatimuksiin. Tutkimukset osoittavat, että ketterää kehitystä hyödyntävät organisaatiot saavuttavat parempia tuloksia asiakastyytyväisyyden, tuottavuuden ja laadun saralla.
>
> Haasteista huolimatta ala jatkaa vahvaa kehitystään. Tekoäly tulee olemaan ratkaisevassa roolissa ohjelmistokehityksen tulevaisuuden muovaamisessa. Tulevaisuus näyttää valoisalta ja avaa uusia, jännittäviä mahdollisuuksia kaikille alan toimijoille.
### Jälkeen (luonnollistettu)
> Ohjelmistokehitys on muuttunut nopeasti. Uudet työkalut ja menetelmät ovat muokanneet koko alaa — suunnittelusta ylläpitoon.
>
> Ketterät menetelmät ovat yleistyneet syystä. Tiimit reagoivat nopeammin muuttuviin vaatimuksiin. Esimerkiksi State of Agile -raportin (2024) mukaan ketterää käyttävät organisaatiot raportoivat parempaa asiakastyytyväisyyttä ja laatua.
>
> Tekoäly muuttaa alaa sekin, mutta miten ja kuinka nopeasti — sitä ei vielä tiedä.
### Tehdyt muutokset
| # | Pattern | Muutos |
|---|---------|--------|
| 1 | Passiivin ylikäyttö | "on ollut erittäin nopeaa" → "on muuttunut nopeasti" |
| 2 | Nominaalirakenteet | "suorittaa nopeamman reagoinnin" → "reagoivat nopeammin" |
| 3 | Pronominien ylikäyttö | "Me näemme, että" → poistettu |
| 5 | Käännösrakenteet | "tapaa, jolla" → "suunnittelusta ylläpitoon" |
| 7 | Adjektiivikasaumat | "uudet teknologiat, innovatiiviset työkalut ja tehokkaat menetelmät" → "Uudet työkalut ja menetelmät" |
| 8 | Ylipitkät virkkeet | Ensimmäinen kappale pilkottu |
| 9 | Joka/jotka-kasautuminen | "jotka ovat saaneet laajaa hyväksyntää" → "ovat yleistyneet" |
| 10 | Virkakielisyys | "Kyseisten menetelmien avulla" → poistettu |
| 13 | Merkittävyyden liioittelu | "merkittävä ja keskeinen" → poistettu |
| 17 | Täytesanat | "On syytä huomata, että" → poistettu |
| 18 | Geneerinen lopetus | "Tulevaisuus näyttää valoisalta" → rehellinen epävarmuus |
| 19 | Epämääräiset viittaukset | "Tutkimukset osoittavat" → nimetty lähde |
| 20 | "Haasteista huolimatta" | Poistettu kaava, haasteet jätetty auki |
| 21 | Kolmen sääntö | Kolmen ryhmät karsittu |