Pular para o conteúdo
Skillpedia
Diversos280 mil · #298

terminal-ops

Faz seu agente executar comandos em um repositório de código. É usado para rodar tarefas, verificar o código ou corrigir falhas, mostrando exatamente o que foi feito.

O que ela faz

Esta ferramenta ajuda a executar comandos em um repositório de código, verificar seu estado e corrigir problemas. Ela garante que as mudanças sejam exatas e verificadas antes de serem enviadas.

Quando usar

  • ✓Quando você precisa executar um comando específico no código.
  • ✓Para verificar o estado atual de um projeto de código.
  • ✓Ao corrigir um erro em um teste ou no processo de compilação.

Exemplo do que pedir para a IA

“Execute o comando 'npm install' no meu projeto e verifique se ele instala todas as dependências corretamente.”

Quer saber mais? Abra as seções abaixo.

Como usar

O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.

Link da skill

https://github.com/affaan-m/ECC/blob/main/skills/terminal-ops/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/affaan-m/ECC/blob/main/skills/terminal-ops/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
Como funciona

A ferramenta primeiro entende onde está o código e qual ação você quer (verificar, corrigir, etc.). Depois, ela examina o problema, faz a menor mudança possível e confirma se a correção funcionou antes de reportar o resultado.

Instalação

Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.

No terminal (Claude Code, Codex, Cursor), na pasta do projeto:

npx skills add affaan-m/ECC --skill terminal-ops

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/terminal-ops/SKILL.md -o SKILL.md
Conteúdo técnico (SKILL.md)

Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.

Terminal Ops

Use isso quando o usuário quiser execução real do repositório: executar comandos, inspecionar o estado do git, depurar CI ou builds, fazer uma correção pontual e relatar exatamente o que mudou e o que foi verificado.

Esta habilidade é intencionalmente mais restrita do que orientações gerais de codificação. É um fluxo de trabalho de operador para execução terminal baseada em evidências.

Pilha de Habilidades

Puxe estas habilidades nativas do ECC para o fluxo de trabalho quando relevante:

  • verification-loop para etapas exatas de prova após as alterações
  • tdd-workflow quando a correção certa precisar de cobertura de regressão
  • security-review quando segredos, autenticação ou entradas externas estiverem envolvidos
  • github-ops quando a tarefa depender de execuções de CI, estado de PR ou status de lançamento
  • knowledge-ops quando o resultado verificado precisar ser capturado em contexto de projeto durável

Quando Usar

  • o usuário diz "corrigir", "depurar", "executar isso", "verificar o repositório" ou "enviar"
  • a tarefa depende da saída do comando, estado do git, resultados de testes ou uma correção local verificada
  • a resposta deve distinguir entre alterado localmente, verificado localmente, commitado e enviado

Barreiras de Proteção

  • inspecionar antes de editar
  • permanecer somente leitura se o usuário pediu apenas auditoria/revisão
  • preferir scripts e auxiliares locais do repositório em vez de wrappers improvisados ad hoc
  • não afirmar que corrigiu até que o comando de prova tenha sido executado novamente
  • não afirmar que enviou a menos que o branch realmente tenha sido movido para upstream

Fluxo de Trabalho

1. Resolver a superfície de trabalho

Definir:

  • caminho exato do repositório
  • branch
  • estado do diff local
  • modo solicitado:
    • inspecionar
    • corrigir
    • verificar
    • enviar

2. Ler a superfície de falha primeiro

Antes de alterar qualquer coisa:

  • inspecionar o erro
  • inspecionar o arquivo ou teste
  • inspecionar o estado do git
  • usar quaisquer logs ou contexto já fornecidos antes de reler cegamente

3. Manter a correção pontual

Resolver uma falha dominante por vez:

  • usar o menor comando de prova útil primeiro
  • só escalar para uma passagem de build/teste maior após a falha local ser abordada
  • se um comando continuar falhando com a mesma assinatura, parar as novas tentativas amplas e estreitar o escopo

4. Relatar o estado exato da execução

Usar palavras de status exatas:

  • inspecionado
  • alterado localmente
  • verificado localmente
  • commitado
  • enviado
  • bloqueado

Formato de Saída

SURFACE
- repo
- branch
- requested mode

EVIDENCE
- failing command / diff / test

ACTION
- what changed

STATUS
- inspected / changed locally / verified locally / committed / pushed / blocked

Armadilhas

  • não trabalhar com memória desatualizada quando o estado vivo do repositório pode ser lido
  • não alargar uma correção pontual para agitação em todo o repositório
  • não usar comandos git destrutivos
  • não ignorar trabalho local não relacionado

Verificação

  • a resposta nomeia o comando de prova ou teste
  • trabalho relacionado ao git nomeia o caminho do repositório e o branch
  • qualquer reivindicação de envio inclui o branch de destino e o resultado exato
Perguntas frequentes

O que significa 'evidência primeiro'?

Significa que a ferramenta sempre mostra provas do que foi feito e verificado, como a saída de um comando ou o resultado de um teste, antes de considerar a tarefa concluída.

Posso usar isso para fazer grandes mudanças no código?

Não, esta ferramenta é feita para correções pequenas e específicas. Ela foca em resolver um problema de cada vez de forma exata.

O que acontece se a correção não funcionar?

A ferramenta vai reportar que a ação está 'bloqueada' e não vai fingir que o problema foi resolvido ou enviado até que a correção seja comprovadamente bem-sucedida.

Detalhes

Descrição original do autor

Evidence-first repo execution workflow for ECC. Use when the user wants a command run, a repo checked, a CI failure debugged, or a narrow fix pushed with exact proof of what was executed and verified.

repo: affaan-m/ECC

Popularidade

Estrelas no GitHub
280 mil
Posição no ranking
#298
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas