workspace-surface-audit
Ajuda seu agente a analisar seu ambiente de código e sugere as melhores ferramentas e fluxos de trabalho disponíveis. É útil para entender o que seu agente pode fazer e como configurá-lo.
O que ela faz
Esta ferramenta analisa seu ambiente de trabalho de programação (como repositórios e configurações) para dizer o que já está funcionando, o que está faltando e o que você deveria adicionar ou ativar em seguida para melhorar suas automações.
Quando usar
- ✓Quando você quer saber o que seu ambiente de programação pode fazer agora.
- ✓Antes de instalar novas ferramentas ou automações.
- ✓Para entender quais recursos nativos da plataforma você deveria usar.
Exemplo do que pedir para a IA
“Analise meu repositório e diga quais automações nativas do Claude Code eu deveria configurar primeiro.”
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
Mensagem pronta para colar
Como funciona
Ele verifica seus arquivos de configuração, ferramentas instaladas e configurações de ambiente. Depois, compara o que você tem com o que é possível e sugere as melhores opções nativas para você.
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 workspace-surface-auditOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/workspace-surface-audit/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Auditoria de Superfície de Workspace
Habilidade de auditoria somente leitura para responder à pergunta "o que este workspace e máquina realmente podem fazer agora, e o que devemos adicionar ou habilitar em seguida?"
Esta é a resposta nativa do ECC para plugins de auditoria de configuração. Ela não modifica arquivos, a menos que o usuário solicite explicitamente a implementação de acompanhamento.
Quando Usar
- O usuário diz "configurar Claude Code", "recomendar automações", "quais plugins ou MCPs devo usar?" ou "o que está faltando?"
- Auditoria de uma máquina ou repositório antes de instalar mais habilidades, hooks ou conectores
- Comparação de plugins do marketplace oficial com a cobertura nativa do ECC
- Revisão de
.env,.mcp.json, configurações de plugins ou superfícies de aplicativos conectados para encontrar camadas de fluxo de trabalho ausentes - Decidir se uma capacidade deve ser uma habilidade, hook, agente, MCP ou conector externo
Regras Inegociáveis
- Nunca imprima valores secretos. Exponha apenas nomes de provedores, nomes de capacidades, caminhos de arquivos e se uma chave ou configuração existe.
- Prefira fluxos de trabalho nativos do ECC em vez de conselhos genéricos de "instalar outro plugin" quando o ECC puder gerenciar razoavelmente a superfície.
- Trate plugins externos como benchmarks e inspiração, não como limites autoritativos de produto.
- Separe claramente três coisas:
- já disponível agora
- disponível, mas não bem encapsulado no ECC
- não disponível e exigiria uma nova integração
Entradas da Auditoria
Inspecione apenas os arquivos e configurações necessários para responder bem à pergunta:
- Superfície do repositório
package.json, lockfiles, marcadores de linguagem, configuração de framework,README.md.mcp.json,.lsp.json,.claude/settings*.json,.codex/*AGENTS.md,CLAUDE.md, manifestos de instalação, configurações de hook
- Superfície do ambiente
- arquivos
.env*no repositório ativo e workspaces adjacentes óbvios do ECC - Exponha apenas nomes de chaves como
STRIPE_API_KEY,TWILIO_AUTH_TOKEN,FAL_KEY
- arquivos
- Superfície da ferramenta conectada
- Plugins instalados, conectores habilitados, servidores MCP, LSPs e integrações de aplicativos
- Superfície do ECC
- Habilidades, comandos, hooks, agentes e módulos de instalação existentes que já cobrem a necessidade
Processo de Auditoria
Fase 1: Inventário do que Existe
Produza um inventário compacto:
- alvos ativos do harness
- plugins instalados e aplicativos conectados
- servidores MCP configurados
- servidores LSP configurados
- serviços baseados em ambiente implícitos por nomes de chaves
- habilidades ECC existentes já relevantes para o workspace
Se uma superfície existir apenas como um primitivo, chame a atenção para isso. Exemplo:
- "Stripe está disponível via aplicativo conectado, mas o ECC carece de uma habilidade de operador de faturamento"
- "Google Drive está conectado, mas não há um fluxo de trabalho de operador nativo do ECC para o Google Workspace"
Fase 2: Benchmark Contra Superfícies Oficiais e Instaladas
Compare o workspace com:
- plugins oficiais do Claude que se sobrepõem à configuração, revisão, documentação, design ou qualidade do fluxo de trabalho
- plugins instalados localmente no Claude ou Codex
- as superfícies de aplicativos conectadas atualmente do usuário
Não liste apenas nomes. Para cada comparação, responda:
- o que eles realmente fazem
- se o ECC já tem paridade
- se o ECC tem apenas primitivos
- se o ECC está faltando o fluxo de trabalho inteiramente
Fase 3: Transforme Lacunas em Decisões do ECC
Para cada lacuna real, recomende a forma nativa correta do ECC:
| Tipo de Lacuna | Forma Preferida do ECC |
|---|---|
| Fluxo de trabalho de operador repetível | Habilidade |
| Aplicação automática ou efeito colateral | Hook |
| Papel delegado especializado | Agente |
| Ponte de ferramenta externa | Servidor MCP ou conector |
| Orientação de instalação/bootstrap | Habilidade de configuração ou auditoria |
Prefira habilidades voltadas para o usuário que orquestram ferramentas existentes quando a necessidade é operacional em vez de infraestrutural.
Formato de Saída
Retorne cinco seções nesta ordem:
- Superfície atual
- o que já é utilizável agora
- Paridade
- onde o ECC já corresponde ou excede o benchmark
- Lacunas apenas de primitivos
- ferramentas existem, mas o ECC carece de uma habilidade de operador limpa
- Integrações ausentes
- capacidade ainda não disponível
- 3-5 principais próximos passos
- adições concretas nativas do ECC, ordenadas por impacto
Regras de Recomendação
- Recomende no máximo 1-2 ideias de maior valor por categoria.
- Prefira habilidades com intenção de usuário óbvia e valor de negócio:
- auditoria de configuração
- operações de faturamento/cliente
- operações de issues/programas
- operações do Google Workspace
- controle de implantação/operações
- Se um conector for específico da empresa, recomende-o apenas quando estiver genuinamente disponível ou for claramente útil para o fluxo de trabalho do usuário.
- Se o ECC já tiver um primitivo forte, proponha uma habilidade wrapper em vez de inventar um subsistema totalmente novo.
…
Perguntas frequentes
Essa ferramenta muda meus arquivos?
Não, ela apenas analisa e sugere. Ela só modifica arquivos se você pedir explicitamente para implementar algo depois.
O que são 'ECC-native skills'?
São ferramentas e automações que já vêm com a plataforma Claude Code e são as mais recomendadas para usar.
O que ela mostra se algo não estiver disponível?
Ela separa o que já existe, o que existe mas não está bem integrado, e o que não existe e precisaria de uma nova integração.
Detalhes
Descrição original do autor
Audit the active repo, MCP servers, plugins, connectors, env surfaces, and harness setup, then recommend the highest-value ECC-native skills, hooks, agents, and operator workflows. Use when the user wants help setting up Claude Code or understanding what capabilities are actually available in their environment.
repo: affaan-m/ECC
Popularidade
- Estrelas no GitHub
- 280 mil
- Posição no ranking
- #311
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
accessibility
Ajuda seu agente a criar interfaces que todos possam usar. Garante que sites e aplicativos funcionem bem para pessoas com deficiência, como cegos ou com mobilidade reduzida.
affaan-m/ECC
agent-architecture-audit
Faz seu agente verificar se tudo está funcionando corretamente. Ele encontra e conserta problemas em sistemas de IA, garantindo que funcionem como esperado.
affaan-m/ECC
agent-eval
Ajuda seu agente a comparar diferentes ferramentas de programação de IA. Ele mede qual é mais rápido, barato e confiável para realizar tarefas específicas.
affaan-m/ECC
agent-harness-construction
Faz seu agente entender melhor como realizar tarefas. Ele otimiza as ferramentas e instruções que o agente usa para aumentar suas chances de sucesso.
affaan-m/ECC
Skills parecidas
context-engineering
Otimiza a configuração inicial e as regras para o agente. É útil para garantir que o agente tenha o contexto certo para realizar tarefas de forma eficiente e com qualidade.
addyosmani/agent-skills
doubt-driven-development
Questiona todas as decisões importantes antes de serem tomadas. É útil quando a precisão é crucial, para garantir que não haja falhas escondidas e que o plano seja robusto.
addyosmani/agent-skills
idea-refine
Transforma ideias vagas em planos claros e realizáveis. Ajuda a pensar em diferentes opções e a escolher o melhor caminho a seguir.
addyosmani/agent-skills