La programmazione con AI rende l'implementazione sempre più veloce.
Molti di voi si troveranno probabilmente in una situazione in cui gli umani non riescono più a tenere il passo con la revisione di tutte le implementazioni.
Come soluzione, questo articolo spiega l'ultima versione di una Skill fatta in casa chiamata codex-review, che assegna il ruolo di revisione a un sub-agente Codex e ripete correzioni e revisioni fino a quando i problemi importanti non vengono risolti.
Una Skill Creata Sei Mesi Fa
In realtà, le fondamenta di questa Skill sono state create circa sei mesi fa. L'ho migliorata poco a poco e continuo a usarla regolarmente.
https://x.com/makaneko_AI/status/2005475035075707092
La versione precedente era stata introdotta come metodo in cui Claude Code gestiva l'implementazione e Codex veniva chiamato come revisore per ripetere correzioni e ri-revisioni. All'epoca, Claude Code era forte nei compiti di implementazione, e Codex era semplicemente "intelligente", quindi aveva quella configurazione.
Tuttavia, l'ambiente AI è completamente cambiato. Ora Codex è più forte nell'implementazione e più intelligente (tranne per Fable 5), e molte persone probabilmente completano i compiti di implementazione con il solo Codex.
Per adattarmi a questo ambiente, ho rinnovato il contenuto in modo che il ciclo giri all'interno di Codex.
Tre Cose Cambiate nell'Ultima Versione
Il flusso di base rimane lo stesso della versione precedente.
Separare il responsabile dell'implementazione e il responsabile della revisione ↓ Il revisore lo esamina in modalità sola lettura ↓ Fallimento se vengono sollevati punti importanti ↓ Correzione ↓ Ri-revisione usando lo stesso metodo ↓ Iterare fino al superamento
I punti chiave dell'ultima versione sono i seguenti tre:
1. Ottimizzato per GPT-5.5
2. Concentrarsi sui problemi importanti
3. Precisione complessiva migliorata
Li spiegherò in ordine.
1. Ottimizzato per GPT-5.5
Al 18/06/2026, l'ultima serie GPT-5.5 di OpenAI è posizionata come un modello forte nel coding basato su agenti e nel lavoro pratico. È descritto come in grado di procedere autonomamente anche con compiti ambigui e multi-step.
Guardando la guida ufficiale di GPT-5.5, dice cose come "funziona meglio se scrivi i risultati desiderati in modo conciso piuttosto che stipare procedure dettagliate."
Pertanto, nell'ultima versione, ho smesso di elencare template dettagliati e ho rafforzato le regole che il revisore deve seguire.
https://x.com/makaneko_AI/status/2049848091860463995
2. Concentrarsi sui Problemi Importanti
Codex aveva la tendenza a fare osservazioni dettagliate sfruttando la sua intelligenza, nel bene e nel male.
Quindi, nell'ultima versione, ho detto esplicitamente al revisore di "raccogliere solo problemi equivalenti a P0/P1 (priorità massima/alta) e non gestire piccole questioni stilistiche."
Grazie a questo, le inutili correzioni minori ripetitive sono diminuite, rendendo più facile procedere senza intoppi.
3. Precisione Complessiva Migliorata
Ho migliorato la precisione complessiva nei piccoli dettagli.
Ad esempio, ho chiuso le scappatoie in cui una revisione si fermava a metà ma veniva comunque segnata come superata. I casi in cui il revisore non riusciva ad avviarsi o il rapporto restituito era corrotto e illeggibile non vengono più marcati come superati.
Anche quando una modifica grande viene condivisa tra più revisori, l'intero processo passa solo se tutti restituiscono un passaggio e non ci sono aree non revisionate o revisioni fallite. Questi miglioramenti hanno ridotto il rischio di perdere problemi durante la revisione.
Utilizzo Consigliato
Questa Skill è configurata per attivarsi automaticamente dopo la progettazione delle specifiche o un'implementazione medio-grande, ma si consiglia di impostarla per l'avvio automatico al momento desiderato dall'utente.
Ad esempio, nel file AGENTS.md che Codex legge sempre per primo, aggiungi "Esegui la revisione di Codex quando...". Oppure, se esiste un formato per il piano di implementazione, incorporalo come passaggio obbligatorio.
L'articolo della versione precedente spiega anche quest'area.
https://note.com/makaneko_ai/n/n3cefcec49e2d
Testo Completo della Skill "codex-review"
Scala | Criteri | Strategia |
|---|---|---|
piccola | ≤3 file, ≤100 righe | diff 1 esecuzione |
media | 4-10 file, 100-500 righe | arch → diff 1 esecuzione |
grande | >10 file, >500 righe | arch → diff (esecuzioni multiple in parallelo) → cross-check |
{
"ok": false,
"summary": "Sommario della revisione",
"issues": [
{
"file": "src/auth.py",
"lines": "42-45",
"problem": "Descrizione del problema",
"recommendation": "Piano di correzione",
"verification": "Metodo di verifica dopo la correzione"
}
],
"notes_for_next_review": "Note"
}
``text
## Ciclo di Correzione
Se ok=false, itera fino a max_iters volte. Il valore predefinito è max_iters=5.
1. Analizza issues e crea un piano di correzione.
2. L'implementatore corregge con il minimo diff (lascia le modifiche alle specifiche come problemi irrisolti).
3. Esegui test, linter o verifiche alternative in base al rischio della modifica. Se non eseguito, lascia il motivo; se non verificato sul percorso critico, trattalo come bloccante.
4. Ri-revisione nella stessa modalità.
Condizioni di arresto:
- ok=true: passaggio del gate
- max_iters raggiunto: fallimento del gate
- Test fallito due volte di fila: fallimento del gate
- Fallimento del revisore / fallimento del parsing JSON / carenza nel formato dell'output / area non revisionata presente: fallimento del gate
Se ci si ferma per fallimento del gate, riporta i problemi bloccanti rimanenti, le aree non revisionate e le verifiche fallite come irrisolti nel rapporto finale.
## Fallback /review
Usa /review solo se il gate JSON fallisce. /review è un ausilio per la scoperta e il suo output non deve essere usato come base per ok=true così com'è.
## Regole sugli Errori
- Se il Revisore non riesce a stabilirsi, registra nel rapporto finale il motivo del fallimento, il percorso del revisore tentato e l'intervallo non revisionato.
- Non rilassare il vincolo di sola lettura del Revisore.
- In caso di input eccessivo o timeout, puoi riprovare riducendo l'intervallo o suddividendo.
## Esempio di Rapporto Finale
Questo è un esempio in cui rimangono aree non revisionate, non un template completo.
``text
Risultati della Revisione Codex
- modalità: gate JSON o /review
- ambito_revisione: diff del branch
- Scala: grande (12 file, 620 righe)
- Parallelo: 3 sub-agenti
- percorso revisore: spawn_agent prima
- prove fallback: nessuna
- Iterazione: 2/5
- Gate revisione: ok=false
- motivo: ambito_non_revisionato non è vuoto
- Prova completamento: push/merge/release/completamento attività ecc. sono confermati separatamente
Cronologia Correzioni
- auth.py: Aggiunto controllo autorizzazione
Non Revisionato
- utils/legacy.py: Timeout di Codex, necessaria ri-revisione
Irrisolti
- main.py: Contenuto, rischio, azione consigliata ``` # Sommario L'ultima versione della Skill codex-review non riguarda solo il far girare la versione precedente all'interno di Codex. È stata privata di passaggi non necessari per adattarsi all'attuale Codex e GPT-5.5, e le regole da seguire come gate di revisione sono state chiarite. Un meccanismo che revisiona e corregge autonomamente è molto comodo, quindi prova a introdurlo. --- Se hai trovato utile questo articolo, ti sarei grato se lo seguissi e condividessi. Continuo a condividere modi non solo per usare l'AI, ma per far lavorare l'AI in modo autonomo. Post Correlati https://x.com/makaneko_AI/status/2058739339606233492 https://x.com/reach_vb/status/2058538305872949490 https://x.com/makaneko_AI/status/2064299466182607161
