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ètresdisable-model-invocation: true
  • Tâches auxiliaires de Claude : Paramètresuser-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