Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Questa guida è rivolta ad amministratori e architetti aziendali che devono governare le Agent Skills in tutta l'organizzazione. Copre come verificare, valutare, distribuire e gestire le Skills su larga scala. Per le linee guida sulla creazione, consulta le best practice. Per i dettagli sull'architettura, consulta la panoramica delle Skills.
Distribuire le Skills in un'azienda richiede di rispondere a due domande distinte:
Valuta ogni Skill rispetto a questi indicatori di rischio prima di approvarne la distribuzione:
| Indicatore di rischio | Cosa cercare | Livello di preoccupazione |
|---|---|---|
| Esecuzione di codice | Script nella directory della Skill (*.py, *.sh, *.js) | Alto: gli script vengono eseguiti con accesso completo all'ambiente |
| Manipolazione delle istruzioni | Direttive per ignorare le regole di sicurezza, nascondere azioni agli utenti o alterare il comportamento di Claude in modo condizionale | Alto: può aggirare i controlli di sicurezza |
| Riferimenti a server MCP | Istruzioni che fanno riferimento a strumenti MCP (ServerName:tool_name) | Alto: estende l'accesso oltre la Skill stessa |
| Pattern di accesso alla rete | URL, endpoint API, chiamate fetch, curl o requests | Alto: potenziale vettore di esfiltrazione dei dati |
| Credenziali hardcoded | Chiavi API, token o password nei file o negli script della Skill | Alto: segreti esposti nella cronologia Git e nella finestra di contesto |
| Ambito di accesso al filesystem | Percorsi al di fuori della directory della Skill, pattern glob ampi, path traversal (../) | Medio: può accedere a dati non previsti |
| Invocazioni di strumenti | Istruzioni che indirizzano Claude a usare bash, operazioni sui file o altri strumenti | Medio: rivedi quali operazioni vengono eseguite |
Prima di distribuire qualsiasi Skill proveniente da terze parti o da un contributore interno, completa questi passaggi:
http, requests.get, urllib, curl, fetch).Le Skills possono degradare le prestazioni dell'agente se si attivano in modo errato, entrano in conflitto con altre Skills o forniscono istruzioni scadenti. Richiedi una valutazione prima di qualsiasi distribuzione in produzione.
Stabilisci soglie di approvazione per queste dimensioni prima di distribuire qualsiasi Skill:
| Dimensione | Cosa misura | Esempio di fallimento |
|---|---|---|
| Accuratezza di attivazione | La Skill si attiva per le query giuste e rimane inattiva per quelle non correlate? | La Skill si attiva a ogni menzione di fogli di calcolo, anche quando l'utente vuole solo discutere di dati |
| Comportamento in isolamento | La Skill funziona correttamente da sola? | La Skill fa riferimento a file che non esistono nella sua directory |
| Coesistenza | L'aggiunta di questa Skill degrada altre Skills? | La descrizione della nuova Skill è troppo ampia e sottrae attivazioni alle Skills esistenti |
| Aderenza alle istruzioni | Claude segue accuratamente le istruzioni della Skill? | Claude salta i passaggi di validazione o usa librerie sbagliate |
| Qualità dell'output | La Skill produce risultati corretti e utili? | I report generati hanno errori di formattazione o dati mancanti |
Richiedi agli autori delle Skills di presentare suite di valutazione con 3–5 query rappresentative per Skill, che coprano i casi in cui la Skill dovrebbe attivarsi, non dovrebbe attivarsi e i casi limite ambigui. Richiedi test su tutti i modelli utilizzati dalla tua organizzazione (Haiku, Sonnet, Opus), perché l'efficacia delle Skills varia in base al modello.
Per indicazioni dettagliate sulla creazione di valutazioni, consulta valutazione e iterazione nelle best practice. Per la metodologia generale di valutazione, consulta sviluppare casi di test.
I risultati delle valutazioni segnalano quando agire:
Pianifica
Identifica i flussi di lavoro ripetitivi, soggetti a errori o che richiedono conoscenze specializzate. Mappali ai ruoli organizzativi e determina quali sono candidati per le Skills.
Crea e rivedi
Assicurati che l'autore della Skill segua le best practice. Richiedi una revisione della sicurezza usando la checklist di revisione. Richiedi una suite di valutazione prima dell'approvazione. Stabilisci la separazione dei compiti: gli autori delle Skills non dovrebbero essere i revisori di se stessi.
Testa
Richiedi valutazioni in isolamento (la Skill da sola) e insieme alle Skills esistenti (test di coesistenza). Verifica l'accuratezza di attivazione, la qualità dell'output e l'assenza di regressioni nel tuo set di Skills attive prima di approvare per la produzione.
Distribuisci
Carica tramite la Skills API per l'accesso a livello di workspace. Consulta Usare le Skills con l'API per il caricamento e la gestione delle versioni. Documenta la Skill nel tuo registro interno con scopo, proprietario e versione.
Monitora
Traccia i pattern di utilizzo e raccogli feedback dagli utenti. Riesegui periodicamente le valutazioni per rilevare derive o regressioni man mano che i flussi di lavoro e i modelli evolvono. Le analisi di utilizzo non sono attualmente disponibili tramite la Skills API. Implementa un logging a livello di applicazione per tracciare quali Skills sono incluse nelle richieste.
Itera o depreca
Richiedi che l'intera suite di valutazione venga superata prima di promuovere nuove versioni. Aggiorna le Skills quando i flussi di lavoro cambiano o i punteggi di valutazione diminuiscono. Depreca le Skills quando le valutazioni falliscono costantemente o il flusso di lavoro viene dismesso.
Come linea guida generale, limita il numero di Skills caricate simultaneamente per mantenere un'accuratezza di richiamo affidabile. I metadati di ogni Skill (nome e descrizione) competono per l'attenzione nel prompt di sistema. Con troppe Skills attive, Claude potrebbe non riuscire a selezionare la Skill giusta o ignorare completamente quelle rilevanti. Usa la tua suite di valutazione per misurare l'accuratezza di richiamo man mano che aggiungi Skills, e smetti di aggiungerne quando le prestazioni degradano.
Nota che le richieste API supportano un massimo di 8 Skills per ogni richiesta (consulta Usare le Skills con l'API). Se un ruolo richiede più Skills di quante ne supporti una singola richiesta, considera di consolidare le Skills specifiche in altre più ampie o di instradare le richieste verso set di Skills diversi in base al tipo di attività.
Incoraggia i team a iniziare con Skills ristrette e specifiche per un flusso di lavoro piuttosto che con Skills ampie e multiuso. Man mano che emergono pattern nella tua organizzazione, consolida le Skills correlate in bundle basati sui ruoli.
Esempio di progressione:
formatting-sales-reports, querying-pipeline-data, updating-crm-recordssales-operations (quando le valutazioni confermano prestazioni equivalenti)Usa convenzioni di denominazione coerenti in tutta la tua organizzazione. La sezione convenzioni di denominazione nelle best practice fornisce indicazioni sulla formattazione.
Mantieni un registro interno per ogni Skill con:
Raggruppa le Skills per ruolo organizzativo per mantenere focalizzato il set di Skills attive di ogni utente:
Ogni bundle basato sui ruoli dovrebbe contenere solo le Skills rilevanti per i flussi di lavoro quotidiani di quel ruolo.
Archivia le directory delle Skills in Git per il tracciamento della cronologia, la revisione del codice tramite pull request e la capacità di rollback. Ogni directory di una Skill (contenente SKILL.md e qualsiasi file incluso) si mappa naturalmente a una cartella tracciata da Git.
La Skills API fornisce una distribuzione con ambito a livello di workspace. Le Skills caricate tramite l'API sono disponibili per tutti i membri del workspace. Consulta Usare le Skills con l'API per gli endpoint di caricamento, versionamento e gestione.
Mantieni i file sorgente delle Skills in Git come unica fonte di verità. Se la tua organizzazione distribuisce Skills su più superfici, implementa un tuo processo di sincronizzazione per mantenerle coerenti. Per i dettagli completi, consulta disponibilità tra superfici.
Dettagli sull'architettura e sulla piattaforma
Linee guida di creazione per gli autori di Skills
Carica e gestisci le Skills in modo programmatico
Was this page helpful?