Code Assistant (Asistente de Programación Pro)#

Una super-habilidad para desarrolladores. Va más allá de escribir código: analiza, depura, optimiza, refactoriza y documenta.

Capacidades#

text

┌─────────────────────────────────────────────────────┐
│                  CODE ASSISTANT                      │
├─────────────────────────────────────────────────────┤
│  🔍 Análisis    │  Encuentra bugs y code smells     │
│  ⚡ Optimización │  Mejora rendimiento y eficiencia  │
│  🔄 Refactor    │  Limpia y estructura código       │
│  📝 Documenta   │  Genera docstrings y README       │
│  🧪 Tests       │  Crea tests unitarios             │
│  🔐 Seguridad   │  Detecta vulnerabilidades         │
└─────────────────────────────────────────────────────┘

Comandos#

Análisis de Código#

text

# Analizar un archivo
code analyze src/utils.ts

# Analizar un directorio
code analyze src/ --depth:2

# Buscar bugs específicos
code bugs src/api/
code find-bugs src/

# Revisar complejidad
code complexity src/heavy-function.ts

Optimización#

text

# Sugerir optimizaciones
code optimize src/slow-algorithm.py

# Optimizar queries SQL
code optimize-sql queries/

# Reducir bundle size
code optimize-bundle src/

Refactorización#

text

# Refactorizar archivo
code refactor src/legacy-code.js

# Aplicar convenciones (PEP8, ESLint rules)
code format src/ --style:pep8

# Extraer función
code extract-function src/long-file.ts --lines:45-80

Documentación#

text

# Generar docstrings
code document src/api/

# Crear README
code readme src/my-project/

# Generar changelog
code changelog --since:v1.0.0

Tests#

text

# Generar tests unitarios
code test-gen src/calculator.ts

# Sugerir edge cases
code edge-cases src/validator.py

Ejemplo de Uso#

text

Usuario: code analyze src/users/auth.ts

Bot: 🔍 Análisis de: src/users/auth.ts

     📊 Métricas:
     ├── Líneas: 245
     ├── Funciones: 12
     ├── Complejidad ciclomática: 18 ⚠️ (alta)
     └── Cobertura de docs: 30% ⚠️

     🐛 Bugs Potenciales (2):

     1. Línea 67: Race condition
        ```typescript
        // ❌ Problema
        if (user) {
          await saveUser(user);  // user puede cambiar entre check y save
        }
        ```
        💡 Solución: Usar transacción o lock

     2. Línea 142: SQL Injection
        ```typescript
        // ❌ Problema
        query(`SELECT * FROM users WHERE id = ${userId}`)
        ```
        💡 Solución: Usar parámetros preparados

     ⚡ Optimizaciones Sugeridas (3):

     1. Línea 89: Usar Map en lugar de Object para lookups frecuentes
     2. Línea 156: Memoizar resultado de getPermissions()
     3. Línea 201: Lazy loading para módulo crypto

     🔄 Refactorizaciones Sugeridas:

     1. Extraer validateToken() a módulo separado
     2. Aplicar patrón Repository para queries

     ¿Ejecutar alguna acción? [Documentar] [Refactorizar] [Generar Tests]

Lenguajes Soportados#

LenguajeAnálisisDocsTestsTypeScript/JavaScript✅✅✅Python✅✅✅Go✅✅✅Rust✅✅⚠️Java✅✅✅C/C++⚠️⚠️⚠️

Integración con Coding Agents#

Puede delegar tareas complejas a Codex, Claude Code o Pi:

text

# Usar Codex para refactorizar
code refactor src/legacy.ts --agent:codex

# Usar Claude para documentar
code document src/ --agent:claude

Configuración#

VariableDescripciónDefaultCODE_DEFAULT_STYLEEstilo de códigoauto``CODE_MAX_COMPLEXITYUmbral de complejidad15``CODE_AUTO_FIXAplicar fixes automáticamentefalse``CODE_IGNORE_PATTERNSPatrones a ignorarnode_modules,dist

Reglas de Análisis#

El asistente detecta:

• Security: SQL injection, XSS, path traversal, hardcoded secrets
• Performance: N+1 queries, loops ineficientes, memory leaks
• Style: Nombres inconsistentes, funciones largas, código muerto
• Logic: Null checks faltantes, race conditions, off-by-one errors

Integración#

• self-repair: Los bugs encontrados pueden auto-corregirse
• knowledge-base: Busca en documentación indexada
• expert-researcher: Investiga mejores prácticas