Problemi Comuni con Codex
Un problema frequente con Codex è la tendenza a progettare o implementare cose con termini definiti in modo approssimativo. Nella mia esperienza, questo è leggermente meno comune con Claude, ma con Codex era un problema nella 5.5 e persiste nella 5.6. Questa è una contromisura per quel problema.
Per esempio, una sezione di un report di ricerca aveva un'intestazione chiamata "Punto di Compressione." Leggendo il corpo, il termine oscillava tra tre significati: "quando la cronologia della conversazione raggiunge una quantità prestabilita," "la soglia per avviare la sintesi automatica," e "il momento effettivo in cui la sintesi inizia." La scrittura era fluida e sembrava una spiegazione tecnica. Tuttavia, nel momento in cui un singolo termine fungeva da condizione di partenza, da valore e da evento, il soggetto della spiegazione diventava indefinito. Di conseguenza, i risultati della ricerca venivano purtroppo indirizzati nella direzione sbagliata.
Innescato da questo fallimento, ho creato una skill chiamata semantic-generation. Anche se il nome sembra una tecnica di generazione di testo, ciò che ho effettivamente cambiato è stata la definizione delle parole prima di scrivere il testo.
Struttura e Impatto del Problema
C'è il problema che il termine giapponese "Punto di Compressione" è intrinsecamente poco chiaro, ma quando è stato fatto notare a Codex, ha prima cercato di risolverlo come una mancanza di spiegazione e poi come un problema di espressione dell'intestazione. Non si è reso conto immediatamente di aver confuso una condizione di partenza con un evento di esecuzione.
Nella stessa sessione, è successo qualcosa di simile. Poiché la causa non era ancora nota, il piano era condurre un test, isolare la causa dai risultati e poi scegliere una contromisura. Codex ha riassunto questo come "raccogliere le osservazioni in un unico punto."
L'obiettivo della raccolta non erano le osservazioni stesse. Erano i valori o i record ottenuti dal test. Inoltre, raccogliere valori non era l'obiettivo, ma un mezzo per isolare la causa.
Riassumendolo in una frase breve, la seguente sequenza è scomparsa:
- La causa non è ancora nota.
- Condurre un test.
- Isolare la causa dai risultati.
- Scegliere una contromisura dopo l'isolamento.
"Raccogliere le osservazioni in un unico punto" sembra plausibile. Poiché sembra plausibile, cela parti non organizzate e diventa la premessa per la progettazione successiva.
Le Liste di Correzione per i Termini Originali Non Possono Fermarlo
Quando si consideravano i miglioramenti, è stata fatta una proposta per registrare la corrispondenza tra parole corrette e significati e trasferirla alla sessione successiva.
Ciò che voglio fermare non è "usare di nuovo una parola precedentemente sbagliata." È mettere una parola al primo posto mentre l'obiettivo è ambiguo e procedere con il pensiero basato su quella parola. Anche se si crea una lista di parole errate, una parola coniata diversa nascerà la prossima volta.
Pertanto, invece di parole corrette, ho cambiato la politica per creare parole candidate prima di creare termini originali all'inizio di ogni sessione.
Contromisura) Forzare la Creazione di una Lista di Parole Candidate Prima della Progettazione
Ho deciso di far creare all'IA una tabella di corrispondenza per termini definiti in modo univoco, e poi eseguire la progettazione dopo aver caricato quel file.
La tabella di corrispondenza ha le seguenti sette colonne:
- Fonte
- Scopo
- Oggetto Concreto
- Ruolo
- Contesto
- Parola Candidata
- Definizione Iniziale
L'ordine delle colonne è significativo. La parola candidata è all'estrema destra e non può essere compilata finché l'oggetto concreto e il ruolo non sono scritti.
Se la parola candidata fosse all'estrema sinistra, si potrebbe scrivere prima la parola "Punto di Compressione" e poi creare una spiegazione che si adatti a quella parola in seguito. Questo riprodurrebbe semplicemente l'ordine di generazione che voglio fermare all'interno della tabella.
Anche i ruoli sono posizionati uno per riga. Se si vuole gestire una condizione di partenza e un evento con la stessa parola, si dividono le righe. Quindi, prima della pressione di "finirlo in una parola," il fatto che ci siano due oggetti in gestione diventa visibile.
Facendo così, l'IA generativa stessa può notare quando le parole diventano ambigue, e sono stato in grado di proibire attivamente l'uso di parole mentre rimangono ambigue.
Riepilogo
L'IA generativa non è brava a mantenere uno spazio vuoto vuoto. Anche se l'obiettivo o lo scopo non sono ancora determinati, può continuare il testo se viene posizionata una parola plausibile. Quella fluidità può essere pericolosa nella progettazione.
semantic-generation non è una skill per trovare buone parole. È una skill per far fermare l'IA per un momento e scegliere parole appropriate quando cerca di usare un termine originale.
Qual è l'obiettivo? È una condizione, uno stato o un evento? Per quale scopo viene gestito, e cosa succede dopo cosa?
Solo per le righe scritte fino a quel punto diamo finalmente un nome alla fine. A prima vista, sembra una deviazione, ma è più breve che ricostruire l'intera progettazione da una singola parola come "Punto di Compressione."
skill semantic-generation
1---2name: semantic-generation3description: |4 Una procedura di generazione in cui, prima di scrivere il documento di destinazione (materiali di progettazione, progettazione da requisiti, report di ricerca, piani di isolamento delle cause, piani di contromisura, naming, riepilogo dell'ordine di ragionamento), viene prima presentata una tabella di corrispondenza (tabella dei referenti) come deliverable indipendente per fissare il referente e il ruolo prima della parola.5 Trigger: Scrittura di materiali di progettazione, creazione di documenti di progettazione, scrittura di report di ricerca, scrittura di piani di contromisura, naming, decisione di nomi di stato/nomi di condizione/nomi di tipo/nomi di metodo, riepilogo dell'ordine di ragionamento, tabella dei referenti, tabella di corrispondenza.6 NON ATTIVARE: Citazione di testo originale dell'utente, semplice modifica meccanica, riutilizzo di nomi esistenti, output fisso, chiacchiere, frasi brevi che possono essere scritte solo con termini consolidati.7---89# semantic-generation — Procedura per fissare l'obiettivo prima della parola1011Se una parola (spesso una parola coniata sul momento) viene posizionata per prima mentre l'obiettivo è ambiguo, e il pensiero procede basandosi su quella parola, la discrepanza con il referente si propaga alle frasi in giapponese, alle frasi di progettazione e agli identificatori di codice senza essere corretta. Questa skill forza la sequenza di "presentare prima la tabella di corrispondenza in modo indipendente e scrivere il corpo come sua copia."12I criteri per la disciplina sono detenuti dalla regola [[referent-before-label]].1314## Criteri di Applicazione1516Usare quando si applica uno dei seguenti casi. Se non si riesce a giudicare, trattarlo come applicabile.17181. Scrittura di materiali di progettazione, progettazione da requisiti, report di ricerca, piani di isolamento delle cause o piani di contromisura.192. Naming (specifiche pubbliche, nomi di stato, nomi di condizione, nomi di evento, nomi di tipo per valori o record, nomi di metodo, nomi booleani).203. Tentativo di riassumere un ordine di ragionamento fornito dall'utente in brevi etichette di lavoro.2122## Flusso Normale2324### 1. Salvare prima la tabella di corrispondenza come deliverable indipendente (Invio in due fasi)2526Prima di scrivere un singolo carattere del corpo, salvare la tabella di corrispondenza come file indipendente.2728- Destinazione salvataggio: `referent-table-<slug>.md` nella directory di lavoro (se il deliverable è sotto `output/`, posizionarlo nella stessa directory).29- Registrare lo sha256 dopo il salvataggio (es., `shasum -a 256 <path>`). Questa registrazione diventa prova che "la tabella di corrispondenza è stata creata prima del corpo." Posizionare semplicemente la tabella all'inizio del documento completato non prova l'ordine di generazione.3031### 2. Formato della tabella di corrispondenza (Modifica dell'ordine delle colonne vietata)3233| Fonte | Scopo | Oggetto Concreto | Ruolo | Contesto | Parola Candidata | Definizione Iniziale |3435- **La parola candidata è fissata all'estrema destra. Mantenere la colonna della parola candidata vuota finché l'oggetto concreto e il ruolo non sono compilati.** Questo per rendere impossibile, attraverso il formato, l'ordine di decidere prima la parola e attribuire l'obiettivo dopo.36- Scegliere il ruolo da opzioni chiuse: `Condizione di Partenza / Stato / Evento / Valore / Record / Scopo / Mezzo`. Se la stessa parola si riferisce a più ruoli, dividere le righe.37- In "Contesto," scrivere l'ordine di ragionamento fornito dall'utente (es., Test → Isolamento → Contromisura) usando le parole del testo originale. Non mescolare con la colonna del ruolo.38- Le tabelle sono solitamente limitate a 1–6 righe. Se superate, dividere la tabella ai confini dove il significato cambia.39- Al completamento, confermare che il significato sia chiaro dalla sola colonna "Oggetto Concreto," anche se la colonna della parola candidata è nascosta.4041### 3. Compilare le parole candidate4243- Usare la terminologia dell'utente e la terminologia consolidata con la massima priorità.44- Quando si inseriscono altre nuove parole, scrivere "X si riferisce a..." nella colonna "Definizione Iniziale." Non introdurre parole per le quali non si possa scrivere una definizione; usare la descrizione dell'oggetto concreto così com'è nel corpo.4546### 4. Scrivere il corpo come copia della tabella di corrispondenza4748- Usare solo le parole elencate nella tabella di corrispondenza come vocabolario centrale del corpo.49- Mantenere la stessa corrispondenza attraverso i tre livelli di frasi in giapponese, elementi di progettazione e identificatori di codice (es., "Il volume della cronologia raggiunge 250K" = Condizione di Partenza → Nome Condizione / "La sintesi automatica inizia" = Evento → Nome Evento/Nome Metodo / "Sintesi automatica in corso" = Stato → Nome Stato. Ruoli diversi dovrebbero avere nomi diversi).50- Non usare etichette di lavoro (frasi nominali astratte che omettono scopo, obiettivo e giudizio) per framework o intestazioni. Se si vuole usarne una, provare a scrivere il referente di quella frase nella tabella; se non ci si riesce, scriverla in frasi concrete.5152## Azioni Preliminari in Caso di Problemi5354- Se ci si accorge di aver iniziato a scrivere il corpo senza aver presentato una tabella di corrispondenza, non continuare aggiungendo la tabella in seguito. Scartare il corpo, ripresentare la tabella di corrispondenza in modo indipendente, e poi rigenerare il corpo.55- Se viene segnalato che una riga della tabella era errata (confusione di referente o ruolo), non aggiungere una spiegazione; riscrivere la riga pertinente e poi rigenerare la parte corrispondente del corpo.56- In ambienti in cui questa skill non può essere caricata, salvare una tabella con almeno 6 colonne (Fonte, Scopo, Oggetto Concreto, Ruolo, Contesto, Parola Candidata) come file indipendente prima di iniziare il corpo.5758## Osservazioni5960- Non includere input di test o risposte attese per la verifica nel corpo di questa skill (per mantenere l'indipendenza della verifica. I test sono gestiti in fixture in una directory separata).61- L'obiettivo non è il confronto con una lista di termini errati. L'obiettivo del confronto è la "tabella di corrispondenza dichiarata dal documento stesso."
regola referent-before-label
1# Fissare il referente prima della parola23<!-- codex-runtime-summary -->4- IMPORTANTE: Per i documenti di destinazione (frasi di progettazione, report di ricerca, piani di contromisura, naming, riepilogo dell'ordine di ragionamento), scrivere il corpo dopo aver presentato in modo indipendente una tabella di corrispondenza. Presentare il corpo senza una tabella di corrispondenza è vietato. Se si inizia a scrivere senza una tabella, scartare il corpo e ricominciare dalla tabella di corrispondenza.5- IMPORTANTE: Non usare etichette di lavoro (frasi che racchiudono lavoro non organizzato in nomi astratti) per framework o intestazioni. Non introdurre parole nuove o coniate a meno che non si possa scrivere una definizione iniziale; scomporre l'obiettivo in descrizioni concrete.6- IMPORTANTE: Attivare la skill semantic-generation quando si avvia un documento di destinazione. Anche se la skill non può essere utilizzata, salvare prima una tabella di corrispondenza con almeno 6 colonne (Fonte, Scopo, Oggetto Concreto, Ruolo, Contesto, Parola Candidata) come deliverable indipendente.7<!-- /codex-runtime-summary -->89Se una parola (spesso una parola coniata sul momento) viene posizionata per prima mentre l'obiettivo è ambiguo, e il pensiero procede basandosi su quella parola, la discrepanza con il referente si propaga alle frasi di progettazione, ai nomi di stato, ai nomi di condizione, ai nomi di metodo e ai nomi di tipo (come negli esempi "Punto di Compressione" e "Raccogliere le osservazioni in un unico punto" in TASK-52). Questa regola ferma questo processo di generazione stesso. Il confronto con una lista di termini errati (caccia alle parole) non è la contromisura, perché le parole coniate non possono essere enumerate. I criteri per la fluttuazione delle parole sono detenuti da [[terminology]], e questa regola detiene la "procedura prima di posizionare la parola."1011## Ambito (Documenti di Destinazione)1213Applicare solo a compiti che rientrano in uno dei seguenti casi. Se non si riesce a giudicare, applicarlo.14151. Scrittura di materiali di progettazione, progettazione da requisiti, report di ricerca, piani di isolamento delle cause o piani di contromisura.162. Naming (specifiche pubbliche, nomi di stato, nomi di condizione, nomi di evento, nomi di tipo per valori o record, nomi di metodo, nomi booleani).173. Tentativo di riassumere un ordine di ragionamento fornito dall'utente in brevi etichette di lavoro.1819Non applicare a citazione di testo originale dell'utente, semplice modifica meccanica, riutilizzo di nomi esistenti, output fisso, chiacchiere o frasi brevi che possono essere scritte solo con termini consolidati.2021## Applicazione Costante (3 Divieti)2223- IMPORTANTE: Nei documenti di destinazione, non presentare il corpo senza presentare in modo indipendente una tabella di corrispondenza (tabella dei referenti). La tabella di corrispondenza deve essere salvata prima in un file separato o in un turno separato dal corpo, e il corpo viene scritto dopo (posizionare semplicemente la tabella all'inizio del documento completato non prova che sia stata "fatta prima").24- IMPORTANTE: Non usare etichette di lavoro per framework, intestazioni o conclusioni. Un'etichetta di lavoro si riferisce a una frase che racchiude lavoro non organizzato in nomi astratti senza scopo, obiettivo o giudizio (es., "Riassumere le osservazioni"). Se si vuole usarne una, provare a scrivere l'obiettivo a cui quella frase si riferisce nella tabella di corrispondenza; se non ci si riesce, scartare la frase e scrivere in frasi concrete.25- IMPORTANTE: Quando si introducono nuove parole diverse dalla terminologia dell'utente o dalla terminologia consolidata, scrivere una frase di definizione "X si riferisce a..." alla prima occorrenza. Non introdurre parole per le quali non si possa scrivere una frase di definizione; scrivere l'obiettivo così com'è in frasi.2627## Flusso Normale28291. Determinare se rientra nei documenti di destinazione (in caso di dubbio, trattare come applicabile).302. Attivare la skill [[semantic-generation]] e salvare prima la tabella di corrispondenza come deliverable indipendente.313. Scrivere il corpo usando solo le parole elencate nella tabella di corrispondenza come vocabolario centrale, mantenendo la stessa corrispondenza attraverso le frasi in giapponese, gli elementi di progettazione e gli identificatori di codice.3233## Azioni Preliminari in Caso di Problemi3435- Se ci si accorge di aver iniziato a scrivere il corpo senza aver presentato una tabella di corrispondenza per un documento di destinazione, non continuare aggiungendo la tabella in seguito. Scartare il corpo, ripresentare la tabella di corrispondenza in modo indipendente, e poi rigenerare il corpo.36- In ambienti in cui la skill non è disponibile, salvare una tabella di corrispondenza con almeno 6 colonne (Fonte, Scopo, Oggetto Concreto, Ruolo, Contesto, Parola Candidata) come file indipendente nella directory di lavoro prima di iniziare il corpo.
