Analisador de Complexidade de Código para Openclaw

Uma ferramenta de análise estática multilíngue que mede métricas ciclomáticas, cognitivas e estruturais para identificar código de alto risco.

charlie-morrison
v1.0.1
May 1, 2026
0
951
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install code-complexity-analyzer

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o code-complexity-analyzer usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Analisador de Complexidade de Código?

O Analisador de Complexidade de Código é um utilitário robusto projetado para manter altos padrões de engenharia, quantificando o quão difícil é testar e manter o código. Ao integrar isso em sua biblioteca Openclaw Skills, os desenvolvedores podem escanear automaticamente o código-fonte em busca de aninhamento profundo, funções excessivamente longas e caminhos lógicos complexos que levam à dívida técnica.

Construído como uma ferramenta Python pura sem dependências externas, ele fornece uma maneira eficiente de avaliar arquivos Python, JavaScript, TypeScript e Go. Ajuda as equipes a irem além do simples linting, concentrando-se na dificuldade percebida de entender o código (Complexidade Cognitiva) e no número de caminhos de execução independentes (Complexidade Ciclomática).

Casos de uso do Analisador de Complexidade de Código

  • Identificar candidatos a refatoração em bases de código legadas, apontando funções de alto risco.
  • Configurar portões de qualidade CI/CD para evitar que códigos excessivamente complexos sejam mesclados.
  • Gerar relatórios de complexidade automatizados em Markdown para revisões de pull request.
  • Auditar novas dependências ou módulos internos para manutenibilidade e integridade estrutural.

Como o Analisador de Complexidade de Código funciona

  1. A ferramenta analisa os arquivos de origem de destino em uma Árvore de Sintaxe Abstrata (AST) para a respectiva linguagem.
  2. Ela percorre a árvore para identificar definições de função e estruturas de controle lógico como loops e condicionais.
  3. Ela calcula métricas incluindo Complexidade Ciclomática (CC), Complexidade Cognitiva (COG) e profundidade de aninhamento com base na estrutura.
  4. Ela compara esses valores com limites configuráveis para determinar os níveis de risco (Simples, Baixo, Moderado ou Alto).
  5. Finalmente, ela gera os resultados em formato de texto, JSON ou Markdown e retorna um código de saída com base no status da violação.

Configuração do Analisador de Complexidade de Código

Para começar a usar esta ferramenta com seu Openclaw Skills, certifique-se de ter o Python 3 instalado. Nenhuma instalação adicional de pip é necessária.

# Clone ou localize o script
# Analise seu diretório de origem
python3 scripts/analyze_complexity.py src/

# Execute com limites personalizados para um portão CI mais rigoroso
python3 scripts/analyze_complexity.py src/ --cc 8 --cog 12

Esquema de Dados e Taxonomia de Analisador de Complexidade de Código

O analisador organiza suas descobertas com base na granularidade no nível da função. Ele rastreia a seguinte taxonomia para cada arquivo analisado:

Métrica Descrição Indicador
CC Complexidade Ciclomática Caminhos lógicos
COG Complexidade Cognitiva Pontuação de legibilidade
Lines Comprimento da Função Escala vertical
Params Contagem de Parâmetros Superfície da interface
Nesting Profundidade Máxima Recuo lógico

Os resultados de saída podem ser exportados como um objeto JSON estruturado para integração em outros fluxos de trabalho do Openclaw Skills.

Recursos avançados do Analisador de Complexidade de Código

  • Suporte a saída em vários formatos (JSON, Markdown, Text) para integração perfeita de ferramentas.
  • Mapeamento de nível de risco configurável para diferenciar entre dívida técnica menor e perigos críticos.
  • Exclusão automática de diretórios comuns como node_modules e pycache.
  • Modo detalhado (verbose) para transparência total em todas as funções, não apenas aquelas que violam os limites.
  • Códigos de saída padronizados (0, 1, 2) para fácil integração em scripts shell e pipelines de automação.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*