Crea set di istruzioni riutilizzabili per workflow specializzati. Definisci workflow personalizzati, aggiungi file di supporto e insegna a Bob attività specializzate per risultati coerenti.

Gli skill sono set di istruzioni riutilizzabili che insegnano a Bob nuovi workflow e attività specializzate. Pensali come ricette che Bob segue per completare tipi specifici di lavoro in modo coerente e ripetibile.

Perché usare gli skill

Riutilizzabilità: Definisci i workflow una volta e usali in più conversazioni.

Coerenza: Assicurati che Bob segua lo stesso approccio ogni volta per attività specifiche.

Specializzazione: Crea competenze specifiche per revisioni del codice, testing, documentazione e altro ancora.

Collaborazione del team: Condividi workflow standardizzati con il tuo team tramite il controllo di versione.

Flessibilità: Includi file di supporto come checklist, template e materiali di riferimento.

Come funzionano gli skill

Quando attivi uno skill, Bob riceve le istruzioni dello skill e ottiene accesso a qualsiasi file di supporto nella directory dello skill. Bob segue quindi queste istruzioni per completare il tuo compito secondo il workflow definito.

Gli skill vengono caricati una volta per conversazione per evitare prompt duplicati. Bob determina automaticamente quando attivare uno skill in base alla tua richiesta e alla descrizione dello skill.

Creare uno skill

Configurazione di base

Crea una cartella in .bob/skills/ nella radice del tuo progetto, o usa ~/.bob/skills/ per gli skill globali.

Aggiungi un file SKILL.md all'interno di quella cartella.

Struttura esempio:

SKILL.md

Formato di SKILL.md

Il file SKILL.md usa il frontmatter YAML seguito dalle istruzioni dello skill:

---
name: code-review
description: Review code for bugs, security issues, and best practices
---

When reviewing code, check for:
- Security vulnerabilities
- Performance issues
- Missing error handling at API boundaries
- Unused imports and dead code

Provide a summary with severity levels for each finding.

Campi obbligatori:

name: Il nome visualizzato dello skill nell'interfaccia Bob

description: Un riassunto chiaro che aiuta Bob a decidere quando attivare questo skill — gli skill senza descrizioni vengono ignorati

Sezione istruzioni: Tutto ciò che si trova dopo il delimitatore --- diventa le istruzioni che Bob riceve quando lo skill viene attivato.

Aggiungere file di supporto

Puoi includere file aggiuntivi e sottocartelle accanto a SKILL.md per fornire materiali di riferimento, template, checklist, script o altre risorse. Bob può leggere questi file automaticamente una volta attivato lo skill.

Esempio con file di supporto:

SKILL.md

checklist.md

severity-guide.md

analyze.sh

report-generator.py

I file e le cartelle di supporto possono includere:

Checklist e template

Documentazione di riferimento

Esempi di configurazione

Script e utilità in sottocartelle

Guide di stile

Qualsiasi altra risorsa necessaria per lo skill

Posizioni degli skill

Gli skill possono essere definiti a due livelli:

Posizione	Scope	Caso d'uso
`<project>/.bob/skills/`	Specifico del progetto	Workflow unici per questo progetto
`~/.bob/skills/`	Globale	Workflow personali o a livello di organizzazione

Priorità: Se entrambe le posizioni contengono uno skill con lo stesso nome, lo skill a livello di progetto ha la precedenza.

Approvare gli skill

Per impostazione predefinita, Bob chiede il tuo permesso prima di attivare uno skill. Questo ti dà il controllo su quando vengono applicati i workflow specializzati.

Per saltare il prompt di approvazione:

Apri le impostazioni Bob.

Naviga alla sezione Approvazione automatica.

Attiva il toggle per Skills.

Con questa impostazione abilitata, Bob attiva automaticamente gli skill quando appropriato senza richiedere il permesso.

Scheda delle impostazioni Skills

La scheda Skills nelle impostazioni Bob ti offre un posto centralizzato per visualizzare e gestire gli skill disponibili nel tuo workspace. Usala per vedere quali skill sono caricati, verificare le loro posizioni e confermare che gli skill dalle directory del progetto o globali vengano rilevati correttamente.

Scrivere skill efficaci

Descrizioni chiare

Scrivi descrizioni che indichino chiaramente quando lo skill deve essere usato. Bob si basa su queste descrizioni per determinare la rilevanza dello skill.

Bene: "Review code for bugs, security issues, and best practices"

Evitare: "Code review skill"

Istruzioni focalizzate

Tieni il file SKILL.md principale focalizzato sul workflow principale. Sposta il materiale di riferimento dettagliato, gli esempi e le checklist nei file di supporto.

Esempio:

---
name: api-documentation
description: Generate API documentation following OpenAPI standards
---

Generate API documentation that includes:
- Endpoint descriptions
- Request/response schemas
- Authentication requirements
- Example requests and responses

Follow the style guide in `api-style-guide.md` and use the template in `api-template.md`.

Passi attuabili

Struttura le istruzioni come passi chiari e attuabili che Bob può seguire sistematicamente.

Esempio:

---
name: feature-implementation
description: Implement new features following team standards
---

<Steps>
<Step>
Review the feature requirements.

</Step>

<Step>
Create a plan with file changes needed.

</Step>

<Step>
Implement the feature with tests.

</Step>

<Step>
Update documentation.

</Step>

<Step>
Verify all tests pass.

</Step>
</Steps>

Follow coding standards in `coding-standards.md`.

Skill di esempio

Skill di revisione del codice

---
name: security-review
description: Review code for security vulnerabilities and best practices
---

Perform a security-focused code review:

<Steps>
<Step>
Check for common vulnerabilities:
- SQL injection risks
- XSS vulnerabilities
- Authentication/authorization issues
- Sensitive data exposure

</Step>

<Step>
Review security best practices:
- Input validation
- Output encoding
- Secure configuration
- Error handling

</Step>

<Step>
Provide findings with:
- Severity level (Critical, High, Medium, Low)
- Location in code
- Recommended fix
- Reference to security standards

</Step>
</Steps>

Use the severity guide in `severity-levels.md` for classification.

Skill di documentazione

---
name: api-docs
description: Generate comprehensive API documentation
---

Create API documentation that includes:

<Steps>
<Step>
Overview section:
- Purpose and use cases
- Authentication requirements
- Base URL and versioning

</Step>

<Step>
For each endpoint:
- HTTP method and path
- Description and purpose
- Request parameters
- Request body schema
- Response codes and schemas
- Example requests and responses

</Step>

<Step>
Additional sections:
- Error handling
- Rate limiting
- Pagination

</Step>
</Steps>

Follow the template in `api-doc-template.md` and examples in `api-examples.md`.

Consigli e buone pratiche

Inizia semplicemente: Inizia con istruzioni di base e perfeziona in base ai risultati.

Usa i file di supporto: Tieni SKILL.md conciso spostando il contenuto dettagliato nei file complementari.

Testa accuratamente: Verifica che gli skill funzionino come previsto prima di condividerli con il tuo team.

Controllo di versione: Includi gli skill del progetto nel tuo repository per la coerenza del team.

Nomi chiari: Usa nomi di skill descrittivi che indichino il loro scopo.

Responsabilità singola: Crea skill focalizzati per attività specifiche piuttosto che cercare di gestire più workflow non correlati.

Skills

In questa pagina