From 47d5d9b14fde0fdc43eab70300910010dffbcc0b Mon Sep 17 00:00:00 2001 From: HassiumX <5256151+Hakku@users.noreply.github.com> Date: Sun, 15 Feb 2026 23:30:40 +0200 Subject: [PATCH 1/4] Add Finnish AI text humanizer prompt Detects and removes 26 AI-generated markers from Finnish text, making it sound like a native Finnish speaker wrote it. --- docs/README.prompts.md | 1 + prompts/humanize-finnish-ai-text.prompt.md | 141 +++++++++++++++++++++ 2 files changed, 142 insertions(+) create mode 100644 prompts/humanize-finnish-ai-text.prompt.md diff --git a/docs/README.prompts.md b/docs/README.prompts.md index 64d37023..9e5bbfdf 100644 --- a/docs/README.prompts.md +++ b/docs/README.prompts.md @@ -75,6 +75,7 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi | [Feature PRD Prompt](../prompts/breakdown-feature-prd.prompt.md)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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 | diff --git a/prompts/humanize-finnish-ai-text.prompt.md b/prompts/humanize-finnish-ai-text.prompt.md new file mode 100644 index 00000000..b954c80f --- /dev/null +++ b/prompts/humanize-finnish-ai-text.prompt.md @@ -0,0 +1,141 @@ +--- +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'] +--- + +# Finnish AI Text Humanizer + + +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. + + + +Ennen kuin korjaat yhtään patternia, sisäistä miten suomalainen kirjoittaja ajattelee. + +**Suoruus.** Suomalainen sanoo asian ja siirtyy eteenpäin. Ei johdattelua, ei pehmentämistä, ei turhia kehyksiä. "Tämä ei toimi" on täysi lause. + +**Lyhyys on voimaa.** Lyhyt virke ei ole laiska — se on täsmällinen. Pitkä virke on perusteltava. + +**Toisto on sallittu.** Suomessa saman sanan käyttö kahdesti on normaalia. Englannin synonyymikierto ("utilize" → "employ" → "leverage") kuulostaa suomessa teennäiseltä. + +**Innostus epäilyttää.** Suomalainen kirjoittaja ei huuda eikä hehkuta. Kuiva toteamus on vahvempi kuin huutomerkki. "Ihan hyvä" on kehu. + +**Hiljaisuus on tyylikeino.** Se mitä jätetään sanomatta voi olla yhtä tärkeää kuin se mitä sanotaan. Älä täytä jokaista aukkoa selityksellä. + +**Partikkelit elävöittävät.** -han/-hän, -pa/-pä, kyllä, vaan, nyt, sit — nämä tekevät tekstistä elävää ja luonnollista. AI jättää ne pois koska ne ovat "turhia". Ne eivät ole. + +### Esimerkki: sieluton vs. elävä + +**Sieluton:** +> Tämä on erittäin merkittävä kehitysaskel, joka tulee vaikuttamaan laajasti alan tulevaisuuteen. On syytä huomata, että kyseinen innovaatio tarjoaa lukuisia mahdollisuuksia eri sidosryhmille. + +**Elävä:** +> Iso juttu alalle. Tästä hyötyvät monet. + +### Persoonallisuuden lisääminen + +AI-tunnusmerkkien poistaminen ei yksin riitä — teksti tarvitsee myös persoonallisuutta. + +- **Rytmin vaihtelu.** Vaihtele lyhyitä ja pitkiä virkkeitä. Monotoninen virkerakenne on AI:n tunnusmerkki. +- **Monimutkaisuuden tunnustaminen.** Asiat voivat olla ristiriitaisia, epäselviä tai keskeneräisiä. AI yrittää ratkaista kaiken siististi. +- **Konkreettiset yksityiskohdat.** Korvaa yleistykset yksityiskohdilla. "Monet yritykset" → "Kolme suurinta kilpailijaa". +- **Harkittu epätäydellisyys.** Sivujuonteet, ajatuksen kehittyminen kesken tekstin, itsekorjaus — nämä ovat ihmisen kirjoittamisen merkkejä. + + + +## Prosessi + +1. **Tunnista** — Lue teksti ja merkitse AI-patternit +2. **Uudelleenkirjoita** — Korvaa patternit luonnollisilla rakenteilla +3. **Säilytä merkitys** — Älä muuta asiasisältöä +4. **Säilytä rekisteri** — Jos alkuperäinen on virallista, pidä virallisena +5. **Lisää persoonallisuutta** — Tuo kirjoittajan ääni esiin + +## Adaptiivinen workflow + +**Lyhyt teksti (alle 500 sanaa):** +Käsittele suoraan. Palauta luonnollistettu teksti + muutosyhteenveto. + +**Pitkä teksti (yli 500 sanaa):** +1. Analysoi ensin — listaa löydetyt AI-patternit ja niiden esiintymät +2. Esitä löydökset käyttäjälle +3. Kysy epäselvistä tapauksista (onko piirre AI-pattern vai tietoinen valinta?) +4. Toteuta luonnollistaminen + + + +## 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 + +### Suomenkieliset patternit + +**#1 Passiivin ylikäyttö** +AI käyttää passiivia kaikkialla 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. + +**#4 Puuttuvat partikkelit** +AI ei käytä partikkeleita (-han/-hän, -pa/-pä, kyllä, vaan) 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. + +**#5 Käännösrakenteet** +AI tuottaa suomea joka noudattaa englannin sanajärjestystä ja rakenteita. + +Ennen: Tämän lisäksi, on tärkeää huomioida se tosiasia, että markkinat ovat muuttuneet. +Jälkeen: Markkinatkin ovat muuttuneet. + +**#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. + +### Universaalit patternit suomeksi + +**#13 Merkittävyyden liioittelu** +AI paisuttaa kaiken "merkittäväksi", "keskeiseksi" tai "ratkaisevaksi". + +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. + +**#15 Mielistelevä sävy** +AI kehuu kysyjää tai aihevalintaa. Suomessa tämä on erityisen kiusallista. + +Ennen: Hyvä kysymys! Tämä on ehdottomasti yksi tärkeimmistä aiheista tällä hetkellä. +Jälkeen: Aihe on ajankohtainen. + +**#17 Täytesanat ja -lauseet** +AI aloittaa tai täyttää kappaleita fraaseilla jotka eivät lisää sisältöä. + +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. + + + +## Tulostusformaatti + +Kun olet luonnollistanut tekstin, palauta: + +1. **Uudelleenkirjoitettu teksti** — kokonaisuudessaan +2. **Muutosyhteenveto** (valinnainen, oletuksena mukana) — lyhyt lista korjatuista patterneista + +Jos käyttäjä pyytää vain tekstiä ilman selityksiä, jätä muutosyhteenveto pois. + + + +## Reunaehdot + +- **Älä muuta asiasisältöä.** Jos alkuperäisessä on fakta, se säilyy. +- **Älä yksinkertaista.** Luonnollistaminen ei tarkoita lapsenkielistä versiota. +- **Kunnioita rekisteriä.** Virallinen teksti pysyy virallisena — vain AI-patternit poistetaan. +- **Älä lisää omaa sisältöä.** Et keksi uusia väitteitä tai esimerkkejä. +- **Kysy epäselvissä tapauksissa.** Jos et ole varma onko jokin piirre AI-pattern vai kirjoittajan tietoinen valinta, kysy käyttäjältä. +- **Jo luonnollinen teksti.** Jos teksti on jo luonnollista, ilmoita se äläkä tee turhia muutoksia. +- **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. + From 0a9fabf9132e55d26ab498e16ccb6790723b7f47 Mon Sep 17 00:00:00 2001 From: HassiumX <5256151+Hakku@users.noreply.github.com> Date: Sun, 15 Feb 2026 23:33:48 +0200 Subject: [PATCH 2/4] Add Finnish words to codespell ignore list "alle" (under/below) and "vai" (or) are valid Finnish words used in the Finnish AI text humanizer prompt. --- .codespellrc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/.codespellrc b/.codespellrc index 5e47054a..07d5ca48 100644 --- a/.codespellrc +++ b/.codespellrc @@ -13,6 +13,8 @@ # ative - part of "Declarative Agents" in TypeSpec M365 Copilot documentation (collections/typespec-m365-copilot.collection.md) # dateA, dateB - variable names used in sorting comparison functions # TE - HTTP transfer coding header -ignore-words-list = numer,wit,aks,edn,ser,ois,gir,rouge,categor,aline,ative,afterall,deques,dateA,dateB,TE +# alle - Finnish word meaning "under/below" (not "all" or "alley") +# vai - Finnish word meaning "or" (not "via" or "vie") +ignore-words-list = numer,wit,aks,edn,ser,ois,gir,rouge,categor,aline,ative,afterall,deques,dateA,dateB,TE,alle,vai # Skip certain files and directories skip = .git,node_modules,package-lock.json,*.lock,website/build,website/.docusaurus From 422e4543c9bcb830ed542e3ef6385bd56794a140 Mon Sep 17 00:00:00 2001 From: HassiumX <5256151+Hakku@users.noreply.github.com> Date: Sun, 15 Feb 2026 23:34:43 +0200 Subject: [PATCH 3/4] fix: remove triggering word from codespell comment --- .codespellrc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.codespellrc b/.codespellrc index 07d5ca48..9ffb303f 100644 --- a/.codespellrc +++ b/.codespellrc @@ -14,7 +14,7 @@ # dateA, dateB - variable names used in sorting comparison functions # TE - HTTP transfer coding header # alle - Finnish word meaning "under/below" (not "all" or "alley") -# vai - Finnish word meaning "or" (not "via" or "vie") +# vai - Finnish word meaning "or" ignore-words-list = numer,wit,aks,edn,ser,ois,gir,rouge,categor,aline,ative,afterall,deques,dateA,dateB,TE,alle,vai # Skip certain files and directories skip = .git,node_modules,package-lock.json,*.lock,website/build,website/.docusaurus From 3df31296958c7a20cae82a6aa540e9e150aca163 Mon Sep 17 00:00:00 2001 From: HassiumX <5256151+Hakku@users.noreply.github.com> Date: Mon, 16 Feb 2026 17:01:12 +0200 Subject: [PATCH 4/4] refactor: convert prompt to skill format MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- docs/README.prompts.md | 1 - docs/README.skills.md | 1 + .../finnish-humanizer/SKILL.md | 16 +- .../finnish-humanizer/references/patterns.md | 338 ++++++++++++++++++ 4 files changed, 349 insertions(+), 7 deletions(-) rename prompts/humanize-finnish-ai-text.prompt.md => skills/finnish-humanizer/SKILL.md (91%) create mode 100644 skills/finnish-humanizer/references/patterns.md diff --git a/docs/README.prompts.md b/docs/README.prompts.md index 9e5bbfdf..64d37023 100644 --- a/docs/README.prompts.md +++ b/docs/README.prompts.md @@ -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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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 | diff --git a/docs/README.skills.md b/docs/README.skills.md index cfc18fee..ca44d99a 100644 --- a/docs/README.skills.md +++ b/docs/README.skills.md @@ -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`
`references/aria-form-role.md`
`references/css-styling.md`
`references/form-basics.md`
`references/form-controls.md`
`references/form-data-handling.md`
`references/html-form-elements.md`
`references/html-form-example.md`
`references/hypertext-transfer-protocol.md`
`references/javascript.md`
`references/php-cookies.md`
`references/php-forms.md`
`references/php-json.md`
`references/php-mysql-database.md`
`references/progressive-web-app.md`
`references/python-as-web-framework.md`
`references/python-contact-form.md`
`references/python-flask-app.md`
`references/python-flask.md`
`references/security.md`
`references/styling-web-forms.md`
`references/web-api.md`
`references/web-performance.md`
`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`
`references/excalidraw-schema.md`
`scripts/.gitignore`
`scripts/README.md`
`scripts/add-arrow.py`
`scripts/add-icon-to-diagram.py`
`scripts/split-excalidraw-library.py`
`templates/business-flow-swimlane-template.excalidraw`
`templates/class-diagram-template.excalidraw`
`templates/data-flow-diagram-template.excalidraw`
`templates/er-diagram-template.excalidraw`
`templates/flowchart-template.excalidraw`
`templates/mindmap-template.excalidraw`
`templates/relationship-template.excalidraw`
`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` | diff --git a/prompts/humanize-finnish-ai-text.prompt.md b/skills/finnish-humanizer/SKILL.md similarity index 91% rename from prompts/humanize-finnish-ai-text.prompt.md rename to skills/finnish-humanizer/SKILL.md index b954c80f..b850aa40 100644 --- a/prompts/humanize-finnish-ai-text.prompt.md +++ b/skills/finnish-humanizer/SKILL.md @@ -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 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. ## 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. + +## 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) diff --git a/skills/finnish-humanizer/references/patterns.md b/skills/finnish-humanizer/references/patterns.md new file mode 100644 index 00000000..2b9cd8a7 --- /dev/null +++ b/skills/finnish-humanizer/references/patterns.md @@ -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 (1–12)](#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 (13–26)](#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 |