Code Assistant

---

name: code-assistant description: Asistente de programación especializado. Analiza código, encuentra bugs, sugiere optimizaciones, refactoriza y genera documentación automáticamente. metadata: {"openclaw":{"emoji":"💻","auto":false}}

---

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

┌─────────────────────────────────────────────────────┐
│                  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

# 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

# Sugerir optimizaciones
code optimize src/slow-algorithm.py
Optimizar queries SQL
code optimize-sql queries/
Reducir bundle size
code optimize-bundle src/

Refactorización

# 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

# Generar docstrings
code document src/api/
Crear README
code readme src/my-project/
Generar changelog
code changelog --since:v1.0.0

Tests

# Generar tests unitarios
code test-gen src/calculator.ts
Sugerir edge cases
code edge-cases src/validator.py

Ejemplo de Uso

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

| Lenguaje | Análisis | Docs | Tests | |----------|----------|------|-------| | TypeScript/JavaScript | ✅ | ✅ | ✅ | | Python | ✅ | ✅ | ✅ | | Go | ✅ | ✅ | ✅ | | Rust | ✅ | ✅ | ⚠️ | | Java | ✅ | ✅ | ✅ | | C/C++ | ⚠️ | ⚠️ | ⚠️ |

Integración con Coding Agents

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

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

Configuración

| Variable | Descripción | Default | |----------|-------------|---------| | CODE_DEFAULT_STYLE | Estilo de código | auto | | CODE_MAX_COMPLEXITY | Umbral de complejidad | 15 | | CODE_AUTO_FIX | Aplicar fixes automáticamente | false | | CODE_IGNORE_PATTERNS | Patrones a ignorar | node_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