Passa al contenuto principale

Competenze

Una competenza è un insieme denominato di istruzioni Markdown che il modello carica solo quando ne ha bisogno. Ogni competenza ha uno slug ($docs-style), un nome visualizzato, una breve descrizione e le istruzioni complete.

Caricamento su richiesta​

La descrizione costituisce il manifest: quando gli strumenti sono abilitati per un turno, lo strumento integrato load_skill elenca slug, nome e descrizione di ogni competenza abilitata, mentre il modello recupera tutte le istruzioni con una chiamata. In questo modo, le istruzioni lunghe non occupano mai il contesto finché non vengono usate. Menzionare $slug in un messaggio incoraggia il modello a caricare quella competenza.

Ciclo di vita​

Le competenze possono essere disabilitate senza eliminarle; una competenza disabilitata scompare dal manifest e rifiuta di essere caricata. Gli aggiornamenti incrementano la versione e archiviano la revisione precedente; il rollback ripristina una revisione come nuova versione. Il formato di scambio è un documento SKILL.md: un frontmatter con nome, slug e descrizione, seguito dalle istruzioni Markdown letterali; l'esportazione lo scarica e l'importazione lo accetta insieme all'envelope JSON. Nomi, descrizioni e istruzioni sono cifrati a riposo; lo slug rimane in chiaro.

Le competenze possono essere recuperate direttamente da una fonte remota in Impostazioni → Competenze → Da URL. Formati accettati: un collegamento a un elenco di skills.sh, un repository GitHub o un URL tree/blob, un'abbreviazione owner/repo/skill (risolta secondo la disposizione convenzionale skills/<name>/SKILL.md) oppure un collegamento diretto a qualsiasi file SKILL.md. Il recupero passa attraverso lo stesso controllo dell'uscita con destinazione fissata usato per i server degli strumenti: solo indirizzi pubblici e dimensione limitata; il documento viene importato come competenza modificabile di tua proprietà, quindi una fonte remota non si aggiorna mai automaticamente senza avviso.

File inclusi​

Una competenza può includere file di supporto nella struttura della cartella SKILL.md: documenti di riferimento, modelli e sorgenti di script a cui rimandano le istruzioni. load_skill elenca il pacchetto al termine delle istruzioni e il modello legge un file su richiesta con lo strumento read_skill_file, così un riferimento di grandi dimensioni non occupa mai il contesto finché non è davvero necessario.

I file seguono la competenza ovunque: Impostazioni → Competenze → Da cartella carica una cartella SKILL.md locale in un passaggio; un'importazione remota recupera i file di testo accanto al file SKILL.md; l'esportazione JSON include il pacchetto e la finestra di modifica gestisce i file singolarmente. I percorsi sono relativi e non possono mai uscire dalla competenza; i contenuti sono solo testuali, cifrati a riposo e limitati (32 file, 200 KB ciascuno, 1 MB per competenza).

Competenze insegnate​

Le competenze il cui slug inizia con taught- vengono create dimostrando un'attività sullo schermo di un Computer Work: la registrazione viene compilata in modo deterministico in una procedura in linguaggio naturale, con destinazioni di clic ancorate, secret occultati e un ambito consentito derivato dai siti visitati dalla dimostrazione, quindi salvata come normale competenza. Ottiene pertanto controllo delle versioni, modifica e condivisione come tutte le altre. Le esecuzioni Work con computer caricano automaticamente le competenze insegnate abilitate del proprietario. Al termine di un'esecuzione, una valutazione con un clic riuscita/non riuscita sui chip delle competenze aggiunge una riga datata alla sezione Cronologia dei risultati della competenza; ogni valutazione è una normale versione della competenza, quindi la cronologia può essere modificata e ripristinata qui come qualsiasi altra modifica.

Condivisione e profili​

Le competenze sono private per impostazione predefinita e condivisibili attraverso il modello comune di concessione delle risorse. Un profilo assistente può associare un sottoinsieme di competenze e le sessioni che usano quel profilo vedono nel manifest solo tali competenze.

Esempio​

Crea una competenza in Impostazioni → Competenze (oppure scegli uno dei modelli iniziali e modificalo):

  • Slug: cite-sources

  • Nome: Cite sources

  • Descrizione: Come citare le prove: riferimenti numerati con URL, nessuna affermazione priva di fonte. (questa riga è ciò che il modello vede nel manifest: deve indicare quando usare la competenza)

  • Istruzioni:

    # Citing sources

    - Every factual claim gets a numbered reference like [1].
    - End with a References section: number, title, URL.
    - If no source exists, say so instead of inventing one.

Abilita l'interruttore degli strumenti nel compositore e chiedi:

Riassumi i risultati più recenti e $cite-sources.

Digitando $ completi automaticamente gli slug delle competenze. Il modello vede cite-sources nel manifest, chiama load_skill per recuperare le istruzioni precedenti e formatta la risposta di conseguenza. Disabilita la competenza nella sua scheda e questa scompare dal manifest senza essere eliminata.