Usare le competenze dell'agente con GitHub Copilot

Le competenze dell'agente sono set riutilizzabili di istruzioni che insegnano agli agenti Copilot come eseguire attività specifiche, ad esempio l'esecuzione di una pipeline di compilazione, la generazione di boilerplate o il seguire gli standard di codifica del team. Definendo le competenze una sola volta, si risparmia tempo e si garantisce un comportamento coerente nel flusso di lavoro.

Le abilità integrano agenti personalizzati e istruzioni personalizzate. Mentre gli agenti personalizzati definiscono un set di strumenti e persona e le istruzioni personalizzate impostano preferenze di codifica generali, le competenze forniscono indicazioni specifiche per le attività che qualsiasi agente può individuare e usare automaticamente.

Prerequisites

Funzionamento delle competenze dell'agente

Quando si usa la modalità agent, Copilot individua automaticamente le competenze dal repository e dal profilo utente. L'agente decide quando una competenza è rilevante per la richiesta e la attiva. Quando viene attivata un'abilità, appare nella chat per informarti che è in fase di applicazione.

Screenshot che mostra un'abilità usata dall'agente Copilot in chat.

Località delle competenze

Le competenze vengono prelevate dalle posizioni seguenti:

Tipo di competenza Location
Competenze dell'area di lavoro o del progetto (archiviate nel repository) .github/skills/, .claude/skills/, .agents/skills/
Competenze personali (archiviate nel profilo utente) ~/.copilot/skills/, ~/.claude/skills/, ~/.agents/skills/

Le competenze dell'area di lavoro vengono condivise con il team tramite il controllo del codice sorgente. Le competenze personali si applicano a tutti i progetti e non sono commitati in alcun repository.

Creare una competenza

È possibile creare un'abilità manualmente nel proprio file system.

Creare manualmente un'abilità

Ogni competenza è una directory contenente un SKILL.md file che segue la specifica agentskills.io.

  1. Creare un elenco di competenze. Per un'abilità dell'area di lavoro, usare .github/skills/ alla radice del repository. Per una competenza personale, utilizzare ~/.copilot/skills/.

  2. Creare una sottodirectory per l'abilità. Ogni competenza deve avere una propria directory , ad esempio .github/skills/github-issues/.

  3. Creare un SKILL.md file nella directory di skill. Il file contiene il frontmatter YAML con i metadati seguiti dalle istruzioni markdown.

  4. Facoltativamente, aggiungi script, esempi o altre risorse alla directory dell'abilità.

Struttura della directory delle abilità

your-repo/
└── .github/
    └── skills/
        └── github-issues/
            ├── SKILL.md          # Required: metadata + instructions
            ├── scripts/          # Optional: executable code
            ├── references/       # Optional: documentation
            └── assets/           # Optional: templates, resources

formato SKILL.md

Il SKILL.md file deve contenere il frontmatter YAML seguito dal contenuto markdown:

---
name: github-issues
description: Creates and manages GitHub issues following team conventions. Use when working with issue tracking, bug reports, or feature requests.
---

When creating GitHub issues:

- Use the standard title format: [Component] Brief description
- Add appropriate labels based on issue type
- Include reproduction steps for bug reports
- Link related issues and PRs

Proprietà frontmatter

Proprietà Obbligatorio Description
name Sì Solo lettere minuscole, numeri e trattini. Deve corrispondere al nome della directory principale. Massimo 64 caratteri.
description Sì Descrive le operazioni che la competenza esegue e quando usarla. Massimo 1.024 caratteri.
license No Nome della licenza o riferimento a un file di licenza in bundle.
compatibility No Requisiti di ambiente, ad esempio i prodotti previsti o i pacchetti di sistema necessari.
metadata No Mappatura chiave-valore arbitraria per metadati aggiuntivi.
allowed-tools No Stringa separata da spazi di strumenti pre-approvati che l'abilità può usare.

Suggerimenti per redigere competenze efficaci

  • Mantenere il principale SKILL.md sotto 500 righe. Spostare materiale di riferimento dettagliato in file separati nella references/ directory.
  • Scrivere un chiaro description che includa parole chiave specifiche per aiutare gli agenti a identificare quando la competenza è rilevante.
  • Includere istruzioni dettagliate, esempi e casi limite comuni.

Gestire le competenze dal pannello delle competenze

Selezionare l'icona Tools nell'angolo inferiore destro di Copilot Chat per aprire il pannello delle competenze, una visualizzazione dedicata di ogni competenza individuata. Il pannello Skills è disponibile solo nei Visual Studio Insider 2026.

Screenshot che mostra il pannello delle competenze in cui è possibile modificare e aprire le competenze.

Dal pannello è possibile:

  • Modifica: Apri qualsiasi abilità direttamente nell'editor SKILL.md tramite il menu ....
  • Apri percorso del file: vai alla directory delle abilità su disco.
  • Ricerca: filtra le competenze in base al nome o alla parola chiave.

Il pannello visualizza anche la diagnostica per eventuali errori di configurazione delle competenze, in modo da individuare e risolvere rapidamente i problemi.

Competenze della community

Consultare il repository awesome-copilot per esempi di competenze condivise dalla community.

Contenuti correlati

  • Last updated on