La guida ufficiale di 5 minuti all'IA su Obsidian: l'elemento mancante di cui hai bisogno

Il CEO dell'azienda che sviluppa Obsidian ha rilasciato un manuale di istruzioni gratuito per l'AI.

Puoi trovarlo qui:

https://github.com/kepano/obsidian-skills

Contiene solo 5 file di testo. Bastano 5 minuti per installarlo e non romperà nessuna delle tue note esistenti.

Aggiungendoli, l'AI comprenderà la formattazione specifica di Obsidian. Questa è la risposta ufficiale al problema dell'AI che mi rovina le note.

Quando ho visto che stava diventando l'argomento del momento e ho aperto il mio ambiente per installarlo, mi sono reso conto che era già lì...

La data del file era il 26 aprile. L'avevo installato tre mesi e mezzo fa e me ne ero completamente dimenticato (lol).

Quindi, cosa è cambiato nel mio Obsidian in quei tre mesi e mezzo? Ero curioso, ma i risultati sono stati piuttosto deludenti.

Per arrivare alla conclusione: le istruzioni ufficiali da sole non bastano. C'è un'altra pagina che devi scrivere tu.

Ciò che l'AI non conosce è la sintassi specifica di Obsidian

Obsidian ha diverse funzionalità uniche che lo distinguono dalle normali app per appunti.

Per collegare le note, le racchiudi tra [[ ]]. (Collegamenti)

Per far risaltare una nota, usi una sintassi specifica per creare un riquadro colorato. (Callout)

La parte superiore del file contiene una sezione per date e tag. (Proprietà)

L'AI scrive senza conoscere tutto questo. Quindi, anche se il testo può essere corretto, quando lo apri in Obsidian i collegamenti non vengono riconosciuti, o i riquadri non appaiono.

I 5 file che ho linkato all'inizio colmano questa lacuna. Sono così suddivisi:

• obsidian-markdown (Sintassi corretta per collegamenti e riquadri)
• obsidian-bases (Organizzare le note come una tabella di database)
• json-canvas (Creare diagrammi che collegano le note con linee)
• obsidian-cli (Cercare nell'intero vault tramite comandi)
• defuddle (Importare pagine web come note pulite)

Puoi scaricarli gratuitamente dal link qui sopra.

Non sono specifici per un singolo strumento di AI, quindi funzionano allo stesso modo con Claude Code o Codex.

Dopo 3,5 mesi di installazione non è cambiato quasi nulla

Ho riso davvero quando li ho trovati. Avevo già le famose istruzioni... e non me ne ero nemmeno accorto (lol).

Tuttavia, dato che funzionavano solo in Claude Code, il 9 agosto ho copiato gli stessi 5 file in Codex per poterli usare da entrambi.

Ora, il punto principale.

Cosa è cambiato nel mio Obsidian dopo tre mesi e mezzo?

• Note con callout: 32 su 1.387
• Viste database: 1
• Canvas: 1

Non è cambiato quasi nulla.

Non voglio dire che le istruzioni ufficiali siano scadenti. Ovviamente, il contenuto è ben fatto.

Quando le ho installate, le ho provate, ho pensato "Oh, comodo", e poi basta. Perché non avevo deciso quando usarle, questo è stato il risultato naturale.

Il motivo per cui non è cambiato nulla è chiaro: le istruzioni ufficiali insegnano il "come si scrive".

Sapere come scrivere non aumenta i contenuti che scrivi. E non decide nemmeno dove mettere le cose.

Esistono due tipi di istruzioni da dare all'AI

Penso che questo sia molto importante.

Esistono due tipi di manuali di istruzioni da dare a un'AI.

1. La sintassi corretta di Obsidian. È la stessa per tutti gli Obsidian, quindi il team ufficiale la fornisce.
2. Le tue regole interne. Dove mettere cosa. Quali aree è ok toccare. Dove devono finire i prodotti finiti.

Il team ufficiale fornisce solo la prima.

E la causa di un vault disordinato di solito è la seconda. È più problematico avere qualcosa scritto correttamente ma posizionato nel posto sbagliato che avere un errore di sintassi.

È qui che ti trovi nei guai senza "regole interne":

• Gli articoli finiti vengono salvati in una cartella diversa ogni volta.
• L'AI aggiunge testo a un diario che volevi mantenere di sola lettura.
• Anche se hai cambiato il nome di una cartella, le nuove note continuano ad apparire con il vecchio nome.

In tutti questi casi, la sintassi è perfetta. Solo il posizionamento e la gestione sono sbagliati.

Per esempio, le istruzioni ufficiali dicono: "Collega le note correlate con dei link". Ed è corretto.

Ma la mia regola è l'opposto: collego solo le note che "aprirò sicuramente in seguito". Se aumento troppo i collegamenti, non trovo più nulla.

Non si tratta di chi ha ragione; è solo che la guida ufficiale non può tenere conto delle mie circostanze specifiche.

Per quanto tu usi l'AI, le tue risorse non aumenteranno da sole. Hai già i materiali; ti manca solo il "contenitore".

Le istruzioni ufficiali ti insegnano la "forma" del contenitore, ma devi decidere tu cosa mettere dove.

━━━━━━━━━━━━

Per chi usa l'AI ma scopre che la creazione di contenuti non sta diventando più facile:

Smetti di partire da zero ogni volta tenendo i tuoi materiali in un unico posto.

Ho avviato il "Diario di implementazione Obsidian x AI Agent di Minami".

Leggilo gratis qui ↓

https://lifebaselab-m.com/p/r/j8MTvDdP?free1=x

━━━━━━━━━━━━

I 4 elementi minimi per le tue regole interne

Ho creato un unico file in Obsidian chiamato "Regole operative" e ci ho scritto tutto. Sia Claude che Codex lo leggono prima di iniziare a lavorare.

Ecco i 4 elementi che, come minimo, fanno girare le cose:

1. Aree da toccare vs. aree di sola lettura. Nel mio caso, diari, clip web e note non categorizzate sono di sola lettura. Questa è la parte più importante.
2. Destinazione dei lavori finiti. Fissa le posizioni: i post per X vanno qui, gli articoli per Note vanno lì. Questo evita che l'AI chieda ogni volta.
3. Via di fuga quando sei indeciso. Se non sei sicuro per 3 secondi, mettilo in "Non categorizzato". Questo evita di bloccarsi sulla classificazione.
4. Scegli un unico posto per fissare le regole. Non scrivere regole operative in note sparse. Fissa il file principale.

Soprattutto il quarto punto. Senza questo, le regole si disperdono ovunque e perdi traccia di quale sia la versione più recente.

Faccio controlli settimanali per evitare che finisca solo con l'installazione

Tra i 5 file menzionati prima c'è obsidian-cli, che ti permette di ispezionare l'intero vault con i comandi. Trova note orfane, conteggi di utilizzo dei tag e collegamenti interrotti.

È utile, ma non funziona se non lo esegui.

Quindi, ho impostato questa "ispezione" per farla girare automaticamente come controllo settimanale. Viene eseguita da sola ogni domenica mattina e produce un report dei potenziali collegamenti interrotti e delle note trascurate.

Il vantaggio più grande è non doversi ricordare di farlo.

Averlo installato e averlo in funzione sono due cose diverse.

Lo dico io, che l'ho avuto installato per tre mesi e mezzo senza che cambiasse nulla, quindi probabilmente ho ragione (lol).

In conclusione

Installare le istruzioni ufficiali richiede 5 minuti. È gratuito e non rompe le tue note. Non c'è alcun danno nel farlo.

Ma cambia solo la sintassi.

Il motivo per cui Obsidian diventa un caos quando lo lasci all'AI non è che sei scarso nell'usarlo. È solo che non hai ancora un unico file di "regole interne" che l'AI possa leggere.

Quindi, non sentirti obbligato a memorizzare tutto prima di delegare. Il team ufficiale fornisce la sintassi; tu devi solo scrivere una pagina.

Se lo farai oggi, inizia scrivendo una riga per separare dove l'AI può toccare e dove non può. "La cartella del diario è di sola lettura. Non riscriverla" è sufficiente.

Anche solo questo ridurrà significativamente le correzioni che dovrai fare dopo che l'AI ha finito.

━━━━━━━━━━━━

Grazie per aver letto fino alla fine!

Annuncio 📢

Sto gestendo un'Open Chat!

Con l'obiettivo di aumentare gli "Obsidian", condivido storie quotidiane su Obsidian x AI Agent che non pubblico su X.

Distribuisco anche dei regali, quindi se sei interessato, dai un'occhiata ↓

https://x.gd/RsRSpz