Borcioo/claude-skills

codemap

Exécutez le script fourni. Il lit l'arborescence de travail à jour à chaque appel et imprime une carte compacte et triée ; il n'écrit jamais rien.

${CLAUDE_SKILL_DIR}/scripts/codemap --ext php,blade.php --dir app
${CLAUDE_SKILL_DIR}/scripts/codemap --ext css,scss --symbols
${CLAUDE_SKILL_DIR}/scripts/codemap --ext ts,tsx --dir src --symbols --max 150

Options : --ext (séparé par des virgules, pas de points nécessaires), --dir, --symbols, --max (limite de lignes de sortie, défaut 300), --exclude REGEX (répétable).

La sortie ressemble à :

# codemap : 12 fichiers dans 3 répertoires (dir : app, ext : php, via rg)
Http/Controllers/
  UserController.php : class UserController, fn index, fn store

Quand l'utiliser

• Vous avez besoin de tous les fichiers d'un ou plusieurs types et ne savez pas où ils se trouvent.
• Vous êtes sur le point de lire plusieurs fichiers uniquement pour apprendre ce qu'ils définissent : exécutez d'abord avec --symbols et lisez uniquement les fichiers importants.
• Un sous-agent commence à travailler dans une zone inconnue : passez-lui la codemap de ce répertoire au lieu de le laisser chercher à partir de zéro.

Quand ne pas l'utiliser

• Vous connaissez le nom du fichier ou un motif précis : utilisez Glob.
• Vous avez besoin du texte contenu dans les fichiers : utilisez Grep.
• Vous avez besoin des définitions ou des références d'un symbole et un plugin LSP est activé : utilisez l'outil LSP.

Pièges

• .gitignore est respecté lorsque ripgrep ou git est disponible ; vendor/, node_modules/, les sorties de build, les fichiers minifiés et les source maps sont toujours ignorés.
• Les symboles proviennent de motifs basés sur les lignes, pas d'un analyseur syntaxique : classes/fonctions PHP de premier niveau, export JS/TS, class/def Python de premier niveau, type/func Go, propriétés CSS personnalisées (sous forme de compteur) et mixins SCSS/Less. Traitez-les comme une table des matières, puis lisez le fichier.
• Lorsque la sortie se termine par # ... tronqué, réduisez avec --dir, --ext ou --exclude au lieu d'augmenter fortement --max.