Comandi slash

​

Comandi slash integrati

​

Comandi slash personalizzati

​

Sintassi

/<command-name> [arguments]

​

Parametri

​

Tipi di comando

​

Comandi di progetto

# Crea un comando di progetto
mkdir -p .claude/commands
echo "Analizza questo codice per problemi di performance e suggerisci ottimizzazioni:" > .claude/commands/optimize.md

​

Comandi personali

# Crea un comando personale
mkdir -p ~/.claude/commands
echo "Rivedi questo codice per vulnerabilità di sicurezza:" > ~/.claude/commands/security-review.md

​

Funzionalità

​

Namespacing

​

Argomenti

Tutti gli argomenti con $ARGUMENTS

# Definizione del comando
echo 'Correggi il problema #$ARGUMENTS seguendo i nostri standard di codifica' > .claude/commands/fix-issue.md

# Utilizzo
> /fix-issue 123 high-priority
# $ARGUMENTS diventa: "123 high-priority"

Argomenti individuali con $1, $2, ecc.

# Definizione del comando  
echo 'Rivedi PR #$1 con priorità $2 e assegna a $3' > .claude/commands/review-pr.md

# Utilizzo
> /review-pr 456 high alice
# $1 diventa "456", $2 diventa "high", $3 diventa "alice"

• Accedere agli argomenti individualmente in diverse parti del tuo comando
• Fornire valori predefiniti per argomenti mancanti
• Costruire comandi più strutturati con ruoli di parametri specifici

​

Esecuzione di comandi bash

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Crea un commit git
---

## Contesto

- Stato git attuale: !`git status`
- Diff git attuale (modifiche staged e unstaged): !`git diff HEAD`
- Branch attuale: !`git branch --show-current`
- Commit recenti: !`git log --oneline -10`

## Il tuo compito

In base ai cambiamenti di cui sopra, crea un singolo commit git.

​

Riferimenti ai file

# Fai riferimento a un file specifico

Rivedi l'implementazione in @src/utils/helpers.js

# Fai riferimento a più file

Confronta @src/old-version.js con @src/new-version.js

​

Modalità di pensiero

​

Frontmatter

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
argument-hint: [message]
description: Crea un commit git
model: claude-3-5-haiku-20241022
---

Crea un commit git con messaggio: $ARGUMENTS

---
argument-hint: [pr-number] [priority] [assignee]
description: Rivedi pull request
---

Rivedi PR #$1 con priorità $2 e assegna a $3.
Concentrati su sicurezza, performance e stile del codice.

​

Comandi dei plugin

​

Come funzionano i comandi dei plugin

• Con namespace: I comandi possono utilizzare il formato /plugin-name:command-name per evitare conflitti (il prefisso del plugin è opzionale a meno che non ci siano collisioni di nomi)
• Automaticamente disponibili: Una volta che un plugin è installato e abilitato, i suoi comandi appaiono in /help
• Completamente integrati: Supportano tutte le funzionalità dei comandi (argomenti, frontmatter, esecuzione bash, riferimenti ai file)

​

Struttura dei comandi dei plugin

---
description: Breve descrizione di cosa fa il comando
---

# Nome del comando

Istruzioni dettagliate per Claude su come eseguire questo comando.
Includi una guida specifica su parametri, risultati attesi e considerazioni speciali.

• Argomenti: Usa segnaposti come {arg1} nelle descrizioni dei comandi
• Sottodirectory: Organizza i comandi in sottodirectory per il namespacing
• Integrazione Bash: I comandi possono eseguire script shell e programmi
• Riferimenti ai file: I comandi possono fare riferimento e modificare file di progetto

​

Modelli di invocazione

/command-name

/plugin-name:command-name

/command-name arg1 arg2

​

Comandi slash MCP

​

Formato del comando

/mcp__<server-name>__<prompt-name> [arguments]

​

Funzionalità

​

Scoperta dinamica

• Un server MCP è connesso e attivo
• Il server espone prompt attraverso il protocollo MCP
• I prompt vengono recuperati con successo durante la connessione

​

Argomenti

# Senza argomenti
> /mcp__github__list_prs

# Con argomenti
> /mcp__github__pr_review 456
> /mcp__jira__create_issue "Bug title" high

​

Convenzioni di denominazione

• I nomi del server e del prompt vengono normalizzati
• Gli spazi e i caratteri speciali diventano underscore
• I nomi vengono convertiti in minuscole per coerenza

​

Gestione delle connessioni MCP

• Visualizzare tutti i server MCP configurati
• Controllare lo stato della connessione
• Autenticarsi con server abilitati per OAuth
• Cancellare i token di autenticazione
• Visualizzare gli strumenti e i prompt disponibili da ogni server

​

Permessi MCP e wildcard

• ✅ Corretto: mcp__github (approva TUTTI gli strumenti dal server github)
• ✅ Corretto: mcp__github__get_issue (approva uno strumento specifico)
• ❌ Errato: mcp__github__* (i wildcard non sono supportati)

​

Strumento SlashCommand

> Esegui /write-unit-test quando stai per iniziare a scrivere i test.

​

Comandi supportati dallo strumento SlashCommand

• Sono definiti dall’utente. I comandi integrati come /compact e /init non sono supportati.
• Hanno il campo frontmatter description compilato. Usiamo la description nel contesto.

​

Disabilita lo strumento SlashCommand

/permissions
# Aggiungi alle regole di negazione: SlashCommand

​

Disabilita solo comandi specifici

​

Regole di permesso SlashCommand

• Corrispondenza esatta: SlashCommand:/commit (consente solo /commit senza argomenti)
• Corrispondenza di prefisso: SlashCommand:/review-pr:* (consente /review-pr con qualsiasi argomento)

​

Limite del budget dei caratteri

• Limite predefinito: 15.000 caratteri
• Limite personalizzato: Impostato tramite la variabile di ambiente SLASH_COMMAND_TOOL_CHAR_BUDGET

​

Skill vs comandi slash

​

Usa i comandi slash per

• Semplici snippet di prompt che usi spesso
• Promemoria rapidi o modelli
• Istruzioni frequentemente utilizzate che si adattano a un file

• /review → “Rivedi questo codice per bug e suggerisci miglioramenti”
• /explain → “Spiega questo codice in termini semplici”
• /optimize → “Analizza questo codice per problemi di performance”

​

Usa le Skill per

• Flussi di lavoro complessi con più passaggi
• Capacità che richiedono script o utilità
• Conoscenza organizzata su più file
• Flussi di lavoro del team che vuoi standardizzare

• Skill di elaborazione PDF con script di compilazione di moduli e convalida
• Skill di analisi dei dati con documenti di riferimento per diversi tipi di dati
• Skill di documentazione con guide di stile e modelli

​

Differenze chiave

​

Esempio di confronto

# .claude/commands/review.md
Rivedi questo codice per:
- Vulnerabilità di sicurezza
- Problemi di performance
- Violazioni dello stile del codice

.claude/skills/code-review/
├── SKILL.md (panoramica e flussi di lavoro)
├── SECURITY.md (checklist di sicurezza)
├── PERFORMANCE.md (modelli di performance)
├── STYLE.md (riferimento guida di stile)
└── scripts/
    └── run-linters.sh

​

Quando usare ciascuno

• Invochi lo stesso prompt ripetutamente
• Il prompt si adatta a un singolo file
• Vuoi il controllo esplicito su quando viene eseguito

• Claude dovrebbe scoprire la capacità automaticamente
• Sono necessari più file o script
• Flussi di lavoro complessi con passaggi di convalida
• Il team ha bisogno di una guida standardizzata e dettagliata

​

Vedi anche

• Plugin - Estendi Claude Code con comandi personalizzati tramite plugin
• Identity and Access Management - Guida completa ai permessi, inclusi i permessi degli strumenti MCP
• Modalità interattiva - Scorciatoie, modalità di input e funzionalità interattive
• Riferimento CLI - Flag e opzioni della riga di comando
• Impostazioni - Opzioni di configurazione
• Gestione della memoria - Gestione della memoria di Claude tra le sessioni