¿Qué hace Guía de ECC?
Usa esta habilidad cuando un usuario necesite ayuda para entender, navegar, instalar o elegir partes de Everything Claude Code.
Cuándo Usarla
Usa esta habilidad cuando el usuario:
- pregunta qué incluye ECC
- quiere ayuda para encontrar una skill, comando, agente, hook, regla o perfil de instalación
- es nuevo en el repositorio y necesita una ruta guiada
- pregunta "¿cómo hago X con ECC?"
- pregunta qué componentes de ECC se adaptan a un proyecto
- necesita una explicación ligera de cómo se relacionan los comandos, skills, agentes, hooks y reglas
- está confundido por las rutas de instalación, instalaciones duplicadas, desinstalaciones/reinicios u opciones de instalación selectiva
Principio Central
Responde desde los archivos actuales, no de la memoria. ECC cambia rápidamente, por lo que los recuentos de catálogo, listas de características e instrucciones de instalación codificados quedan obsoletos.
Cuando el repositorio de ECC esté disponible, inspecciona los archivos relevantes antes de dar una respuesta concreta:
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
Usa el conjunto más pequeño de lecturas necesarias para la pregunta del usuario.
Mapa del Repositorio
README.md: rutas de instalación, guía de desinstalación/reinicio, posicionamiento público, preguntas frecuentesAGENTS.md: guía para contribuidores y estructura del proyectoagent.yaml: superficie exportada del agente gitagent y lista de comandoscommands/: shims de compatibilidad de comandos slash mantenidosskills/*/SKILL.md: flujos de trabajo reutilizables y manuales de dominioagents/*.md: avisos de roles de subagentes delegadosrules/: reglas de lenguaje y arnéshooks/README.md,hooks/hooks.json,scripts/hooks/: comportamiento de hooks y compuertas de seguridadmanifests/install-*.json: módulos, componentes, perfiles y soporte de destino para instalación selectivadocs/: guías de arnés, notas de arquitectura, documentos traducidos, documentos de lanzamiento
Estilo de Respuesta
Comienza con la respuesta, luego da la siguiente acción. La mayoría de los usuarios no necesitan un volcado completo del catálogo.
Forma de una buena primera respuesta:
- qué usar
- por qué se ajusta
- archivo o comando exacto a inspeccionar
- un siguiente comando o pregunta
Evita:
- enumerar cada skill o comando por defecto
- repetir secciones grandes del README
- recomendar shims de comandos retirados cuando exista una ruta skill-first
- afirmar que un componente existe sin verificar el sistema de archivos
- reemplazar la guía de instalación con comandos de copia manual cuando el instalador gestionado admita el destino
Tareas Comunes
Incorporación de Nuevos Usuarios
Ofrece un menú breve:
- instalar o reiniciar ECC
- elegir skills para un proyecto
- entender comandos vs skills
- inspeccionar hooks y comportamiento de seguridad
- ejecutar una auditoría de arnés
- encontrar un flujo de trabajo específico
Señala README.md para instalación/reinicio y /project-init para la incorporación específica del proyecto.
Descubrimiento de Funcionalidades
Para "¿qué debería usar para X?":
- Busca en
skills/,commands/yagents/. - Prefiere skills como la superficie de flujo de trabajo principal.
- Usa comandos solo cuando sean un shim de compatibilidad mantenido o un usuario quiera explícitamente un comportamiento de comando slash.
- Menciona agentes cuando la delegación sea útil.
Búsquedas útiles:
rg -n "<consulta>" skills commands agents docs
find skills -maxdepth 2 -name SKILL.md | sort
Guía de Instalación
Usa rutas de instalación gestionadas:
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
Para instalaciones de skills específicas:
node scripts/install-plan.js --skills <skill-id> --target claude --json
node scripts/install-apply.js --skills <skill-id> --target claude --dry-run
Advierte a los usuarios que no acumulen instalaciones de plugins e instalaciones manuales/completas de perfil a menos que quieran intencionadamente superficies duplicadas.
Configuración de Proyecto
Usa /project-init cuando el usuario quiera ECC configurado para un repositorio de destino. La secuencia esperada es:
- detectar la pila a partir de los archivos del proyecto
- resolver un plan de instalación de prueba (dry-run)
- inspeccionar los archivos
CLAUDE.mdy de configuración existentes - preguntar antes de aplicar cambios
- mantener la guía generada mínima y específica del repositorio
Resolución de Problemas
Primero pregunta por el arnés de destino y la ruta de instalación, luego inspecciona:
- metadatos de instalación del plugin
.claude/,.cursor/,.codex/,.gemini/,.opencode/,.codebuddy/,.joycode/o.qwen/hooks/hooks.json- archivos de estado de instalación
- archivos de comando/skill relevantes
Para la salud del repositorio, sugiere:
npm run harness:audit -- --format text
npm run observability:ready
npm test
Plantillas de Salida
Recomendación Corta
Usa <skill-o-comando>. Se ajusta porque <razón>.
Archivo canónico: <ruta>
Verifica con: <comando>
Siguiente: <una acción concreta>
Resultados de Búsqueda
Mejores coincidencias:
- <ruta>: <por qué es importante>
- <ruta>: <por qué es importante>
Recomendación: <cuál usar primero y por qué>
Resumen del Plan de Instalación
Detectado: <evidencia de la pila>
Destino: <arnés>
Plan: <perfil/módulos/skills>
Prueba (dry run): <comando>
Cambiaría: <rutas>
Requiere aprobación antes de aplicar: <sí/no>
Superficies Relacionadas
/project-init: plan de incorporación consciente de la pila para un repositorio de destino/harness-audit: tarjeta de puntuación de preparación determinista/skill-health: revisión de calidad de skills/skill-create: generar una nueva skill a partir del historial local de git/security-scan: inspeccionar la seguridad de la configuración de Claude/OpenCode