Analizador de Complejidad de Código para Openclaw

Una herramienta de análisis estático multilingüe que mide métricas ciclomáticas, cognitivas y estructurales para identificar código de alto riesgo.

charlie-morrison
v1.0.1
May 1, 2026
0
951
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 code-complexity-analyzer

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 code-complexity-analyzer 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 Analizador de Complejidad de Código?

El Analizador de Complejidad de Código es una utilidad robusta diseñada para mantener altos estándares de ingeniería cuantificando qué tan difícil es probar y mantener el código. Al integrar esto dentro de su biblioteca de Openclaw Skills, los desarrolladores pueden escanear automáticamente el código fuente en busca de anidamiento profundo, funciones excesivamente largas y rutas lógicas complejas que conducen a la deuda técnica.

Construido como una herramienta Python pura sin dependencias externas, proporciona una forma eficiente de evaluar archivos Python, JavaScript, TypeScript y Go. Ayuda a los equipos a ir más allá del simple linting al enfocarse en la dificultad percibida de entender el código (Complejidad Cognitiva) y el número de rutas de ejecución independientes (Complejidad Ciclomática).

Casos de uso de Analizador de Complejidad de Código

  • Identificar candidatos a refactorización en bases de código heredadas mediante la localización de funciones de alto riesgo.
  • Configurar puertas de calidad CI/CD para evitar que se fusione código excesivamente complejo.
  • Generar informes de complejidad automatizados en Markdown para revisiones de pull request.
  • Auditar nuevas dependencias o módulos internos para mantenibilidad e integridad estructural.

Cómo funciona Analizador de Complejidad de Código

  1. La herramienta analiza los archivos fuente de destino en un Árbol de Sintaxis Abstracta (AST) para el lenguaje respectivo.
  2. Recorre el árbol para identificar definiciones de funciones y estructuras de control lógico como bucles y condicionales.
  3. Calcula métricas que incluyen Complejidad Ciclomática (CC), Complejidad Cognitiva (COG) y profundidad de anidamiento basadas en la estructura.
  4. Compara estos valores con umbrales configurables para determinar los niveles de riesgo (Simple, Bajo, Moderado o Alto).
  5. Finalmente, genera los resultados en formato de texto, JSON o Markdown y devuelve un código de salida basado en el estado de la infracción.

Configuración de Analizador de Complejidad de Código

Para comenzar a usar esta herramienta con sus Openclaw Skills, asegúrese de tener Python 3 instalado. No se requieren instalaciones adicionales de pip.

# Clone o localice el script
# Analice su directorio de origen
python3 scripts/analyze_complexity.py src/

# Ejecute con umbrales personalizados para una puerta de CI más estricta
python3 scripts/analyze_complexity.py src/ --cc 8 --cog 12

Esquema de datos y taxonomía de Analizador de Complejidad de Código

El analizador organiza sus hallazgos basándose en la granularidad a nivel de función. Rastrea la siguiente taxonomía para cada archivo analizado:

Métrica Descripción Indicador
CC Complejidad Ciclomática Rutas lógicas
COG Complejidad Cognitiva Puntuación de legibilidad
Lines Longitud de Función Escala vertical
Params Recuento de Parámetros Superficie de interfaz
Nesting Profundidad Máxima Sangría lógica

Los resultados de salida se pueden exportar como un objeto JSON estructurado para su integración en otros flujos de trabajo de Openclaw Skills.

Funciones avanzadas de Analizador de Complejidad de Código

  • Soporte de salida multiformato (JSON, Markdown, Text) para una integración perfecta de herramientas.
  • Mapeo de niveles de riesgo configurable para diferenciar entre deuda técnica menor y peligros críticos.
  • Exclusión automática de directorios comunes como node_modules y pycache.
  • Modo detallado para una transparencia total en todas las funciones, no solo en aquellas que violan los umbrales.
  • Códigos de salida estandarizados (0, 1, 2) para una fácil integración en scripts de shell y canales de automatización.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*