mirror of
https://github.com/affaan-m/ECC.git
synced 2026-10-26 18:35:05 +00:00
fix(install): harden universal setup release path (#2888)
* fix(install): harden universal setup release path * docs(adal): use ecc-universal doctor command
This commit is contained in:
1 parent
ce64e417fd
commit
005eff40fd
28 files changed
+1252
-98
No files matched your search
+8
-8
@@ -212,7 +212,7 @@ La mayoría de los usuarios de Claude Code deben usar exactamente un método de
|
||||
|
||||
- **Opción recomendada por defecto:** instala el plugin de Claude Code, luego copia solo las carpetas de reglas que realmente necesites.
|
||||
- **Usa el instalador manual solo si** quieres un control más granular, deseas evitar completamente la ruta del plugin o tu build de Claude Code tiene problemas para resolver la entrada del marketplace autoalojado.
|
||||
- **No combines métodos de instalación.** La configuración rota más común es: `/plugin install` primero, luego `install.sh --profile full` o `npx ecc-install --profile full` después.
|
||||
- **No combines métodos de instalación.** La configuración rota más común es: `/plugin install` primero, luego `install.sh --profile full` o `npx ecc-universal install --profile full` después.
|
||||
|
||||
Si ya combinaste múltiples instalaciones y hay duplicados, salta directamente a [Restablecer / Desinstalar ECC](#restablecer--desinstalar-ecc).
|
||||
|
||||
@@ -227,7 +227,7 @@ Si los hooks te parecen demasiado globales o solo quieres las reglas, agentes, c
|
||||
```powershell
|
||||
.\install.ps1 --profile minimal --target claude
|
||||
# o
|
||||
npx ecc-install --profile minimal --target claude
|
||||
npx ecc-universal install --profile minimal --target claude
|
||||
```
|
||||
|
||||
Este perfil excluye intencionalmente `hooks-runtime`.
|
||||
@@ -249,7 +249,7 @@ Añade hooks después solo si quieres aplicación en tiempo de ejecución:
|
||||
Si no estás seguro de qué perfil o componente de ECC instalar, consulta al asesor empaquetado desde cualquier proyecto:
|
||||
|
||||
```bash
|
||||
npx ecc consult "security reviews" --target claude
|
||||
npx ecc-universal consult "security reviews" --target claude
|
||||
```
|
||||
|
||||
Devuelve los componentes coincidentes, los perfiles relacionados y los comandos de vista previa/instalación. Usa el comando de vista previa antes de instalar si quieres inspeccionar el plan de archivos exacto.
|
||||
@@ -257,8 +257,8 @@ Devuelve los componentes coincidentes, los perfiles relacionados y los comandos
|
||||
Para flujos de trabajo de ML/MLOps en producción, mantén la instalación opt-in y con alcance de componentes:
|
||||
|
||||
```bash
|
||||
npx ecc consult "mlops training model deployment" --target claude
|
||||
npx ecc install --profile minimal --target claude --with capability:machine-learning
|
||||
npx ecc-universal consult "mlops training model deployment" --target claude
|
||||
npx ecc-universal install --profile minimal --target claude --with capability:machine-learning
|
||||
```
|
||||
|
||||
### Paso 1: Instalar el Plugin (Recomendado)
|
||||
@@ -287,7 +287,7 @@ Esto es intencional. Las instalaciones del marketplace/plugin de Anthropic se id
|
||||
|
||||
> ADVERTENCIA: **Importante:** Los plugins de Claude Code no pueden distribuir `rules` automáticamente.
|
||||
>
|
||||
> Si ya instalaste ECC mediante `/plugin install`, **no ejecutes `./install.sh --profile full`, `.\install.ps1 --profile full`, ni `npx ecc-install --profile full` después**. El plugin ya carga las skills, comandos y hooks de ECC. Ejecutar el instalador completo tras una instalación del plugin copia esas mismas superficies en tus directorios de usuario y puede crear skills duplicadas más comportamiento duplicado en tiempo de ejecución.
|
||||
> Si ya instalaste ECC mediante `/plugin install`, **no ejecutes `./install.sh --profile full`, `.\install.ps1 --profile full`, ni `npx ecc-universal install --profile full` después**. El plugin ya carga las skills, comandos y hooks de ECC. Ejecutar el instalador completo tras una instalación del plugin copia esas mismas superficies en tus directorios de usuario y puede crear skills duplicadas más comportamiento duplicado en tiempo de ejecución.
|
||||
>
|
||||
> Para instalaciones de plugin, copia manualmente solo los directorios `rules/` que quieras bajo `~/.claude/rules/ecc/`. Empieza con `rules/common` más un pack de lenguaje o framework que uses realmente. No copies todos los directorios de reglas a menos que quieras explícitamente todo ese contexto en Claude.
|
||||
>
|
||||
@@ -322,7 +322,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/ecc/"
|
||||
|
||||
# Ruta de instalación completamente manual (usa esto en lugar de /plugin install)
|
||||
# .\install.ps1 --profile full
|
||||
# npx ecc-install --profile full
|
||||
# npx ecc-universal install --profile full
|
||||
```
|
||||
|
||||
Para instrucciones de instalación manual consulta el README en la carpeta `rules/`. Al copiar reglas manualmente, copia el directorio completo del lenguaje (por ejemplo `rules/common` o `rules/golang`), no los archivos dentro de él, para que las referencias relativas sigan funcionando y los nombres de archivo no colisionen.
|
||||
@@ -338,7 +338,7 @@ Usa esto solo si estás omitiendo intencionalmente la ruta del plugin:
|
||||
```powershell
|
||||
.\install.ps1 --profile full
|
||||
# o
|
||||
npx ecc-install --profile full
|
||||
npx ecc-universal install --profile full
|
||||
```
|
||||
|
||||
Si eliges esta ruta, detente aquí. No ejecutes también `/plugin install`.
|
||||
|
||||
Reference in new issue
Block a user