configurar-ecc

Configurar ECC (Everything Claude Code)

Execute um assistente conversacional dentro do ambiente atual. Primeiro faça um inventário, colete apenas opções suportadas, pré-visualize, confirme uma vez, aplique de forma não interativa, verifique e mostre as 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.

Roteie pelo ambiente atual

• No Claude Code, use o wizard 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 hook do ECC para o Codex.
• No Kimi, instale a superfície do projeto em ./.kimi-code. O Kimi não fornece os perfis de hook de ciclo de vida do ECC.
• Se o ambiente for incerto, informe as evidências detectadas e pergunte qual ambiente configurar antes de executar um comando mutante.

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

Claude Code: execute o wizard conversacional completo

1. Faça o inventário sem alterar nada

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

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

Trate uma única instalação existente ecc@ecc como uma reconfiguração. Não interprete o controle "Abrir página inicial" do provedor Claude como evidência de instalação. Pare e relate a recuperação retornada pelo setup para múltiplos escopos 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 desabilita a automação de hooks do ECC.
• minimal ativa o ciclo de vida mais leve e automação de segurança.
• 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 segue o escopo de instalação selecionado.

3. Pré-visualize e confirme uma vez

Prefira o script de setup 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. Faça uma pergunta sim/não. Não execute um ecc setup interativo simples através de uma ferramenta de shell de ambiente, pois esse shell geralmente não é um 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

Alternativa:

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

5. Verifique e então renderize as boas-vindas

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

claude plugin list --json

Continue apenas quando exatamente uma entrada ecc@ecc habilitada existir no escopo selecionado. Quando $CLAUDE_PLUGIN_ROOT estiver disponível, passe a action (installed, updated, migrated, resumed, ou already-migrated) do setup bem-sucedido para o renderizador incluído:

Antes de invocá-lo, exija que a versão informada 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 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 as boas-vindas exatamente uma vez. Em caso de falha, pré-visualização, cancelamento, incompatibilidade de escopo ou hook, ou estado não verificável, não as renderize; relate o erro e a recuperação. Após mudanças 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 possui seletor user | project | local do estilo Claude. 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 hook dos quatro perfis do Claude nem afirme que esses perfis se aplicam ao 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 e então instale ou atualize de forma idempotente o cache instalado e verifique:

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

Continue apenas quando o JSON relatar o ECC instalado e fornecer seu installedPath. Em seguida, renderize as 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 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 as boas-vindas. Nunca construa um comando shell a partir de valores JSON do Codex.

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

Kimi: instale a superfície do projeto

Informe o resumo das 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. Pré-visualize primeiro:

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

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

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

Somente após o doctor ter sucesso e as instruções e skills instalados permanecerem dentro de ./.kimi-code, renderize:

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

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