Come far sì che Codex ti capisca meglio: padroneggia queste tecniche di memoria per aumentare l'efficienza del 90%

Dopo aver usato l'app Codex per un po', è probabile che tu abbia incontrato frustrazioni simili: dover ripetere le stesse preferenze ogni volta che inizi una nuova conversazione, o vedere Codex eseguire accidentalmente comandi di sistema oltre le tue aspettative.

L'essenza di questi problemi frequenti è che il tuo Codex non ha una memoria stabile a lungo termine. Per risolvere completamente queste comunicazioni ripetitive inefficaci, devi costruire un sistema di memoria completo.

Questo articolo ti mostrerà come configurare AGENTS.md e la funzione Memorie per dare a Codex una memoria persistente, facendogli capire veramente le tue intenzioni e ottenere un guadagno in efficienza.

1. AGENTS.md

1. Cos'è?

AGENTS.md è un insieme di istruzioni predefinite che Codex legge automaticamente ogni volta che si avvia.

Senza AGENTS.md, Codex parte ogni volta da zero: non conosce le tue abitudini di lavoro, il contesto del progetto o i limiti per l'esecuzione delle operazioni.

Una volta configurate le regole pertinenti, questi contesti diventano permanenti e non dovrai mai più spiegare lo stesso problema.

2. Come configurarlo e usarlo

1️⃣ Livello Globale: Memorizzato nella directory ~/.codex/AGENTS.md sul tuo computer locale, si applica a tutti i tuoi progetti. Adatto per scrivere preferenze personali globali e regole generali.

Nell'app Codex, questo corrisponde alla sezione "Istruzioni personalizzate" nella pagina delle impostazioni di Personalizzazione.

Ecco un modello di base consigliato che puoi copiare e incollare direttamente nella posizione mostrata sopra, e poi modificare continuamente in base alle tue esigenze:

1# AGENTS.md
2
3## Comportamento di Base
4
5- Rispondere in italiano per impostazione predefinita, a meno che l'utente non richieda esplicitamente un'altra lingua.
6- Le risposte devono essere concise e dirette, evitando riempitivi e ripetizioni inutili.
7- Se la descrizione del compito non è chiara, chiedere conferma prima di iniziare l'esecuzione.
8- Non speculare attivamente su bisogni al di là dell'intenzione dell'utente; fare solo ciò che viene richiesto.
9
10## Limiti di Sicurezza
11
12- Impostazione predefinita di sola lettura; non modificare o eliminare attivamente alcun file a meno che non sia esplicitamente richiesto dall'utente.
13- Prima di coinvolgere operazioni irreversibili (come eliminazione, sovrascrittura o chiamata di API esterne per scrivere), è necessario ottenere prima la conferma.
14- Non stampare alcuna chiave, token o credenziale sensibile nell'output.
15
16## Standard di Ingegneria
17
18- Evitare un'eccessiva ingegnerizzazione; apportare solo le modifiche esplicitamente richieste o ovviamente necessarie per il compito, mantenendo la soluzione semplice.
19- Non aggiungere funzionalità, rifattorizzare il codice o eseguire ottimizzazioni extra a meno che non venga richiesto.
20- Non aggiungere commenti, annotazioni di tipo o docstring al codice non modificato.
21- Aggiungere commenti solo quando la logica non è autoesplicativa.
22- Non aggiungere gestione degli errori o logica di fallback per scenari improbabili.
23- Non creare funzioni di utilità o livelli di astrazione utilizzati una sola volta.
24- Eliminare direttamente il codice confermato come inutile; non lasciare commenti esplicativi.

2️⃣ Livello Progetto: Memorizzato nella directory del progetto, utilizzato principalmente per personalizzare le regole in base al tema e alle caratteristiche del progetto.

Un buon AGENTS.md a livello di progetto dovrebbe generalmente coprire i seguenti aspetti:

• Contesto e struttura del progetto: cos'è il progetto e dove si trovano le directory importanti.
• Metodi di esecuzione: come avviare, eseguire o gestire il progetto.
• Standard e vincoli: standard da seguire e cose che non si possono assolutamente fare.
• Criteri di completamento: come determinare se un'attività è finita.

3. Migliori Pratiche per AGENTS.md

Configurare un AGENTS.md di base è solo il primo passo. I seguenti principi pratici determinano il limite superiore del tuo sistema di memoria:

1️⃣ Stratificazione delle Regole, Responsabilità Chiare

In Codex, AGENTS.md segue il principio di prossimità: Sottodirectory > Directory Radice > Globale. Ciò significa che le regole nella directory in cui si trova il lavoro corrente hanno la priorità più alta.

Questo implica che le regole a livello di progetto sovrascriveranno direttamente le impostazioni globali dello stesso tipo. Se tutte le regole sono mescolate insieme, le regole locali ad alta priorità possono facilmente inquinare o distruggere accidentalmente la logica globale di base.

Pertanto, un sistema di memoria basato su regole dovrebbe seguire il principio della "separazione delle responsabilità": il livello globale contiene solo regole generali, come preferenze linguistiche, limiti di sicurezza e abitudini comportamentali di base; il livello del progetto contiene specifiche specifiche per quel progetto, come comandi di build, convenzioni di codice e descrizioni dei moduli.

I due svolgono i loro compiti senza interferire l'uno con l'altro e non si verificheranno conflitti quando vengono uniti.

2️⃣ Iniziare dalle Basi, Iterare secondo Necessità

AGENTS.md non deve essere scritto tutto in una volta. Inizia con le regole più fondamentali. Quando Codex commette lo stesso errore, chiedigli direttamente di rivedere e aggiornare le regole, ad esempio:

"Hai appena commesso lo stesso errore dell'ultima volta. Per favore, riassumi il motivo e aggiungi l'esperienza pertinente in AGENTS.md."

In questo modo, le regole provengono sempre da veri attriti d'uso e AGENTS.md si evolverà continuamente con l'uso.

3️⃣ Mantenerlo Snello, Separare i Contenuti Complessi

Con l'approfondimento dell'uso, il contenuto di AGENTS.md potrebbe aumentare. A questo punto, non c'è bisogno di ammassare tutto in un unico file. Invece, scrivi il contenuto per argomenti specifici in file indipendenti e poi referenziali nel file principale.

Ad esempio, scrivi la descrizione dell'architettura del progetto separatamente come ARCHITECTURE.md e includi solo un riferimento di una riga in AGENTS.md:

"Per l'architettura principale e le specifiche delle directory di questo progetto, fare riferimento al file ARCHITECTURE.md nella directory corrente."

2. Funzione Memorie

Oltre a configurare attivamente le regole pertinenti, Codex supporta anche una funzione di memoria attiva, che deve essere abilitata in Impostazioni - Personalizzazione - Memoria, come mostrato di seguito:

Dopo aver attivato l'interruttore, Codex riassumerà attivamente le informazioni utili e le preferenze chiave dalla conversazione in memoria. Se vuoi vedere quali memorie ha aggiunto il tuo Codex, puoi aprire il file Memory.md in ~/.codex/memory per visualizzare il contenuto della memoria aggiunto dal tuo Codex. Ecco il mio:

Per Concludere

Costruire un sistema di memoria è un processo che si evolve nel tempo. Credimi, finché perseveri nel migliorare e aggiornare le regole d'azione e accumuli continuamente ricordi, Codex diventerà rapidamente lo strumento di produttività più potente che ti capisce meglio e che è più comodo da usare.