ecc-guide

Guide ECC

Utilisez cette skill lorsqu'un utilisateur a besoin d'aide pour comprendre, naviguer, installer ou choisir des composants de Everything Claude Code.

Quand l'utiliser

Utilisez cette skill lorsque l'utilisateur :

• demande ce qu'inclut ECC
• souhaite de l'aide pour trouver une skill, une commande, un agent, un hook, une règle ou un profil d'installation
• est nouveau dans le dépôt et a besoin d'un chemin guidé
• demande "comment faire X avec ECC ?"
• demande quels composants ECC correspondent à un projet
• a besoin d'une explication légère de la relation entre commandes, skills, agents, hooks et règles
• est perdu face aux chemins d'installation, aux installations en double, à la réinitialisation/désinstallation, ou aux options d'installation sélective

Principe Fondamental

Répondez à partir des fichiers actuels, pas de la mémoire. ECC change rapidement, donc les décomptes de catalogues, listes de fonctionnalités et instructions d'installation codés en dur deviennent obsolètes.

Lorsque le dépôt ECC est disponible, inspectez les fichiers pertinents avant de donner une réponse concrète :

node scripts/ci/catalog.js --json
find skills -maxdepth 2 -name SKILL.md | sort
find commands -maxdepth 1 -name '*.md' | sort
find agents -maxdepth 1 -name '*.md' | sort
node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --list-components --json

Utilisez le plus petit ensemble de lectures nécessaire pour répondre à la question de l'utilisateur.

Plan du dépôt

• README.md : chemins d'installation, guide de désinstallation/réinitialisation, positionnement public, FAQ
• AGENTS.md : guide du contributeur et structure du projet
• agent.yaml : surface exportée de l'agent GitAgent et liste des commandes
• commands/ : shims de compatibilité maintenus pour les commandes slash
• skills/*/SKILL.md : workflows réutilisables et guides thématiques
• agents/*.md : invites de rôle pour les sous-agents délégués
• rules/ : règles de langage et de cadre
• hooks/README.md, hooks/hooks.json, scripts/hooks/ : comportement des hooks et portes de sécurité
• manifests/install-*.json : modules d'installation sélective, composants, profils et support des cibles
• docs/ : guides du framework, notes d'architecture, documentation traduite, documentation de version

Style de réponse

Commencez par la réponse, puis donnez l'action suivante. La plupart des utilisateurs n'ont pas besoin d'un vidage complet du catalogue.

Bon format de première réponse :

1. quoi utiliser
2. pourquoi cela convient
3. le fichier ou la commande exact(e) à inspecter
4. une commande ou question suivante

À éviter :

• lister chaque skill ou commande par défaut
• répéter de grandes sections du README
• recommander des shims de commande obsolètes lorsqu'un chemin skill-first existe
• affirmer qu'un composant existe sans vérifier le système de fichiers
• remplacer les instructions d'installation par des commandes de copie manuelle lorsque l'installateur géré prend en charge la cible

Tâches courantes

Accueil des nouveaux utilisateurs

Proposez un menu court :

• installer ou réinitialiser ECC
• choisir des skills pour un projet
• comprendre les commandes vs les skills
• inspecter les hooks et le comportement de sécurité
• exécuter un audit du framework
• trouver un workflow spécifique

Indiquez README.md pour l'installation/réinitialisation et /project-init pour l'accueil spécifique au projet.

Découverte de fonctionnalités

Pour "que devrais-je utiliser pour X ?" :

1. Recherchez dans skills/, commands/ et agents/.
2. Privilégiez les skills comme surface de workflow principale.
3. Utilisez les commandes uniquement lorsqu'il s'agit d'un shim de compatibilité maintenu ou si l'utilisateur souhaite explicitement un comportement de commande slash.
4. Mentionnez les agents lorsque la délégation est utile.

Recherches utiles :

rg -n "<requête>" skills commands agents docs
find skills -maxdepth 2 -name SKILL.md | sort

Guide d'installation

Utilisez les chemins d'installation gérés :

node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --profile minimal --target claude --json
node scripts/install-apply.js --profile minimal --target claude --dry-run

Pour des installations de skills spécifiques :

node scripts/install-plan.js --skills <skill-id> --target claude --json
node scripts/install-apply.js --skills <skill-id> --target claude --dry-run

Avertissez les utilisateurs de ne pas cumuler les installations de plugins avec les installations manuelles complètes/profils, sauf s'ils souhaitent intentionnellement des surfaces en double.

Accueil de projet

Utilisez /project-init lorsque l'utilisateur souhaite configurer ECC pour un dépôt cible. La séquence attendue est :

1. détecter la stack à partir des fichiers du projet
2. résoudre un plan d'installation simulé (dry-run)
3. inspecter les fichiers CLAUDE.md et de paramètres existants
4. demander avant d'appliquer les modifications
5. garder les conseils générés minimaux et spécifiques au dépôt

Dépannage

Demandez d'abord le framework cible et le chemin d'installation, puis inspectez :

• les métadonnées d'installation du plugin
• .claude/, .cursor/, .codex/, .gemini/, .opencode/, .codebuddy/, .joycode/, ou .qwen/
• hooks/hooks.json
• les fichiers d'état d'installation
• les fichiers de commandes/skills pertinents

Pour la santé du dépôt, suggérez :

npm run harness:audit -- --format text
npm run observability:ready
npm test

Modèles de sortie

Recommandation courte

Utilisez <skill-ou-commande>. Cela convient car <raison>.

Fichier canonique : <chemin>
Vérifier avec : <commande>
Suite : <une action concrète>

Résultats de recherche

Meilleures correspondances :
- <chemin> : <pourquoi c'est important>
- <chemin> : <pourquoi c'est important>

Recommandation : <lequel utiliser en premier et pourquoi>

Résumé du plan d'installation

Détecté : <preuve de stack>
Cible : <framework>
Plan : <profil/modules/skills>
Simulation : <commande>
Modifierait : <chemins>
Nécessite approbation avant application : <oui/non>

Surfaces connexes

• /project-init : plan d'accueil prenant en compte la stack pour un dépôt cible
• /harness-audit : fiche d'évaluation déterministe de la préparation
• /skill-health : évaluation de la qualité des skills
• /skill-create : générer une nouvelle skill à partir de l'historique Git local
• /security-scan : inspecter la sécurité de la configuration Claude/OpenCode