Files
gh-atournayre-claude-market…/commands/make/command.md
2025-11-29 17:58:42 +08:00

4.3 KiB

model: claude-sonnet-4-5-20250929 allowed-tools: Bash, Write, Read, Glob, Edit, MultiEdit description: Générateur de slash commands pour Claude Code avec workflow structuré et bonnes pratiques argument-hint: [nom-commande] [description] [--tools=outil1,outil2] [--category=categorie]

Générateur de Slash Commands

Créer une nouvelle slash command Claude Code : $ARGUMENTS

Purpose

Générer des slash commands Claude Code bien structurées, documentées et fonctionnelles suivant les conventions du projet.

Relevant files

  • @docs/COMMANDS.md
  • @docs/MODELS.md

Variables

  • COMMAND_NAME: Nom de la commande (format kebab-case)
  • DESCRIPTION: Description courte et claire
  • TOOLS: Outils autorisés (défaut: Bash,Read,Write,Edit)
  • CATEGORY: Catégorie (git, doc, build, sessions, etc.)
  • ARGUMENTS: Format des arguments de la commande

Instructions

Vous êtes un générateur expert de slash commands. Créez des commandes :

  • Focalisées sur un objectif unique
  • Bien documentées avec workflow clair
  • Respectant les conventions du projet
  • Incluant les permissions d'outils appropriées
  • Avec gestion d'erreurs et validation

Relevant Files

  • _templates/prompt/README.md - Template de base
  • commands/ - Exemples de commandes existantes
  • README.md - Documentation du projet

Workflow

Étape 0: Initialisation du Timing

  • Cette commande génère d'autres commandes avec section timing
  • Mais elle-même n'utilise pas de timing dans son workflow
  • Les commandes générées incluront la section timing automatiquement

1. Analyse des arguments

  • Parse COMMAND_NAME, DESCRIPTION, TOOLS, CATEGORY
  • Valide le nom (format kebab-case, pas de caractères spéciaux)
  • Vérifie l'unicité du nom de commande
  • Détermine la catégorie automatiquement si non fournie

2. Génération de la structure

  • Crée le frontmatter YAML avec métadonnées
  • Génère les sections standard adaptées au contexte
  • LIT le template depuis _templates/timing-section.md et l'insère (Read tool)
  • AJOUTE "Étape 0: Initialisation du Timing" en premier dans le Workflow
  • Inclut les outils nécessaires selon la catégorie
  • Ajoute des exemples d'utilisation pertinents

3. Validation et création

  • Vérifie la cohérence et syntaxe
  • Crée le répertoire si nécessaire
  • Sauvegarde dans commands/[category]/[command-name].md
  • Confirme la création avec résumé

4. Documentation

  • Mets à jour "Structure du projet" dans @README.md
  • Ajoutes la description de la commande dans @README.md

Template Structure

---
allowed-tools: [TOOLS]
description: [DESCRIPTION]
argument-hint: [ARGUMENTS]
---

# [TITLE]

[Instructions spécifiques pour Claude]

## Variables
[Variables utilisées dans la commande]

## Relevant Files
[Fichiers pertinents pour la commande]

[INSÉRER ICI le contenu de _templates/timing-section.md via Read]

## Workflow

### Étape 1: [Première vraie étape de la commande]
- [Étapes logiques d'exécution]

### Étape N: Rapport Final
- Afficher le rapport

## Report

[Contenu du rapport]


**IMPORTANT** : Ne PAS copier-coller la section Timing manuellement.
Utiliser `Read` pour lire `_templates/timing-section.md` et l'insérer.

## Examples

### Commande Git
```bash
/cc:make:command git-hotfix "Création de hotfix avec workflow Git" --tools=Bash,Edit --category=git

Commande Build

/cc:make:command deploy-staging "Déploiement en staging" --tools=Bash,Read --category=build "[version]"

Report

  • Crée le fichier dans commands/[category]/[command-name].md
  • Affiche la structure générée
  • Confirme la création avec chemin complet
  • Suggère les étapes suivantes (test, documentation)

Best Practices

  • Nom en kebab-case uniquement
  • Description concise mais claire
  • Outils minimaux nécessaires
  • Workflow en étapes logiques
  • Format de rapport structuré
  • Timing : TOUJOURS lire depuis _templates/timing-section.md (Read tool)
  • Ne JAMAIS copier-coller manuellement la section Timing
  • Étape 0 du workflow = initialisation timing

Maintenance du Template Timing

Si tu dois modifier la section Timing :

  1. Éditer uniquement _templates/timing-section.md
  2. Exécuter ./scripts/sync-timing.sh pour synchroniser les 43 commandes
  3. Ne JAMAIS éditer la section Timing directement dans une commande