🦂 Scorpk Agent - Extensión de VS Code

Scorpk Agent es una extensión avanzada de inteligencia artificial para Visual Studio Code, diseñada para integrarse directamente en el flujo de trabajo del desarrollador moderno. Aprovecha el poder de los modelos de lenguaje de Groq, en especial LLaMA 3, para ofrecer una experiencia de codificación más rápida, inteligente y estructurada.

✨ Características Principales

🎯 Interfaz de Usuario Avanzada

• Panel lateral integrado: Acceso directo desde la barra lateral de VS Code
• Diseño futurista: Interface oscura con acentos en azul eléctrico y negro metálico
• Chat interactivo: Conversación estilo terminal/IDE con soporte para múltiples líneas
• Historial persistente: Mantiene el contexto de conversaciones anteriores
• Indicadores visuales: Estados de escritura, contexto activo y modo actual

🧠 Modos de Operación

Modo Exploración (Vibe Mode)

• Ideal para comenzar desde cero sin requerimientos estrictos
• Brainstorming de ideas técnicas y no técnicas
• Prototipos rápidos en múltiples lenguajes
• Asistencia para pruebas rápidas, snippets y estructuras base
• Exploración de herramientas, frameworks y decisiones técnicas

Modo Planificación (Spec Mode)

• Para proyectos que exigen orden y previsibilidad
• Generación de documentación técnica (README, requerimientos, diseños)
• Creación de flujos arquitectónicos y análisis de dependencias
• Generación de diagramas y estructuras iniciales
• Soporte para metodologías ágiles, TDD y arquitectura limpia

🔧 Capacidades Técnicas Avanzadas

Integración con Groq API

• Modelo: LLaMA 3 (llama3-70b-8192) para respuestas ultra rápidas
• Control de contexto: Gestión inteligente de memoria conversacional
• Respuestas enriquecidas: Ejemplos de código completos y explicaciones claras
• Configuración flexible: API key personalizable y parámetros ajustables

Características de Desarrollo

• Autocompletado inteligente: Sugerencias contextuales basadas en comentarios
• Explicaciones hover: Información detallada al pasar el mouse sobre código
• Acciones de código: Refactorización, optimización y corrección automática
• Navegación inteligente: Búsqueda de definiciones asistida por IA
• Generación de tests: Creación automática de pruebas unitarias

🌐 Integración Profunda con VS Code

Manipulación de Archivos y Proyectos

• Lectura, creación y modificación de archivos automática
• Navegación inteligente entre documentos
• Gestión de workspace y proyectos

Control del Editor

• Modificación directa del contenido del editor
• Ejecución de comandos internos y de extensiones
• Acceso completo a terminales integradas

Inteligencia en Tiempo Real

• Monitoreo constante de cambios en el código
• Sugerencias contextuales automáticas
• Correcciones y refactorizaciones en tiempo real

🚀 Instalación

Requisitos Previos

• Visual Studio Code 1.74.0 o superior
• Conexión a internet para acceso a Groq API

Instalación desde VSIX

1. Descarga el archivo .vsix de la extensión
2. Abre VS Code
3. Ve a la vista de Extensiones (Ctrl+Shift+X)
4. Haz clic en "..." y selecciona "Install from VSIX..."
5. Selecciona el archivo descargado

Configuración Inicial

1. Abre la configuración de VS Code (Ctrl+,)
2. Busca "Scorpk Agent"
3. (Opcional) Configura tu propia API key de Groq para mejor rendimiento
4. Ajusta los parámetros según tus preferencias

📖 Guía de Uso

Activación

• Atajo de teclado: Ctrl+Shift+S (Cmd+Shift+S en Mac)
• Paleta de comandos: Scorpk Agent: Abrir Chat
• Panel lateral: Haz clic en el icono de Scorpk Agent

Comandos Principales

Menú Contextual

Haz clic derecho en código seleccionado para acceder a:

• Explicar código seleccionado: Análisis detallado del código
• Refactorizar código: Mejoras y optimizaciones
• Generar documentación: Comentarios y documentación automática
• Crear tests: Generación de pruebas unitarias

Autocompletado Inteligente

1. Escribe un comentario describiendo lo que necesitas
2. Usa /, * o @ para activar sugerencias
3. Selecciona la sugerencia de Scorpk Agent
4. El código se insertará automáticamente

Hover Inteligente

• Pasa el mouse sobre cualquier elemento de código
• Scorpk Agent proporcionará explicaciones contextuales
• Información sobre tipos, propósitos y ejemplos de uso

⚙️ Configuración

Parámetros Disponibles

Configuración de API Key

{
  "scorpk.groqApiKey": "tu_api_key_aqui",
  "scorpk.temperature": 0.8,
  "scorpk.maxTokens": 8192
}

🎨 Experiencia Conversacional

Contexto Visual Activo

• Archivo activo: Muestra el archivo actual en edición
• Vista previa en línea: Fragmentos de código en tiempo real
• Actualización automática: Sincronización con cambios del editor

Seguimiento de Actividad

• Historial de edición: Registro de cambios significativos
• Archivos recientes: Lista de archivos visitados
• Resúmenes de sesión: Documentación automática del progreso

Modo Colaborativo

• Notificaciones inteligentes: Alertas sobre errores y mejoras
• Sugerencias proactivas: Recomendaciones basadas en patrones
• Panel de actividad: Historial visual de interacciones

🔧 Desarrollo y Contribución

Estructura del Proyecto

scorpk-agent-extension/
├── src/
│   ├── extension.ts          # Punto de entrada principal
│   ├── webview/             # Interfaz de chat
│   ├── commands/            # Comandos de la extensión
│   ├── providers/           # Proveedores de VS Code
│   └── utils/               # Servicios y utilidades
├── icons/                   # Iconos de la extensión
├── package.json            # Configuración de la extensión
└── README.md              # Documentación

Compilación

# Instalar dependencias
npm install

# Compilar TypeScript
npm run compile

# Modo watch para desarrollo
npm run watch

# Empaquetar extensión
npm run package

Testing

# Ejecutar tests
npm test

# Linting
npm run lint

🐛 Solución de Problemas

Problemas Comunes

La extensión no se activa

• Verifica que VS Code sea versión 1.74.0 o superior
• Revisa la consola de desarrollador (Help > Toggle Developer Tools)
• Reinstala la extensión

Error de API Key

• Verifica que la API key de Groq sea válida
• Comprueba la conexión a internet
• La extensión incluye una API key por defecto para pruebas

Chat no responde

• Verifica la configuración de red/firewall
• Revisa los logs en la consola de VS Code
• Intenta limpiar el historial y reiniciar

Autocompletado no funciona

• Asegúrate de usar los caracteres activadores (/, *, @)
• Verifica que el lenguaje esté soportado
• El comentario debe tener al menos 10 caracteres

Logs y Debugging

• Abre la consola de desarrollador: Help > Toggle Developer Tools
• Busca mensajes que comiencen con "🦂 Scorpk Agent"
• Reporta errores con el contexto completo

📝 Changelog

v1.0.0 (Inicial)

• ✨ Interfaz de chat integrada con diseño futurista
• 🧠 Modos Exploración y Planificación
• 🔧 Integración completa con Groq API y LLaMA 3
• 🌐 Proveedores avanzados (hover, completion, code actions)
• 📱 Contexto en tiempo real y seguimiento de actividad
• 🎯 Comandos completos para desarrollo asistido por IA

🤝 Contribuir

Reportar Bugs

1. Usa el sistema de issues de GitHub
2. Incluye pasos para reproducir el problema
3. Proporciona logs de la consola de desarrollador
4. Especifica versión de VS Code y sistema operativo

Solicitar Características

1. Describe la funcionalidad deseada
2. Explica el caso de uso
3. Proporciona ejemplos si es posible

Desarrollo

1. Fork del repositorio
2. Crea una rama para tu característica
3. Implementa los cambios con tests
4. Envía un pull request

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.

🙏 Agradecimientos

• Groq: Por proporcionar acceso a modelos de lenguaje avanzados
• LLaMA 3: El modelo de IA que potencia Scorpk Agent
• VS Code Team: Por la excelente API de extensiones
• Comunidad de desarrolladores: Por feedback y contribuciones

📞 Soporte

• Documentación: GitHub Wiki
• Issues: GitHub Issues
• Discusiones: GitHub Discussions

🦂 Scorpk Agent - Tu compañero inteligente para el desarrollo en VS Code

Desarrollado con ❤️ para la comunidad de desarrolladores