Ha avuto discreto successo, in questi giorni, una serie di istruzioni (“The Anatomy of a Claude Prompt” di Ruben Hassid). Ho incollato proprio su una chat di Claude quelle istruzioni chiedendo quanto fossero valide, e Claude ha notato alcuni errori e esagerazioni. Così ho chiesto all’AI in questione di scrivere la versione corretta delle istruzioni, e di farlo in italiano.
Riporto di seguito i consigli che ha così prodotto (con mie correzioncine).
1) Compito (Cosa vuoi ottenere)
Definisci chiaramente il compito e i criteri di successo. Sii specifico su cosa significa un buon risultato.
"Voglio [COMPITO] in modo che [CRITERI DI SUCCESSO]."
2) Ruolo
Assegnare un ruolo a Claude può orientare il tono, il livello tecnico e la prospettiva della risposta. Non è indispensabile, ma utile quando il contesto lo richiede.
"Rispondi come uno sviluppatore esperto che revisiona codice in produzione."
3) Documento di contesto
Caricare file con regole, stile e contesto è molto più efficiente che scrivere tutto nella chat. Claude legge e segue documenti strutturati con grande affidabilità.
es.: "Prima di rispondere, leggi completamente questi file: [nome_file.md] - [cosa contiene]."
4) Riferimenti ed esempi
Mostrare un esempio del risultato desiderato è uno dei consigli più efficaci. Definisci pattern, tono e struttura come regole esplicite invece di sperare che Claude li intuisca.
es.: "Ecco un esempio del formato che voglio: [esempio]. Segui questa struttura."
5) Istruzioni specifiche
Specifica il tipo di output, la lunghezza attesa e cosa evitare. Per task complessi dedica il tempo necessario a strutturare bene il prompt con compito + contesto + esempio, e risparmierai molte correzioni successive.
es.: "Output: lista di 5 punti. Non usare linguaggio formale. Il risultato deve essere leggibile in 30 secondi."
6) Domande di chiarimento
Se il compito è ambiguo, chiedi a Claude di fare domande prima di procedere.
es.: "Non iniziare subito. Prima di iniziare ponimi le domande per ogni chiarimento che ritieni necessario e aspetta la mia risposta."
7) Piano di esecuzione
Per compiti complessi, chiedi a Claude di esplicitare il piano prima di agire. È un ottimo modo per verificare che le istruzioni siano state comprese correttamente.
es.: "Prima di scrivere qualsiasi cosa, elenca le regole più rilevanti per questo compito e mostrami il tuo piano di esecuzione."
Per approfondire: la documentazione ufficiale sul prompt engineering per Claude è su docs.claude.com.
