Configurar ECC

Execute um assistente conversacional dentro do harness atual. Inventarie primeiro, colete apenas as escolhas suportadas, pré-visualize, confirme uma vez, aplique de forma não interativa, verifique e mostre a tela de boas-vindas apenas após o sucesso. Nunca clone o ECC para um diretório temporário ou 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 harness, use os comandos explícitos não interativos abaixo em vez disso.

Roteamento pelo harness atual

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

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

Claude Code: execute o assistente conversacional completo

1. Inventário sem alterar nada

Execute ambos os comandos e resuma o escopo ECC instalado, o estado habilitado e a 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 do Claude como evidência de instalação. Pare e relate a recuperação retornada pela configuração para múltiplos escopos ECC, uma instalação legada/manual, configurações malformadas ou uma colisão de marketplace; nunca adivinhe qual estado excluir.

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-o 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 habilidades e comandos, mas desabilita a automação de hook do ECC.
• minimal habilita o ciclo de vida mais leve e automação de segurança.
• standard equilibra a automação de qualidade e segurança.
• strict habilita as verificações e lembretes mais fortes.

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

3. Pré-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 ação do marketplace e qualquer migração de origem para destino. Faça uma pergunta sim/não. Não execute um ecc setup interativo puro através de uma ferramenta de shell do harness, pois esse shell geralmente não é TTY.

4. Aplique as escolhas explícitas

Após a confirmação, execute a mesma rota novamente sem --dry-run. Mantenha todas as escolhas explícitas 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, então renderize a tela de boas-vindas

Exija um status de saída zero e um resultado de configuração cujos scope e hooks sejam iguais aos valores selecionados. Em seguida, execute independentemente:

claude plugin list --json

Continue apenas quando existir exatamente uma entrada habilitada de ecc@ecc no escopo selecionado. Quando $CLAUDE_PLUGIN_ROOT estiver disponível, passe a configuração bem-sucedida action (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

…