Vai al contenuto

Configurare potato-skill in Codex

Aggiungi potato-skill a un progetto Codex con un solo comando npx, avvia la skill con $potato-skill e approva i comandi che la sandbox predefinita blocca.

Codex legge le skill da .agents/skills/ nel tuo repository, e npx skills add davidjurgens/potato-skill --agent codex copia lì potato-skill. Codex rileva la skill senza riavvio, e $potato-skill avvia la skill nella CLI e nell'estensione per IDE. potato-skill: costruire uno studio di annotazione con un coding agent descrive che cosa fa la skill con uno studio, e Installare potato-skill nel tuo agente di programmazione tratta gli altri agenti.

Prima di installare

Potato va installato nell'ambiente Python che usa la shell di Codex. Gli script di supporto della skill importano i registri di Potato e chiamano il comando potato, e il primo passo della skill verifica che Potato si importi. L'extra per il browser e Chromium permettono a potato preview --screenshot e allo script di verifica guidata della skill di aprire il task in un browser headless:

bash
pip install 'potato-annotation[preview]'
playwright install chromium

La sandbox predefinita di Codex non ha accesso alla rete. Installa entrambi prima di iniziare per risparmiare un giro di approvazioni. La CLI skills viene eseguita tramite npx e richiede Node.js 22.20 o successivo.

Installare la skill

Esegui l'installazione nel tuo repository:

bash
npx skills add davidjurgens/potato-skill --agent codex

Il comando copia SKILL.md, i 30 file di riferimento e i nove script di supporto in .agents/skills/potato-skill/, e registra l'origine in skills-lock.json nella radice del repository. Codex analizza .agents/skills/ in ogni cartella, da quella corrente fino alla radice del repository, quindi anche una sessione avviata in una sottocartella del repository trova la skill. Fare il commit di .agents/skills/ dà la skill ai collaboratori senza alcun passo di installazione.

Aggiungi -g per installare invece la skill per ogni repository della macchina:

bash
npx skills add davidjurgens/potato-skill --agent codex -g

Un'installazione globale va in ~/.agents/skills/potato-skill/, la cartella delle skill a livello utente che Codex legge. Codex rileva una nuova skill senza riavvio. Se la skill non compare, riavvia Codex.

Verificare l'installazione

In Codex CLI o nell'estensione per IDE, /skills elenca le skill che Codex ha trovato, e potato-skill compare nell'elenco. Nell'app desktop di ChatGPT, Skills nella barra laterale mostra le skill di tutti i tuoi progetti.

Avviare uno studio

Menziona la skill con $potato-skill e descrivi lo studio:

text
$potato-skill I want 200 tweets labeled for sentiment on a 5-point scale by three annotators each, with a consent page and two attention checks. Build it and start it.

Codex carica la skill anche senza una menzione quando una richiesta corrisponde alla descrizione della skill, per esempio la richiesta di costruire un task di annotazione, modificare un config.yaml di Potato o controllare uno studio in corso.

Sandbox e approvazioni

Codex esegue i comandi in una sandbox. La modalità predefinita, workspace-write, permette ai comandi di scrivere nell'area di lavoro con l'accesso alla rete disattivato. L'impostazione che governa la rete è sandbox_workspace_write.network_access, che per impostazione predefinita vale false. Con la politica di approvazione on-request, Codex lavora dentro la sandbox e chiede conferma prima di un comando che esce dalla sandbox.

Durante la costruzione, la skill fa sì che Codex validi la configurazione, avvii un server Potato sulla tua macchina, apra il task in un browser headless ed esegua gli script di supporto della skill. Un pip install richiede la rete, e la sandbox predefinita non ne ha. Approva un comando fuori dalla sandbox quando Codex lo chiede, dopo aver letto il comando. Nella CLI, /permissions apre il selettore dei permessi. Nell'estensione per IDE e nell'app, le stesse scelte stanno sotto il campo di scrittura come Ask for approval, Approve for me e Full access. La documentazione sulla sandbox di Codex descrive ogni modalità.

AGENTS.md

Codex legge AGENTS.md per nome di file. Il repository di potato-skill ha un AGENTS.md nella radice, un breve riepilogo delle regole della skill. Copiare quel file nella radice del tuo repository dà a Codex le regole senza alcun passo di installazione. Il file rimanda a file di riferimento e script che solo un'installazione completa mette su disco. Per costruire uno studio usa l'installazione con la CLI skills. Se il tuo repository ha già un AGENTS.md, aggiungi il riepilogo a quel file invece di sostituirlo.

Aggiornare e rimuovere la skill

La CLI skills aggiorna e rimuove la skill per nome. Aggiungi -g a entrambi i comandi per un'installazione globale:

bash
npx skills update potato-skill
npx skills remove potato-skill

update confronta la copia installata con il repository GitHub e sostituisce la copia quando il repository è cambiato. remove elimina .agents/skills/potato-skill/ e la voce della skill in skills-lock.json.

Per disattivare la skill senza eliminarla, aggiungi una voce a ~/.codex/config.toml con il percorso assoluto del SKILL.md della skill, e riavvia Codex. La documentazione sulle skill di Codex elenca le altre impostazioni che una voce accetta:

toml
[[skills.config]]
path = "/path/to/your/repo/.agents/skills/potato-skill/SKILL.md"
enabled = false

Ulteriori letture