🦂 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
- Descarga el archivo
.vsix
de la extensión
- Abre VS Code
- Ve a la vista de Extensiones (Ctrl+Shift+X)
- Haz clic en "..." y selecciona "Install from VSIX..."
- Selecciona el archivo descargado
Configuración Inicial
- Abre la configuración de VS Code (Ctrl+,)
- Busca "Scorpk Agent"
- (Opcional) Configura tu propia API key de Groq para mejor rendimiento
- 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
Comando |
Atajo |
Descripción |
Abrir Chat |
Ctrl+Shift+S |
Abre el panel de chat de Scorpk Agent |
Explicar Código |
Ctrl+Shift+E |
Explica el código seleccionado |
Limpiar Historial |
- |
Limpia el historial de conversaciones |
Cambiar Modo |
- |
Alterna entre modo Exploración y Planificación |
Generar Código |
- |
Genera código basado en descripción |
Refactorizar Código |
- |
Mejora el código seleccionado |
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
- Escribe un comentario describiendo lo que necesitas
- Usa
/
, *
o @
para activar sugerencias
- Selecciona la sugerencia de Scorpk Agent
- 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 |
Tipo |
Por Defecto |
Descripción |
scorpk.groqApiKey |
string |
"" |
Tu clave API de Groq personalizada |
scorpk.model |
string |
"llama3-70b-8192" |
Modelo de Groq a utilizar |
scorpk.temperature |
number |
0.7 |
Creatividad de las respuestas (0-2) |
scorpk.maxTokens |
number |
4096 |
Máximo de tokens en respuestas |
scorpk.autoSave |
boolean |
true |
Guardar historial automáticamente |
scorpk.contextAware |
boolean |
true |
Incluir contexto del archivo actual |
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
- Usa el sistema de issues de GitHub
- Incluye pasos para reproducir el problema
- Proporciona logs de la consola de desarrollador
- Especifica versión de VS Code y sistema operativo
Solicitar Características
- Describe la funcionalidad deseada
- Explica el caso de uso
- Proporciona ejemplos si es posible
Desarrollo
- Fork del repositorio
- Crea una rama para tu característica
- Implementa los cambios con tests
- 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
🦂 Scorpk Agent - Tu compañero inteligente para el desarrollo en VS Code
Desarrollado con ❤️ para la comunidad de desarrolladores