potato-skill: Guida rapida con un agente di programmazione
Descrivi a Claude Code i dati che devono essere etichettati da persone. potato-skill progetta lo studio, lo costruisce come task di annotazione Potato con una propria interfaccia e lo avvia.
Ci sono due modi per iniziare un progetto Potato. Puoi scrivere il task da solo, come mostra la Guida rapida, oppure descrivere lo studio a un agente di programmazione e lasciare che potato-skill lo progetti e lo costruisca. Questa pagina tratta il secondo modo. Entrambi portano allo stesso risultato: un task di annotazione Potato che puoi eseguire, modificare e condividere.
Decisioni di progettazione prese dalla skill
potato-skill è una skill per agenti, un pacchetto di istruzioni e script di supporto che un agente di programmazione carica quando una richiesta ne ha bisogno. Si occupa sia della progettazione dello studio sia della sua costruzione, dall'insieme di etichette fino ai dati esportati:
- che cosa chiedere agli annotatori, e su quale scala
- quanti annotatori servono per ogni elemento
- come formare gli annotatori e controllare il loro lavoro
- l'interfaccia che vedono gli annotatori
- avviare il task e percorrerlo come farebbe un annotatore
- esportare i risultati nel formato che serve al passaggio successivo
Lavora anche su studi già in corso. Riporta l'avanzamento e l'accordo, e indica quali modifiche sono sicure dopo che gli annotatori hanno iniziato.
Il task che costruisce gira su Potato, quindi include ciò che Potato fa già: un accesso per ogni annotatore, più annotatori per elemento, statistiche di accordo, integrazione con Prolific e MTurk ed esportazione nei formati letti dagli strumenti a valle.
Requisiti
Potato deve essere installato dove l'agente esegue i comandi, perché gli script di supporto della skill importano Potato e chiamano il comando potato:
pip install potato-annotationTi serve anche un agente di programmazione. La skill è stata scritta per Claude Code; la sezione successiva tratta gli altri agenti.
Installare la skill
In Claude Code:
/plugin marketplace add davidjurgens/potato-skill
/plugin install potato-skill@potato
Per Codex, Cursor e altri agenti, la CLI skills la installa nel tuo progetto:
npx skills add davidjurgens/potato-skill --agent codex cursorCon --agent codex cursor copia la skill in .agents/skills/potato-skill/. Codex e Cursor possono anche leggere il file AGENTS.md nella radice del repository di potato-skill.
Descrivere lo studio
Di' che cosa va etichettato, chi lo etichetterà e a cosa servono le etichette. Non serve conoscere i tipi di annotazione di Potato né il suo formato di configurazione. Una richiesta può essere breve così:
Voglio che tre annotatori etichettino ciascuno 200 tweet per sentiment su una scala a 5 punti, con una pagina di consenso e due controlli di attenzione. Costruiscilo e avvialo.
La skill stabilisce la formulazione delle domande, la scala, il modo in cui vengono assegnati gli elementi e come vengono controllati gli annotatori. Poi l'agente costruisce il task, lo avvia e lo percorre come farebbe un annotatore prima di consegnartelo. Aprilo nel browser ed etichetta tu stesso qualche elemento prima di invitare altre persone.
Il task che ottieni
Un task Potato: una cartella di progetto con la configurazione, i dati e le istruzioni del task. Tutto ciò che si trova nella Guida rapida vale anche per questo task. Lo avvii con potato start config.yaml, lo modifichi a mano, aggiungi annotatori ed esporti le etichette.
Poiché il risultato è una cartella di task Potato, anche altre persone possono usarlo. Un collega può eseguire lo stesso studio su dati nuovi, tu puoi ripeterlo l'anno prossimo e pubblicarlo insieme all'articolo che lo ha usato. La vetrina è una raccolta di task condivisi in questo modo, tratti da articoli pubblicati.
Design e annotazioni esistenti
- Un design pubblicato. La skill può partire da uno dei 440 design di annotazione tratti da articoli pubblicati, con i loro insiemi di etichette, la formulazione delle domande e le istruzioni. Puoi sfogliarli nella vetrina.
- Annotazioni da un altro strumento. Importa annotazioni esistenti da Label Studio, CVAT o COCO, così un progetto a metà può proseguire in Potato.
- Uno studio in corso. Riporta l'avanzamento di ogni annotatore e l'accordo su ogni domanda, e indica quali correzioni sono sicure a studio avviato e quali rovinerebbero i dati già raccolti.
Test sui registri di Potato
La CI della skill verifica che ogni tipo di annotazione, chiave di configurazione e configurazione di esempio citati nelle sue istruzioni esista in Potato. Lo YAML di esempio passa dal validatore di Potato, e l'esempio completo avvia un vero server Potato. Tre dei suoi riferimenti sono generati dai registri di Potato stesso, quindi i tipi e le chiavi che l'agente legge sono quelli che il server applica.
Il materiale di riferimento è pubblicato su davidjurgens.github.io/potato-skill e si può leggere senza installare nulla. Anthropic consiglia di esaminare qualsiasi skill prima di installarla.
I due modi a confronto
| Scrivere il task da solo | Descriverlo a un agente di programmazione | |
|---|---|---|
| Parti da | una configurazione YAML | una descrizione in linguaggio comune |
| Adatto per | imparare Potato, task piccoli | studi nuovi, studi in crowdsourcing con formazione e controlli, tipi di annotazione che non hai mai usato |
| Ottieni | un task Potato | un task Potato |
Puoi cambiare modo in qualsiasi momento. Un agente può modificare un task che hai scritto tu, e tu puoi modificare un task costruito dall'agente.