configurar-ecc

Configurar Everything Claude Code

Execute um assistente conversacional dentro do ambiente atual. Faça o inventário primeiro, colete apenas as opções suportadas, visualize, confirme uma vez, aplique de forma não interativa, verifique e exiba a mensagem de boas-vindas somente após o sucesso. Nunca clone o ECC em um diretório temporário nem copie componentes de plugin manualmente.

Para um terminal operado por humanos, os pontos de entrada canônicos são ecc setup e npx ecc-universal setup. Dentro de um ambiente, use os comandos explícitos não interativos abaixo.

Roteamento conforme o ambiente atual

• No Claude Code, use o assistente completo de escopo e hooks abaixo.
• No Codex, use o ciclo de vida nativo de plugins do Codex. Não ofereça escopos do Claude nem mapeie os quatro perfis de hooks do ECC para o Codex.
• No Kimi, instale a superfície do projeto em ./.kimi-code. O Kimi não fornece os perfis de hooks de ciclo de vida do Claude do ECC.
• Se o ambiente for incerto, informe a evidência detectada e pergunte qual ambiente configurar antes de executar um comando mutável.

Esta skill é um caminho de reconfiguração pós-instalação. Ela não pode interceptar ou substituir a UI de primeira instalação de um provedor.

Claude Code: execute o assistente conversacional completo

1. Inventário sem alterar nada

Execute ambos os comandos e resuma o escopo do ECC instalado, estado ativo e origem do marketplace:

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

Trate uma única instalação existente de ecc@ecc como uma reconfiguração. Não interprete o controle "Abrir página inicial" de propriedade do provedor como evidência de instalação. Pare e informe a recuperação retornada pela configuração para múltiplos escopos do ECC, uma instalação legada/manual, configurações malformadas ou uma colisão no marketplace; nunca adivinhe qual estado deletar.

2. Colete exatamente duas escolhas

Faça exatamente uma pergunta de escopo e exija um valor:

• user | project | local
• user é global para este usuário.
• project é compartilhado através das configurações do repositório.
• local é privado para o projeto atual.

Marque visualmente apenas o escopo selecionado como selecionado ou instalando. Se o usuário escolher um escopo diferente de uma única instalação existente, descreva como uma migração de escopo e inclua --move-scope nos comandos abaixo.

Faça exatamente uma pergunta de modo de hook e exija um valor:

• off | minimal | standard | strict
• off mantém skills e comandos, mas desativa a automação de hooks do ECC.
• minimal ativa a automação de ciclo de vida e segurança mais leve.
• standard equilibra automação de qualidade e segurança.
• strict ativa as verificações e lembretes mais fortes.

A preferência de hook é uma configuração pessoal do plugin Claude; ela não acompanha o escopo de instalação selecionado.

3. Visualize e confirme uma vez

Prefira o script de configuração incluído no plugin. Substitua os dois valores selecionados e inclua --move-scope apenas para uma migração de escopo:

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

Se $CLAUDE_PLUGIN_ROOT não estiver disponível, use o pacote npm publicado:

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

Mostre exatamente um resumo de confirmação contendo a ação planejada, um escopo, um modo de hook, ação no marketplace e qualquer migração de origem para destino. Pergunte uma única pergunta sim/não. Não execute um ecc setup interativo simples através de uma ferramenta de shell do ambiente, pois esse shell geralmente não é TTY.

4. Aplique as escolhas explícitas

Após a confirmação, execute novamente a mesma rota sem --dry-run. Mantenha cada escolha explícita e solicite JSON para que o sucesso possa ser verificado deterministicamente:

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

Fallback:

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

5. Verifique, depois renderize a mensagem de boas-vindas

Exija um status de saída zero e um resultado de configuração cujo scope e hooks correspondam aos valores selecionados. Em seguida, execute de forma independente:

claude plugin list --json

Continue somente quando existir exatamente uma entrada ativa de ecc@ecc no escopo selecionado. Quando $CLAUDE_PLUGIN_ROOT estiver disponível, passe a action bem-sucedida da configuração (installed, updated, migrated, resumed, ou already-migrated) para o renderizador incluído:

Antes de invocá-lo, exija que a versão relatada pelo provedor corresponda a ECC_VERSION_PATTERN de scripts/lib/terminal-welcome.js. Rejeite texto de versão inesperado em vez de interpolá-lo em um 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>"

Renderize a mensagem de boas-vindas exatamente uma vez. Em caso de falha, simulação, cancelamento, incompatibilidade de escopo ou hook, ou estado não verificável, não a renderize; relate o erro e a recuperação. Após alterações verificadas, informe ao usuário para executar /reload-plugins ou reiniciar o Claude Code.

Codex: use o ciclo de vida nativo de plugins

Faça o inventário com codex plugin marketplace list --json e codex plugin list --available --json. O comando nativo de plugins do Codex não tem seletor user | project | local do estilo Claude. Os plugins nativos do Codex suportam hooks específicos do provedor, mas o Codex exige confiança explícita para eles. Deixe o Codex mostrar essa decisão de confiança; não faça a pergunta de hooks de quatro perfis do Claude nem alegue que esses perfis mapeiam para o Codex.

Se o marketplace do ECC estiver faltando, adicione-o. Caso contrário, atualize seu snapshot:

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

Peça uma confirmação, depois instale ou atualize de forma idempotente o cache instalado e verifique:

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

Continue somente quando o JSON relatar que o ECC está instalado e fornecer seu installedPath. Em seguida, renderize a mensagem de boas-vindas do pacote verificado:

Use apenas o installedPath absoluto exato retornado pelo JSON do Codex. Rejeite caracteres de controle e exija que a versão instalada corresponda a ECC_VERSION_PATTERN. Invoque node diretamente com este array de argumentos; esta é uma invocação de API de ferramenta, não um comando de shell:

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

Se o ambiente atual não puder invocar um executável com um array de argumentos separado, pule a mensagem de boas-vindas. Nunca construa um comando de shell a partir de valores JSON do Codex.

Nunca alegue que os perfis off | minimal | standard | strict do Claude foram aplicados ao Codex.

Kimi: instale a superfície do projeto

Informe o resumo de capacidades antes da confirmação: destino ./.kimi-code; hooks=unsupported para hooks de ciclo de vida do ECC. Não faça as perguntas de escopo ou modo de hook do Claude. Visualize primeiro:

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

Mostre uma confirmação para esse destino de projeto, depois aplique o comando idêntico sem --dry-run. Verifique com:

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

Somente após o doctor for bem-sucedido e as instruções e skills instaladas permanecerem dentro de ./.kimi-code, renderize:

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

Não alegue que o Kimi instalou ou configurou hooks de ciclo de vida do ECC.