Uma ferramenta Python sem dependências para análise profunda de base de código, medindo complexidade, distribuição de idiomas e indicadores de dívida técnica.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install codebase-stats
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <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 codebase-stats 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 é Codebase Stats?
O Codebase Stats é um utilitário de análise de alto desempenho projetado para fornecer a desenvolvedores e agentes de AI uma visão abrangente da saúde e escala de um projeto. Como parte central da biblioteca Openclaw Skills, oferece uma solução sem dependências para auditar a qualidade do código, contar linhas de código (LOC) e identificar dívida técnica em mais de 40 linguagens de programação.
Ao aproveitar essa skill, as equipes podem obter insights imediatos sobre sua arquitetura de software, desde estimativas de complexidade ciclomática até proporções de código para comentário. Quer você esteja realizando uma auditoria rápida de tamanho de projeto ou integrando métricas em um pipeline de CI/CD, esta ferramenta fornece dados acionáveis nos formatos Markdown legível por humanos e JSON analisável por máquina.
Casos de uso do Codebase Stats
- Realização de uma auditoria abrangente da qualidade do código e sinais de dívida técnica, como TODOs e FIXMEs.
- Geração de relatórios de distribuição de idiomas para entender a stack tecnológica de um novo repositório.
- Medição da complexidade ciclomática para identificar funções de alto risco que requerem refatoração.
- Cálculo do tamanho do projeto e linhas de código para documentação ou planejamento de sprint.
- Auditoria de contagens de dependências em vários gerenciadores de pacotes como npm, pip e Cargo.
Como o Codebase Stats funciona
- O usuário ou agente de AI aciona a skill especificando um caminho de diretório de destino e filtros opcionais.
- O script realiza uma varredura recursiva do sistema de arquivos, identificando mais de 40 extensões de arquivo suportadas.
- Ele analisa cada arquivo para distinguir entre código bruto, comentários e linhas em branco, enquanto sinaliza marcadores de dívida técnica.
- Heurísticas de complexidade são aplicadas a funções e métodos para estimar a complexidade ciclomática.
- A ferramenta agrega métricas em um relatório estruturado com base no formato solicitado (Markdown, JSON ou console).
- A saída final é retornada ou salva em um arquivo, fornecendo um instantâneo da saúde da base de código.
Configuração do Codebase Stats
Para começar a usar este componente do Openclaw Skills, certifique-se de ter o Python 3 instalado. Nenhuma dependência externa é necessária.
# Navegue até o diretório do seu script
cd scripts/
# Analise o diretório atual com as configurações padrão
python3 codebase_stats.py
# Analise um projeto específico e gere um relatório Markdown
python3 codebase_stats.py /path/to/project --format markdown --output report.md
Esquema de Dados e Taxonomia de Codebase Stats
A skill organiza os dados de análise em categorias específicas para relatórios granulares:
| Categoria | Métricas Rastreadas |
|---|---|
| Tamanho | Total de arquivos, linhas de código, linhas de comentário, linhas em branco, linhas por arquivo |
| Idiomas | Porcentagens de distribuição por contagem de linhas e contagem de arquivos |
| Complexidade | Estimativas de complexidade ciclomática e identificação das 10 principais funções complexas |
| Dívida Técnica | Contagens para tags específicas: TODO, FIXME, HACK e XXX |
| Ecossistema | Contagens de dependências de arquivos de pacote (package.json, requirements.txt, etc.) |
| Arquivos Grandes | Uma lista classificada dos maiores arquivos no repositório |
Recursos avançados do Codebase Stats
- Suporte a saída em vários formatos, incluindo JSON para integração perfeita com dashboards de CI/CD.
- Filtragem específica por idioma para isolar métricas de uma única parte de uma base de código poliglota.
- Varredura profunda de sinais de dívida técnica para automatizar verificações de qualidade de código.
- Compatibilidade multiplataforma como um script Python puro com zero requisitos de biblioteca externa.
- Suporte para linguagens de nicho e arquivos de configuração, incluindo Terraform, Protobuf e Solidity.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
Text to Video Hunyuan
Text to Video Hunyuan é uma poderosa ferramenta de geração de AI que transforma prompts de texto descritivos em clipes de vídeo 1080p de alta qualidade em poucos minutos.
API Contract Tester
Um conjunto abrangente de testes para validar contratos de API, garantindo a compatibilidade reversa e detectando mudanças que quebram a compatibilidade em microsserviços.
Cache Strategy Advisor
Um sistema especializado abrangente para analisar padrões de acesso a dados e implementar arquiteturas de cache multicamadas.
Canary Deployment Analyzer
Um utilitário DevOps inteligente para comparar métricas canary e baseline, fornecendo recomendações de promoção ou rollback de implantação baseadas em dados.
CI Build Cache Advisor
Uma ferramenta de otimização inteligente projetada para analisar configurações de CI/CD e implementar estratégias de cache de alto desempenho para reduzir drasticamente os tempos de build.
Babel Config Validator
Uma ferramenta abrangente de linting e validação para arquivos de configuração do Babel para garantir a estabilidade do build e padrões modernos de transpilação.
Apresentou*
