La grammatica è corretta, ma la lettura risulta faticosa. Ci si addormenta a metà pagina. Si capisce subito che "Ah, questo è stato scritto da un'IA" già dalla prima riga.
Il senso unico di disagio quando si usa l'IA per scrivere in giapponese rimane una sfida per molte persone ancora oggi. Molti hanno sperimentato e sviluppato competenze e sistemi per risolvere questo fastidio.
In questo articolo, riassumo spunti pratici verificati attraverso la scrittura quotidiana e i risultati della community, organizzati secondo le seguenti quattro prospettive:
- Selezione del modello: Perché scegliere il modello giusto conta più dei miglioramenti dell'harness (framework)
- Procedura di scrittura consigliata: Cinque passaggi per ridurre il carico cognitivo del lettore e creare ritmo nelle frasi
- Skill consigliate: Strumenti essenziali creati dai predecessori che gestiscono la lunghezza delle frasi e prevengono la disorientazione del lettore
- Ambiente di scrittura reale: Struttura del repository per superare il muro dove "aggiungere regole riporta indietro l'odore di IA"
Prima di tutto, voglio affermare chiaramente che "la selezione del modello" è più efficace rispetto ai prompt o agli hook (harness).
Nel 2026, Gemini 3.8 Flash è nettamente superiore agli altri per la scrittura in giapponese, seguito da Kimi K3. Claude, un tempo elogiato per la prosa naturale, è diventato notevolmente rigido e angolare a causa della sua specializzazione nel coding. ChatGPT rimane mediocre, con lunghezze dei paragrafi eccessivamente uniformi e strutture da manuale che lasciano le tracce di IA più evidenti.
Tuttavia, affidarsi esclusivamente all'output grezzo del modello porta a ritmi di frase omogenei e scarica il peso cognitivo sul lettore. Sono necessarie procedure e sistemi per sfruttare la forza intrinseca del modello.
Procedura di scrittura consigliata
Integrando le conoscenze attuali, la procedura di scrittura che dovremmo adottare ora può essere riassunta in questi cinque passaggi.
1[Passaggio 1] Ordinamento e taglio delle informazioni (scartare la gentilezza inutile)2 ↓3[Passaggio 2] Progettazione della mappa mentale del lettore (ordine globale e connessioni)4 ↓5[Passaggio 3] Progettazione dell'intonazione e della variazione (distribuzione intenzionale dell'intensità)6 ↓7[Passaggio 4] Separazione tra scrittura e ispezione meccanica (rifiuto tramite PostToolUse Hook)8 ↓9[Passaggio 5] L'umano rifinisce il finale 10% (registrare i diff per retroalimentare le regole)
Passaggio 1. Ordinamento e "taglio" delle informazioni pre-scrittura
La ragione principale per cui il testo generato dall'IA è illeggibile è lo "scarico del carico cognitivo" (Tsubota-san / @tsubotax). Ammassa premesse, supplementi e rassicurazioni preventive in singole frasi. La regola ferrea è tagliare le informazioni non utilizzate per "cosa farà l'altra persona dopo" prima di lasciare che l'IA scriva.
- Determinare "per chi è questo testo e quale decisione è necessaria" nelle prime due righe
- Assegnare a ogni paragrafo un solo ruolo, come "differenze tra opzioni", "materiali decisionali" o "metodi di verifica", e scartare i paragrafi che non rientrano in nessuno
- Rimuovere tutti i supplementi tra parentesi che non influenzano le decisioni se eliminati
Passaggio 2. Design globale che non rompe la "mappa mentale" del lettore
Come evidenziato da Keiichiro Shikano (@golden_lucky), i crolli nella comprensione derivano da "imboscate dove l'intento non è chiaro finché non leggi oltre" o dalla "mancanza di connessione con il paragrafo precedente". Preparare un percorso affinché i lettori non si perdano.
- Quando si introduce un concetto per la prima volta, ordinarlo così che i lettori possano identificare tipi e ruoli semplicemente leggendo in sequenza
- Prima di introdurre nuove informazioni, preparare un percorso nella mente del lettore per riceverle
- Collocare sempre una frase di collegamento al paragrafo precedente immediatamente dopo un'intestazione
Passaggio 3. Incorporare intenzionalmente "bias (variazione)"
L'IA tende a discutere tutti gli argomenti alla stessa temperatura, ma l'essenza del tocco umano è il "bias" (Natsu-san / @art_reflection). Parla ossessivamente degli argomenti interessanti, scorri sulle premesse in una sola frase. Allocare intenzionalmente l'intensità durante la fase strutturale.
Passaggio 4. Separare scrittura e ispezione meccanica
Più divieti elenchi nel prompt, più il modello si restringe e accorcia le frasi. Lascialo scrivere liberamente, poi ispeziona meccanicamente tramite Hook immediatamente dopo l'output del file. In caso di violazione, non limitarti a sostituire parole—fai riscrivere l'intera frase contenente il problema. Separare scrittura e ispezione è la chiave per mantenere il ritmo.
Passaggio 5. L'umano rifinisce il finale 10%
Non puntare a 100 punti solo con l'IA. Lascia il 90% dello scheletro all'IA, e lascia che gli umani aggiustino il restante 10% di respiro e texture. Registrare le correzioni e retroalimentarle nei futuri prompt o regole di ispezione.
Skill consigliate
Presento anche strumenti essenziali nati dalla community e skill che migliorano la qualità dei documenti in giapponese, che attualmente utilizzo io stesso.
natural-japanese (@techtalkjp**
Una Agent Skill nata dall'intuizione che "l'odore di IA si manifesta nel ritmo più che nel vocabolario" (GitHub Repo / Articolo esplicativo). Basata su corpora misurati di testo umano e di IA, rileva meccanicamente le variazioni nella lunghezza delle frasi (burstiness), scartando assunzioni tradizionali come "mancanza di finali nominali" o "poche ripetizioni iniziali di frase".
https://x.com/techtalkjp/status/2076808889371443679
japanese-tech-writing (@golden_lucky**
Un prompt trasformato in skill dalle prospettive di editing di libri commerciali (Gist / Post sul blog). Elimina il tono LLM che esagera la posizione senza aggiungere argomentazioni, come handle directly, dig deeper o nothing less than ~, regolando l'ordine e la collocazione del soggetto affinché i lettori comprendano in sequenza.
https://x.com/golden_lucky/status/2066751852088336698
Hooks × lint con buoni pattern (@yugen_matuni**
Un sistema che utilizza le funzioni Hook degli strumenti di coding AI (PostToolUse) per ispezionare immediatamente dopo la scrittura del file. Per le espressioni NG, restituisce specifici pattern di correzione (good) come "il vero valore risiede in ~" accanto, inducendo una riscrittura dell'intera frase.
https://x.com/yugen_matuni/status/2088251220452679951
Il mio ambiente di scrittura
Nel mio repository di scrittura, ho sperimentato il fallimento dove "più regole aggiungevo, più le frasi si accorciavano e l'odore di IA tornava". Aggiungere convenzioni faceva ritirare l'IA in frasi sicure e brevi.
Da ciò ho derivato il principio di design: "Non ridurre le regole; separa le loro ubicazioni."
1[Flusso generale di scrittura]23[Input] style-guide / voice-samples / edit-patterns (solo criteri di giudizio)4 ↓5[Esecuzione scrittura] writer (Gemini 3.8 Flash)6 ↓7[Ispezione automatica] PostToolUse Hook (rifiuto via detect-ai-smell.js)8 ↓9[Giudizio di qualità] reviewer (valutazione oggettiva basata su rubric.md)10 ↓11[Rifinitura finale] Aggiustamento umano & pubblicazione (retroalimentare i diff alle regole)
1kgsi-note-documents_v2/2├── CLAUDE.md # Politica operativa, modalità di scrittura, permessi agente3├── GOVERNANCE.md # Limiti di dimensione per materiali di riferimento, tre ubicazioni di archiviazione4├── style-guide.md # Stile di scrittura di Kogiso (solo descrizioni di giudizio, max 4.500 caratteri)5├── references/6│ ├── voice-samples.md # Campioni di stile (estratti di paragrafi per funzione)7│ ├── edit-patterns.md # Registro delle correzioni manuali (prima→dopo)8│ └── rubric.md # Criteri di valutazione del reviewer (benchmark di distanza)9├── human-bench/ # 5 articoli passati scritti da umani (writer non legge; soglia per ispezione macchina)10├── scripts/11│ ├── detect-ai-smell.js # Gate di ispezione macchina (regex, controllo densità, con pattern 'good')12│ ├── clean-japanese-spacing.js # Rimozione automatica spazi a larghezza intera tra caratteri giapponesi/occidentali13│ └── hooks/ # Script per PostToolUse Hooks ecc.14├── editor/ # Editor locale anteprima stile note & revisione15└── note/ # Corpo dell'articolo (bozze finali)
Questa è la schermata del mio editor locale personalizzato (note-editor). Le modifiche a sinistra si riflettono istantaneamente nell'anteprima centrale equivalente alla produzione di note, e la revisione parziale tramite IA delle selezioni può essere effettuata dal pannello destro.
Editor personalizzato. Avviato con comando /note-editor
Tre ubicazioni di archiviazione e separazione dei permessi
- Livello di internalizzazione (letto dal writer):
style-guide.md,voice-samples.md. Descrive sottilmente solo i criteri di giudizio del writer (max 4.500 caratteri). - Livello macchina (scansionato automaticamente da Hook):
scripts/detect-ai-smell.js. Nessun limite di caratteri. Aggrega divieti rilevabili via regex e politiche di correzione (good). - Livello di giudizio (letto dal reviewer):
references/rubric.md. Un agente separato valuta indipendentemente la distanza tra la bozza finita e l'obiettivo.
Per prevenire il gonfiamento, quando la guida supera l'80% del suo limite, cancelliamo una quantità di vecchie regole pari a qualsiasi nuova regola aggiunta.
Estratti da file reali
Ecco parti core estratte da file effettivamente in uso.
`GOVERNANCE.md` (Principi di gestione di ubicazione e limiti)
1Se i materiali letti da writer e reviewer si gonfiano, le frasi si accorciano cercando di seguire le regole, e l'odore di IA torna.2In questo ambiente, il principio è "le regole non sono ridotte, ma ricollocate", con limiti impostati per ubicazione.34[Tre ubicazioni di archiviazione]5- Livello di internalizzazione (letto dal writer): style-guide.md, voice-samples.md, edit-patterns.md6 → Mantenere sottile. Solo descrizioni di giudizio. Non trasformare in checklist7- Livello macchina (scansionato automaticamente da Hook): ispezioni in scripts/detect-ai-smell.js8 → Nessun limite. Tutti i divieti scrivibili via regex vanno qui9- Livello di giudizio (letto dal reviewer): references/rubric.md, references/voice-samples.md10 → I criteri di distanza sono estratti. Un template per tipo solo quando confuso
`scripts/detect-ai-smell.js` (Ispezione macchina e contrasto 'good')
1// Estratto di detect-ai-smell.js2const CHECKS = [3 {4 name: "Espressioni evasive / Atteggiamento non committente",5 patterns: [/一概には言え|メリットもデメリットも|一長一短|状況によります|と言えるでしょう|と考えられます/g],6 limit: 1,7 gate: true,8 good: "Scegli una parte e dichiarala fermamente, collocando una frase di evidenza immediatamente dopo. Non chiudere presentando entrambe le parti",9 },10 {11 name: "Cliché di anteprima 'Ciò che è importante è...'",12 patterns: [/重要なのは|大事なのは/g],13 limit: 1,14 gate: true,15 good: "Scrivi il contenuto direttamente senza anteprime. 'Ciò che è importante è X' → 'X è. Perché ~'",16 },17 {18 name: "Cartelli di contrasti astratti",19 patterns: [/という構図です|デザイン思考/g],20 limit: 1,21 gate: true,22 good: "Scrivi i contrasti come azioni di chi fa cosa. 'Struttura di A e B' → 'A fa ~. B non fa ~'",23 },24];
`style-guide.md` (Istruzioni premessa al writer)
1Questa guida non è una checklist. Se ti chiedi "Sto violando le regole?" mentre scrivi, l'odore di IA torna.2Quando scrivo articoli, queste operano come premesse internalizzate.34Prima di iniziare, verbalizza quanto segue:51. Chi sto interpretando adesso (es., designer che tocca l'IA in pratica)62. Su quale reazione sto scrivendo (Aspettativa → Realtà → Gap)73. Come chiuderò (Lasciare domande irrisolte o affermare una posizione e concludere)84. Design dell'intonazione. Quali sezioni enfatizzare, quali scorrere in una sola frase
Conclusione
Non importa quanto elaborato sia l'harness o eccellente il modello scelto, se non c'è "specificità grezza" dentro lo scrittore umano, il testo non sta in piedi.
L'IA sputa cliché perché gli umani non hanno fornito materiale come "cosa hanno vissuto e cosa sembrava sbagliato". Istruzioni astratte producono solo platitude astratte.
"Quando l'ho toccato davvero, era più semplice del previsto e deludente"
"Ho sentito un po' di sollievo quando la pull request è passata tardi la notte"
Solo quando ci sono semi di osservazioni in carne ed ossa, numeri e nomi propri, il potere espressivo di Gemini 3.8 Flash e l'ispezione automatica basata su Hook brillano davvero.
La scrittura con IA non è automazione pigra, ma un tentativo editoriale di consegnare efficientemente il tuo proprio disagio ai lettori. Prova a iniziare rivedendo la riga che hai appena scritto.
Nota: Questo articolo stesso è stato scritto basandosi sull'ambiente di scrittura spiegato qui.
