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         │
└─────────────────────────────────────────────────────┘
小葱技能有更好的技能skills插件。

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

这个编程助手质量一般。文档看起来很专业，承诺了很多强大功能（代码分析、bug查找、优化建议等），但实际能用的只有基础的代码检查。支持多种编程语言是亮点。不过很多高级功能如自动优化、代码重构、生成测试等只是写在说明里，实际用不了。如果你只需要简单的代码检查和bug提示可以用，但期待更多功能的话可能会失望。