Skip to content

Commands fr

Jump to bottom
Z-M-Huang edited this page Mar 22, 2026 · 2 revisions

Commands · [Français]

Commandes

Référence complète de toutes les commandes CLI de cc-proficiency.

init

Configurer la configuration et le hook de session.

cc-proficiency init

Sans options. S'exécute de manière interactive. Ce qu'il fait :

  • Détecte le nom d'utilisateur GitHub via la CLI gh
  • Auto-détecte la locale depuis LANG/LC_ALL
  • Injecte un Stop hook dans ~/.claude/settings.json
  • Exécute une analyse complète des sessions existantes
  • Crée un Gist privé et envoie le premier badge

Peut être relancé en toute sécurité. Si un Gist existe déjà, il le met à jour au lieu d'en créer un nouveau.

analyze

Analyser les sessions et calculer les scores de compétence.

cc-proficiency analyze [--full]
Option Comportement
(aucune) Incrémental : uniquement les sessions non encore traitées
--full Ré-analyse toutes les sessions depuis le début

Exemple de sortie :

Running full analysis...

  Claude Code Proficiency — @yourname
  ────────────────────────────────────────
  CC Mastery     ███████████████░░░░░   77  ●
  Tool & MCP     ███████████████████░   96  ◐
  Agentic        ██████████████░░░░░░   69  ◐
  Prompt Craft   ████████████████░░░░   81  ◐
  Context Mgmt   ████████████████████  100  ●
  ────────────────────────────────────────
  Hooks   Edit (1411x), Bash (928x), Write (542x) +5
  Skills  dev-buddy-once (5x), chatroom (2x) +5
  Tools   Read 2046 · Bash 1045 · Write 379 · Edit 367 (+12 more)
  ────────────────────────────────────────
  139 sessions · 4 projects

Indicateurs de confiance : ● élevée · ◐ moyenne · ○ faible

process

Traiter les sessions en file d'attente depuis le Stop hook.

cc-proficiency process

Sans options. Cette commande est appelée automatiquement par le hook après chaque session. Vous pouvez aussi l'exécuter manuellement pour vider la file.

Comportement :

  • Acquiert ~/.cc-proficiency/queue.lock (brise les verrous périmés de plus de 60 secondes)
  • Déduplique les entrées par session_id
  • Analyse les transcriptions avec gestion d'erreurs par ligne
  • Calcule les scores, génère le SVG, envoie au Gist si configuré
  • Effectue une rotation atomique du fichier de file d'attente

badge

Générer le fichier SVG du badge.

cc-proficiency badge [--output <file>] [--animated]
Option Comportement
(aucune) Sauvegarde dans ~/.cc-proficiency/cc-proficiency.svg
--output <file> Sauvegarde au chemin spécifié
--animated Génère la variante animée (les barres se remplissent au chargement, les nombres apparaissent progressivement)

Le badge est un SVG multilingue qui s'affiche automatiquement dans la langue préférée du spectateur grâce aux éléments SVG <switch> avec des attributs systemLanguage. Les 6 langues supportées sont intégrées dans un seul fichier.

Exemple :

cc-proficiency badge --output my-badge.svg
# Badge written to my-badge.svg

cc-proficiency badge --animated
# Badge saved to /home/you/.cc-proficiency/cc-proficiency-animated.svg

Nécessite une analyse préalable. Si aucune donnée n'existe, affiche : No analysis data. Run 'cc-proficiency analyze' first.

push

Téléverser les SVGs du badge et les données vers votre Gist GitHub privé.

cc-proficiency push

Sans options. Nécessite que gh soit authentifié et un Gist configuré (exécutez init d'abord).

Envoie trois fichiers de manière atomique : le badge statique, le badge animé et le magasin de données JSON.

Exemple de sortie :

✓ Badge + data pushed to Gist
  Static:   https://gist.githubusercontent.com/yourname/a1b2c3d4e5f6/raw/cc-proficiency.svg
  Animated: https://gist.githubusercontent.com/yourname/a1b2c3d4e5f6/raw/cc-proficiency-animated.svg

explain

Afficher les facteurs de score et les conseils d'amélioration.

cc-proficiency explain

Sans options. Lit le dernier résultat d'analyse et affiche :

  • Les 5 domaines classés par pourcentage (score / maximum atteignable × 100)
  • Les 2 domaines les plus faibles avec des conseils d'amélioration spécifiques
  • Inventaire des fonctionnalités : hooks, skills, serveurs MCP, outils principaux, drapeaux

Les scores sont affichés en pourcentages du maximum théorique de chaque domaine, de sorte que les domaines avec des plafonds différents sont comparables sur la même échelle.

Exemple de sortie :

  Claude Code Proficiency — @yourname

  Strengths:
    Context Mgmt   100% (94/94 max)
    Tool & MCP      86% (74/86 max)
    Prompt Craft    80% (65/81 max)
    CC Mastery      92% (71/77 max)
    Agentic         76% (65/86 max)

  Areas to Improve:
    Agentic (76%)
       → Try more CC features: subagents, MCP servers, skills,
         plan mode, worktrees
    Prompt Craft (80%)
       → Structure prompts with markdown lists, provide code blocks
         and file references

  Feature Usage:
    Hooks:  Edit (1411x), Bash (928x), Write (542x) +5
    Skills: dev-buddy-once (5x), chatroom (2x) +5
    MCP:    github, context7
    Tools:  Read (2046), Bash (1045), Write (379), Edit (367) +12 more
    Flags:  ✓ Plan  ✓ Memory  ✗ Rules  ✓ Agents  ✓ Skills

  139 sessions · 4 projects

Conseils d'amélioration par domaine :

Domaine Conseil
CC Mastery Améliorez CLAUDE.md avec des imports, ajoutez des hooks avec des matchers, créez des fichiers de règles, utilisez le mode plan
Tool & MCP Enchaînez les outils délibérément (Grep→Read→Edit), configurez des serveurs MCP, utilisez l'intégration LSP
Agentic Utilisez des sous-agents de types différents, essayez les agents parallèles et les worktrees
Prompt Craft Structurez les prompts avec des listes markdown, fournissez des blocs de code et des références de fichiers
Context Mgmt Utilisez des fichiers de mémoire entre sessions, travaillez sur plusieurs projets, mettez à jour CLAUDE.md

achievements

Voir la progression des succès.

cc-proficiency achievements

Sans options. Affiche les 15 succès avec des barres de progression.

Exemple de sortie :

  Achievements (7/15)

  👣 First Steps          ████████████ Done!
  🌱 Getting Started      ████████████ Done!
  💯 Century Club         ████░░░░░░░░ 43/100
  ⏱  10 Hour Mark         ████████████ Done!
  🏅 Centurion            ████░░░░░░░░ 39/100
  ⭐ Perfect Score        ████████████ Done!
  🎯 Well-Rounded         ██████████░░ Done!
  🏆 Master Class         ████████████ Done!
  🔥 Week Warrior         ████████████ Done!
  💪 Monthly Grinder      ███░░░░░░░░░ 9/30
  🗺  Explorer            ████████░░░░ 4/5
  🤖 Agent Master         ████████████ Done!
  🔌 MCP Explorer         ████████████ Done!
  🦉 Night Owl            ████████████ Done!
  🌐 Community            ░░░░░░░░░░░░ 0/1

Les données de succès sont extraites du magasin Gist distant quand gh est authentifié, les séries et dates de déblocage sont donc précises. Voir Achievements-fr pour la liste complète.

status

Afficher l'activité du hook, l'état de la file d'attente et la configuration.

cc-proficiency status

Sans options. Exemple de sortie :

  cc-proficiency status

  Username:    yourname
  Gist ID:     a1b2c3d4e5f6
  Auto-upload: true
  Locale:      en
  Leaderboard: not joined

  Sessions processed: 139
  Last updated:       2026-03-18T10:22:00.000Z

  Queue pending:      0

  Hook log (last 10 entries):
    [2026-03-18T10:22:00Z] QUEUED /path/to/session.jsonl
    [2026-03-18T09:11:00Z] QUEUED /path/to/session.jsonl
    ...

  Last hook fired: 2026-03-18T10:22:00Z
  Queue lock:  none

Le verrou de file d'attente affiche ← STALE s'il est maintenu depuis plus de 60 secondes, indiquant une exécution de process bloquée.

config

Afficher ou définir les valeurs de configuration.

cc-proficiency config [key] [value]
Utilisation Comportement
cc-proficiency config Affiche toute la configuration en JSON
cc-proficiency config <key> Affiche une seule valeur
cc-proficiency config <key> <value> Définit une valeur et sauvegarde

Clés configurables :

Clé Type Description
username string Nom d'utilisateur GitHub
gistId string ID du Gist privé pour le badge
autoUpload boolean Téléversement automatique du badge après chaque session
public boolean Rendre le Gist du badge public (par défaut : false)
locale string Langue de la CLI : en, zh-CN, es, fr, ja ou ko
leaderboard boolean Drapeau d'inscription au classement
publicGistId string ID du Gist public de profil (défini par share)

Exemples :

cc-proficiency config
# { "username": "yourname", "gistId": "a1b2c3...", ... }

cc-proficiency config locale zh-CN
# Set locale = zh-CN

cc-proficiency config autoUpload false
# Set autoUpload = false

share

Rejoindre ou quitter le classement communautaire.

cc-proficiency share [--remove]
Option Comportement
(aucune) Rejoindre le classement
--remove Quitter le classement

Rejoindre (cc-proficiency share) :

Prérequis : gh authentifié, Gist configuré, données d'analyse présentes.

Ce qui se passe :

  1. Affiche un avis de confidentialité listant ce qui sera partagé
  2. Synchronise vos données vers votre Gist privé
  3. Crée un Gist public séparé avec votre JSON de profil public
  4. Ouvre un Issue GitHub sur le dépôt cc-proficiency pour vous enregistrer
  5. Sauvegarde leaderboard: true et publicGistId dans la configuration

Exemple de sortie :

  Joining the cc-proficiency leaderboard...

  This will share publicly:
    - GitHub username, domain scores, streak, achievement count
    - Total sessions and hours, member since date

  NOT shared: session details, project names, file paths, tools

  ✓ Public gist created: abc123
  ✓ Registration issue created
    https://github.com/Z-M-Huang/cc-proficiency/issues/42

  Your profile will appear once the issue is processed.

Quitter (cc-proficiency share --remove) :

  1. Ouvre un Issue de suppression sur le dépôt
  2. Supprime votre Gist public
  3. Efface leaderboard et publicGistId de la configuration

Voir Leaderboard-fr et Privacy-fr pour les détails complets.

leaderboard

Voir les classements communautaires.

cc-proficiency leaderboard [--sort=<field>] [--limit=N]
Option Par défaut Valeurs
--sort avg avg, cc-mastery, tool-mcp, agentic, prompt-craft, context-mgmt, hours, streak
--limit 20 Tout entier positif

Exemple de sortie :

  cc-proficiency Leaderboard (12 users)
  ──────────────────────────────────────────────────────────
   #  User             Avg   CC   Tool  Agen  Prmp  Ctx
  ──────────────────────────────────────────────────────────
    1  @alice            94    97    96    91    95    91
    2  @bob              87    82    91    85    88    89
    3  @yourname         84    77    96    69    81   100  ◄
  ...
  ──────────────────────────────────────────────────────────
  12 users · Updated just now

  --sort=<avg|cc-mastery|tool-mcp|agentic|prompt-craft|context-mgmt|hours|streak>
  --limit=N (default 20)

Votre propre entrée est marquée d'un ◄. Les résultats sont mis en cache pour éviter de surcharger GitHub.

uninstall

Supprimer le hook et nettoyer les données locales.

cc-proficiency uninstall

Sans options. Ce qu'il fait :

  1. Supprime le Stop hook de ~/.claude/settings.json
  2. Efface tous les fichiers dans ~/.cc-proficiency/
  3. Supprime le répertoire ~/.cc-proficiency/

Après exécution, supprimez aussi le paquet npm :

npm uninstall -g cc-proficiency

Note : Cela ne supprime pas votre Gist GitHub. Supprimez-le manuellement sur gist.github.com si désiré.

update

Mettre à jour cc-proficiency vers la dernière version.

cc-proficiency update
# Checking for updates...
# Already on the latest version (v0.2.6).

# Ou quand obsolète :
# Update available: v0.2.6 → v0.3.0
# Updating cc-proficiency...
# ✓ Updated to v0.3.0

Vérifie le registre npm pour la dernière version et l'installe globalement. Si le répertoire npm global nécessite des permissions élevées, suggère la commande appropriée (sudo sur Unix, terminal Administrateur sur Windows).

Utilise npm install -g cc-proficiency@<version> en interne (ne met à jour que ce paquet, pas les autres).

version

Afficher les informations de version.

cc-proficiency version
# cc-proficiency v0.2.4 (scoring v3)

Affiche la version du paquet npm et la version interne du moteur de notation. La version de notation s'incrémente quand les poids des règles changent, permettant la détection de résultats en cache obsolètes.

cc-proficiency

English

中文

Español

Français

日本語

한국어

Clone this wiki locally