Codebase Stats para Openclaw

Una herramienta de Python sin dependencias para el análisis profundo de bases de código, que mide la complejidad, la distribución de idiomas e indicadores de deuda técnica.

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

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install codebase-stats

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar codebase-stats usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es Codebase Stats?

Codebase Stats es una utilidad de análisis de alto rendimiento diseñada para proporcionar a los desarrolladores y agentes de AI una visión integral de la salud y escala de un proyecto. Como parte central de la biblioteca Openclaw Skills, ofrece una solución sin dependencias para auditar la calidad del código, contar líneas de código (LOC) e identificar la deuda técnica en más de 40 lenguajes de programación.

Al aprovechar esta skill, los equipos pueden obtener información inmediata sobre su arquitectura de software, desde estimaciones de complejidad ciclomática hasta relaciones de código y comentarios. Ya sea que esté realizando una auditoría rápida del tamaño del proyecto o integrando métricas en un pipeline de CI/CD, esta herramienta entrega datos accionables tanto en Markdown legible por humanos como en formatos JSON procesables por máquina.

Casos de uso de Codebase Stats

  • Realización de una auditoría exhaustiva de la calidad del código y señales de deuda técnica como TODOs y FIXMEs.
  • Generación de informes de distribución de idiomas para comprender el stack tecnológico de un nuevo repositorio.
  • Medición de la complejidad ciclomática para identificar funciones de alto riesgo que requieren refactorización.
  • Cálculo del tamaño del proyecto y las líneas de código para documentación o planificación de sprints.
  • Auditoría de recuentos de dependencias en varios gestores de paquetes como npm, pip y Cargo.

Cómo funciona Codebase Stats

  1. El usuario o agente de AI activa la skill especificando una ruta de directorio de destino y filtros opcionales.
  2. El script realiza un escaneo recursivo del sistema de archivos, identificando más de 40 extensiones de archivo compatibles.
  3. Analiza cada archivo para distinguir entre código sin procesar, comentarios y líneas en blanco mientras marca indicadores de deuda técnica.
  4. Se aplican heurísticas de complejidad a funciones y métodos para estimar la complejidad ciclomática.
  5. La herramienta agrega métricas en un informe estructurado basado en el formato solicitado (Markdown, JSON o consola).
  6. El resultado final se devuelve o se guarda en un archivo, proporcionando una instantánea de la salud de la base de código.

Configuración de Codebase Stats

Para comenzar a usar este componente de Openclaw Skills, asegúrese de tener instalado Python 3. No se requieren dependencias externas.

# Navegue al directorio de su script
cd scripts/

# Analice el directorio actual con la configuración predeterminada
python3 codebase_stats.py

# Analice un proyecto específico y genere un informe Markdown
python3 codebase_stats.py /path/to/project --format markdown --output report.md

Esquema de datos y taxonomía de Codebase Stats

La skill organiza los datos de análisis en categorías específicas para informes detallados:

Categoría Métricas Rastreadas
Tamaño Archivos totales, líneas de código, líneas de comentarios, líneas en blanco, líneas por archivo
Idiomas Porcentajes de distribución por recuento de líneas y recuento de archivos
Complejidad Estimaciones de complejidad ciclomática e identificación de las 10 funciones más complejas
Deuda Técnica Recuentos para etiquetas específicas: TODO, FIXME, HACK y XXX
Ecosistema Recuentos de dependencias de archivos de paquetes (package.json, requirements.txt, etc.)
Archivos Grandes Una lista clasificada de los archivos más grandes en el repositorio

Funciones avanzadas de Codebase Stats

  • Soporte de salida multiformato, incluido JSON para una integración perfecta con paneles de CI/CD.
  • Filtrado por idioma específico para aislar métricas de una sola parte de una base de código políglota.
  • Escaneo profundo de señales de deuda técnica para automatizar los controles de calidad del código.
  • Compatibilidad multiplataforma como un script de Python puro sin requisitos de biblioteca externa.
  • Soporte para lenguajes de nicho y archivos de configuración, incluidos Terraform, Protobuf y Solidity.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*