Commandes slash personnalisées de Claude Code
Les Skills sont le mécanisme d'extension de Claude Code, via des commandes slash personnalisées (par exemple,/deploy、/explain-code) pour améliorer les capacités de Claude.
Chaque commande personnalisée est essentiellement un fichier Skill indépendant qui peut encapsuler des workflows complexes, des conventions de projet et des opérations courantes, vous permettant de l'invoquer rapidement dans n'importe quelle session.
Les commandes personnalisées ont été intégrées au système Skills — situées à.claude/commands/deploy.mdles fichiers de commandes et situés à.claude/skills/deploy/SKILL.mdtous les fichiers Skill créeront/deploycommandes, fonctionnant de la même manière.
En substance,.claude/commands/est la forme abrégée de Skills, et les deux structures de répertoires sont complètement équivalentes.
Pourquoi utiliser des commandes slash personnalisées
La valeur essentielle des commandes slash personnalisées réside dansStandardisation + Réutilisation:
- Codifier les workflows: Encapsuler les opérations courantes à plusieurs étapes (comme « déployer en production ») dans une seule commande
- Assurer la cohérence de l'équipe: Codifier les conventions du projet (comme la « checklist de revue de code ») dans des commandes afin que les membres de l'équipe suivent les mêmes normes
- Réduire la charge cognitive: Plus besoin de mémoriser des combinaisons de commandes complexes ; une seule phrase peut déclencher le workflow complet
- Réduire la saisie répétitive: Les tâches à haute fréquence passent d'opérations à plusieurs étapes à une seule invocation
L'expérience de l'équipe interne d'Anthropic est la suivante : les tâches effectuées plus de deux fois par jour devraient être transformées en Skills. Faites-le correctement une fois, et cela continue de fonctionner.
Structure des fichiers
Chaque Skill est un répertoire qui contient un fichier requisSKILL.mdfichier :
my-skill/
├── SKILL.md # 主指令文件(必需)
├── template.md # Claude 填充的模板
├── examples/
│ └── sample.md # 展示预期格式的示例
└── scripts/
└── validate.sh # Claude 可以执行的脚本
Le format de fichier se compose de deux parties :
- frontmatter YAML(situé
---entre les délimiteurs) : utilisé pour configurer les métadonnées - corps Markdown: les instructions que Claude suit lorsqu'il est invoqué
Créez votre première commande slash personnalisée
1. Créez un répertoire de compétences
Créez le répertoire de compétences dans un emplacement approprié. L'emplacement de stockage détermine la portée de la commande :
mkdir -p ~/.claude/skills/explain-code # 或者在项目中创建 mkdir -p .claude/skills/explain-code
2. Écrivez le fichier SKILL.md
Dans le répertoire, créezSKILL.md, contenant un frontmatter YAML et des instructions :
Exemple
name: explain-code
description: Expliquez le code avec des diagrammes visuels et des analogies. Lorsque vous expliquez comment le code fonctionne,
explique une base de code, ou lorsqu'un utilisateur demande"Comment cela fonctionne-t-il ?"utilisez
---
Lorsque vous expliquez du code, incluez toujours les éléments suivants :
1- **Commencez par une analogie** : Comparez le code à des choses du quotidien
2- **Dessinez un diagramme** : Utilisez de l'art ASCII pour montrer le flux, la structure ou les relations
3- **Parcourez le code étape par étape** : Expliquez étape par étape ce qui se passe
4- **Signalez un piège** : Quelles sont les erreurs ou idées fausses courantes ?
3. Utilisez la commande personnalisée
Invoquez-la directement dans Claude Code :
/explain-code src/auth/login.ts
Claude associera automatiquement une compétence qui correspond à la description, ou vous pouvez l'invoquer explicitement.
Champs de configuration expliqués
| Champ | Description |
|---|---|
name |
Nom d'affichage ; devient une commande slash (format : lettres minuscules, chiffres, traits d'union, jusqu'à 64 caractères) |
description
|
Fonction de la compétence et quand l'utiliser (recommandé de remplir ; l'invocation automatique par Claude dépend de ce champ) |
argument-hint |
Invite affichée pendant l'autocomplétion (par ex.[filename] [format]) |
disable-model-invocation |
Défini àtruelorsqu'il est défini, empêche Claude de l'invoquer automatiquement ; ne prend effet que lorsque vous l'invoquez explicitement |
user-invocable |
Défini àfalselorsqu'il est défini, à partir de/masqué du menu ; seul Claude peut l'invoquer |
allowed-tools |
Liste des outils que Claude peut utiliser sans demander |
context |
Défini àforklorsqu'il est défini, s'exécute dans un sous-agent de branche |
agent |
Setcontext: forkle type de sous-agent utilisé lorsqu'il est défini |
paths |
Liste de motifs Glob, limitant la portée des fichiers pour l'activation de la compétence |
Contrôle d'invocation
Contrôlez qui peut invoquer la compétence via frontmatter :
| Configuration | Vous pouvez invoquer | Claude peut invoquer |
|---|---|---|
| (par défaut) | Oui | Oui |
disable-model-invocation: true |
Oui | non |
user-invocable: false |
non | Oui |
Substitution de variables
Utilisez des variables dans le contenu de la compétence, et Claude les remplacera automatiquement :
| Variable | Description |
|---|---|
$ARGUMENTS |
Tous les arguments passés lors de l'invocation |
$ARGUMENTS[N] |
Accéder à un paramètre spécifique par index basé sur 0 |
$N |
$ARGUMENTS[N]forme abrégée de |
${CLAUDE_SESSION_ID} |
ID de la session actuelle |
${CLAUDE_SKILL_DIR} |
Répertoire où se trouve le fichier SKILL.md de la compétence |
Emplacements de stockage des compétences
Les compétences peuvent être stockées dans plusieurs emplacements avec différentes portées :
| Emplacement | Chemin | Portée |
|---|---|---|
| Niveau entreprise | Déterminé par les paramètres gérés | Tous les utilisateurs de l'organisation |
| Personnel | ~/.claude/skills/<skill-name>/SKILL.md |
Tous les projets |
| Projet | .claude/skills/<skill-name>/SKILL.md |
Projet actuel uniquement |
| Plugin | <plugin>/skills/<skill-name>/SKILL.md |
Dans le périmètre activé du plugin |
.claude/commands/Les fichiers qu'ils contiennent restent valides et prennent en charge le même frontmatter. Si une compétence et une commande partagent le même nom, la compétence est prioritaire.
Exemples avancés
Exemple 1 : Commande de déploiement (invocation manuelle uniquement)
Exemple
name: deploy
description: Déployer l'application dans l'environnement de production
disable-model-invocation: true
---
Déployer $ARGUMENTS dans l'environnement de production :
1. Exécuter la suite de tests
2. Générer l'application
3. Pousser vers la cible de déploiement
Exemple 2 : Commande de migration de composant avec arguments
Exemple
name: migrate-component
description: Migrer un composant d'un framework à un autre
---
Migrer le composant $0 de $1 vers $2.
Préserver tous les comportements et tests existants.
Utilisation : /migrate-component SearchBar React Vue
Exemple 3 : Commande de résumé de PR avec contexte dynamique
Exemple
name: pr-summary
description: Résumer les modifications d'une Pull Request
context: fork
agent: Explore
allowed-tools: Bash(gh *)
---
## Contexte de la Pull Request
- Diff de la PR: !`gh pr diff`
- Commentaires de la PR: !`gh pr view --comments`
- Fichiers modifiés: !`gh pr diff --name-only`
## Votre tâche
Résumer cette Pull Request...
Commandes slash intégrées
Claude Code fournit quelques commandes intégrées prêtes à l'emploi :
| Commande | Fonction |
|---|---|
/batch <instruction> |
Orchestrer des changements à grande échelle dans la base de code |
/claude-api |
Charger les documents de référence de l'API |
/debug [description] |
Activer la journalisation de débogage |
/loop [interval] <prompt> |
Exécuter les prompts de manière répétée à intervalles réguliers |
/simplify [focus] |
Passer en revue les problèmes de qualité du code |
Bonnes pratiques
1. Comment rédiger la description
La description est la base de l'invocation automatique de Claude, alors assurez-vous de l'écrire clairement :
- Clarifier le moment de déclenchement :
Call when the user requests review / analysis / inspection of code quality - Indiquer les préconditions :
Use after the specification document has been confirmed - Écrire des limites claires : cas dans lesquels il ne doit pas être invoqué
2. Principe de responsabilité unique
Chaque compétence ne doit faire qu'une seule chose, avec des entrées/sorties claires :
/deploy: uniquement responsable du déploiement/test: uniquement responsable de l'exécution des tests/review: uniquement responsable de la revue de code
3. Définir les autorisations d'invocation selon les besoins
- Opérations dangereuses (deploy, delete) : Paramètres
disable-model-invocation: true - Tâches auxiliaires de Claude : Paramètres
user-invocable: false - Workflow général : utiliser la configuration par défaut
4. Utiliser allowed-tools pour restreindre les autorisations
Définir des autorisations minimales pour les opérations critiques de sécurité :
Exemple
name: read-only-analyzer
description: Analyse de code en lecture seule, pour examiner et comprendre le code
allowed-tools: Read, Grep, Glob, Bash(gh *) # Autoriser uniquement ces outils
---
Exécuter une analyse de code en lecture seule...
Stratégie de partage en équipe
Commiter les skills au niveau du projet dans git pour le partage en équipe :
my-project/ ├── .claude/ │ ├── skills/ │ │ ├── deploy/ │ │ │ └── SKILL.md │ │ ├── test/ │ │ │ └── SKILL.md │ │ └── review/ │ │ └── SKILL.md │ └── commands/ # 也可以用 commands/ 目录 └── CLAUDE.md
Référencer et expliquer les skills spécifiques au projet dans CLAUDE.md :
## 自定义斜杠命令 本项目提供以下自定义斜杠命令: - `/deploy [env]` — 部署到指定环境(dev/staging/prod) - `/test [module]` — 运行测试套件或指定模块 - `/review` — 执行标准代码审查 详细使用说明请参考 @.claude/skills/README.md
FAQ
Q : Quelle est la différence entre les skills et le répertoire commands ?
Essentiellement aucune différence..claude/commands/Oui.claude/skills/forme abrégée, les deux formats fonctionnent très bien. S'ils partagent le même nom, les skills sont prioritaires.
Q : Comment passer plusieurs paramètres lors de l'appel ?
Utilisez des guillemets pour entourer plusieurs paramètres :/migrate SearchBar "from:React to:Vue", puis utilisez-le dans le skill$ARGUMENTSpour obtenir la chaîne complète.
Q : Les skills peuvent-ils être utilisés dans les sous-agents ?
Oui. En définissant lecontext: forketagentchamp, les sous-agents peuvent exécuter des skills dans un contexte indépendant.
Q : Comment faire en sorte que Claude se souvienne des compétences couramment utilisées ?
Listez toutes les commandes personnalisées disponibles et leurs scénarios d'utilisation dans CLAUDE.md, et Claude associera automatiquement la compétence appropriée en fonction des descriptions.
Autres extensions