configurar-ecc

Configurar Everything Claude Code

Ejecuta un asistente conversacional dentro del entorno actual. Primero inventaría, recopila solo las opciones compatibles, muestra una vista previa, confirma una vez, aplica de forma no interactiva, verifica y muestra la bienvenida solo después del éxito. Nunca clones ECC en un directorio temporal ni copies componentes de plugins manualmente.

Para un terminal operado por humanos, los puntos de entrada canónicos son ecc setup y npx ecc-universal setup. Dentro de un entorno, usa los siguientes comandos explícitos no interactivos.

Rutear según el entorno actual

• En Claude Code, usa el asistente completo de alcance y hooks que se describe a continuación.
• En Codex, usa el ciclo de vida nativo de plugins de Codex. No ofrezcas alcances de Claude ni intentes mapear los cuatro perfiles de hooks de ECC a Codex.
• En Kimi, instala la superficie del proyecto en ./.kimi-code. Kimi no proporciona los perfiles de hooks del ciclo de vida de Claude de ECC.
• Si el entorno es incierto, indica la evidencia detectada y pregunta qué entorno configurar antes de ejecutar un comando mutante.

Esta habilidad es una ruta de reconfiguración posterior a la instalación. No puede interceptar ni reemplazar la interfaz de instalación inicial integrada de un proveedor.

Claude Code: ejecutar el asistente conversacional completo

1. Inventariar sin cambiar nada

Ejecuta ambos comandos y resume el alcance instalado de ECC, el estado habilitado y la fuente del mercado:

claude plugin list --json
claude plugin marketplace list --json

Trata una instalación única existente de ecc@ecc como una reconfiguración. No interpretes el control "Abrir página de inicio" propiedad del proveedor de Claude como evidencia de instalación. Detente e informa la recuperación devuelta por setup para múltiples alcances de ECC, una instalación heredada/manual, configuraciones malformadas o una colisión en el mercado; nunca adivines qué estado eliminar.

2. Recopilar exactamente dos opciones

Haz exactamente una pregunta sobre el alcance y requiere un valor:

• user | project | local
• user es global para este usuario.
• project se comparte a través de la configuración del repositorio.
• local es privado para el proyecto actual.

Marca visualmente solo el alcance seleccionado como seleccionado o instalando. Si el usuario elige un alcance diferente al de una instalación existente única, descríbelo como una migración de alcance e incluye --move-scope en los comandos siguientes.

Haz exactamente una pregunta sobre el modo de hooks y requiere un valor:

• off | minimal | standard | strict
• off mantiene las habilidades y comandos pero deshabilita la automatización de hooks de ECC.
• minimal habilita la automatización más ligera del ciclo de vida y seguridad.
• standard equilibra las automatizaciones de calidad y seguridad.
• strict habilita las comprobaciones y recordatorios más fuertes.

La preferencia de hooks es una configuración personal del plugin de Claude; no sigue el alcance de instalación seleccionado.

3. Vista previa y confirmación única

Prefiere el script de setup incluido en el plugin. Sustituye los dos valores seleccionados e incluye --move-scope solo para una migración de alcance:

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

Si $CLAUDE_PLUGIN_ROOT no está disponible, usa el paquete npm publicado:

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

Muestra exactamente un resumen de confirmación que contenga la acción planificada, un alcance, un modo de hooks, la acción en el mercado y cualquier migración de origen a destino. Haz una pregunta de sí/no. No ejecutes un ecc setup interactivo a través de una herramienta de shell del entorno porque ese shell normalmente no es TTY.

4. Aplicar las opciones explícitas

Después de la confirmación, vuelve a ejecutar la misma ruta sin --dry-run. Mantén cada opción explícita y solicita JSON para que el éxito pueda comprobarse de manera determinista:

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

Alternativa:

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

5. Verificar, luego mostrar la bienvenida

Requiere un código de salida cero y un resultado de setup cuyo scope y hooks coincidan con los valores seleccionados. Luego ejecuta de forma independiente:

claude plugin list --json

Continúa solo cuando exista exactamente una entrada habilitada ecc@ecc en el alcance seleccionado. Cuando $CLAUDE_PLUGIN_ROOT esté disponible, pasa la action del setup exitoso (installed, updated, migrated, resumed o already-migrated) al renderizador incluido:

Antes de invocarlo, requiere que la versión reportada por el proveedor coincida con ECC_VERSION_PATTERN de scripts/lib/terminal-welcome.js. Rechaza texto de versión inesperado en lugar de interpolarlo en un comando de shell.

node -e 'const { renderTerminalWelcome } = require(process.env.CLAUDE_PLUGIN_ROOT + "/scripts/lib/terminal-welcome"); process.stdout.write(renderTerminalWelcome({ action: process.argv[1], version: process.argv[2], color: process.stdout.isTTY }));' "<action>" "<installed-version>"

Renderiza la bienvenida exactamente una vez. En caso de fallo, simulación, cancelación, discrepancia de alcance o hooks, o estado no verificable, no la renderices; informa el error y la recuperación. Después de cambios verificados, dile al usuario que ejecute /reload-plugins o reinicie Claude Code.

Codex: usar el ciclo de vida nativo de plugins

Inventaría con codex plugin marketplace list --json y codex plugin list --available --json. El comando nativo de plugins de Codex no tiene un selector user | project | local al estilo de Claude. Los plugins nativos de Codex sí admiten hooks específicos del proveedor, pero Codex requiere confianza explícita para ellos. Deja que Codex muestre esa decisión de confianza; no preguntes por los cuatro perfiles de hooks de Claude ni afirmes que esos perfiles se asignan a Codex.

Si falta el mercado de ECC, agrégalo. De lo contrario, actualiza su instantánea:

codex plugin marketplace add affaan-m/ECC
codex plugin marketplace upgrade ecc --json

Pide una confirmación, luego instala o actualiza de forma idempotente el caché instalado y verifícalo:

codex plugin add ecc@ecc --json
codex plugin list --json

Continúa solo cuando el JSON informe que ECC está instalado y proporcione su installedPath. Luego renderiza la bienvenida del paquete verificado:

Usa solo la ruta absoluta exacta installedPath devuelta por el JSON de Codex. Rechaza caracteres de control y requiere que la versión instalada coincida con ECC_VERSION_PATTERN. Invoca node directamente con este array de argumentos; esto es una invocación de API de herramienta, no un comando de shell:

["<installedPath>/scripts/welcome.js", "--action", "configured", "--version", "<installed-version>"]

Si el entorno actual no puede invocar un ejecutable con un array de argumentos separado, omite la bienvenida. Nunca construyas un comando de shell a partir de valores JSON de Codex.

Nunca afirmes que los perfiles off | minimal | standard | strict de Claude se aplicaron a Codex.

Kimi: instalar la superficie del proyecto

Indica el resumen de capacidades antes de la confirmación: destino ./.kimi-code; hooks=unsupported para los hooks del ciclo de vida de ECC. No preguntes por el alcance de Claude ni por el modo de hooks. Primero muestra una vista previa:

npx --yes --package ecc-universal ecc install --profile core --target kimi --dry-run

Muestra una confirmación para ese destino del proyecto, luego aplica el comando idéntico sin --dry-run. Verifica con:

npx --yes --package ecc-universal ecc doctor --target kimi

Solo después de que doctor tenga éxito y las instrucciones y habilidades instaladas permanezcan dentro de ./.kimi-code, renderiza:

npx --yes --package ecc-universal ecc welcome --action configured

No afirmes que Kimi instaló o configuró los hooks del ciclo de vida de ECC.