Sofka SDK Extension for Visual Studio Code

Descripción

Sofka SDK es una extensión para Visual Studio Code que permite analizar y mejorar tu código mediante SKAI con prompts especializados, generando sugerencias, documentación y pruebas unitarias. La extensión te permite seleccionar código en el editor y procesarlo a través de diferentes comandos, mostrando los resultados en una ventana fácil de leer.

Características principales

Análisis de código con Sonar Rules: Detecta problemas de calidad y buenas prácticas de programación basadas en reglas de SonarQube.
Revisión Par: Obtén comentarios como si un compañero experto revisara tu código, siguiendo principios SOLID y Clean Code.
Generación de OpenAPI: Añade anotaciones OpenAPI/Swagger a tu código para documentar APIs.
Generación de JavaDoc: Documenta automáticamente tus clases y métodos Java con anotaciones JavaDoc completas.
Creación de Pruebas Unitarias Java: Genera tests unitarios con JUnit y Mockito, incluyendo pruebas de mutación.
Creación de Pruebas Unitarias React: Genera tests unitarios con React Testing Library y Jest.
Explicación de Código: Obtén explicaciones técnicas y funcionales de tu código con sugerencias de mejora.
Visualización avanzada: Muestra los resultados en una ventana interactiva con resaltado de sintaxis.
Copiar e insertar resultados: Aplica las sugerencias directamente a tu código.

Instalación

Descarga el archivo .vsix de la extensión
Abre Visual Studio Code
Ve a la pestaña de Extensiones (Ctrl+Shift+X)
Haz clic en el ícono ... en la parte superior del panel
Selecciona “Instalar desde VSIX...”
Busca el archivo .vsix descargado y selecciónalo
Reinicia VS Code si es necesario

Autenticación

La extensión utiliza un flujo de autenticación integrado que permite a cada usuario acceder de forma segura y personalizada a las funcionalidades del SDK.

¿Cómo funciona?

Al ejecutar por primera vez cualquier comando de Sofka SDK, se abrirá automáticamente una página en tu navegador.
Inicia sesión con tu cuenta de Sofka Technologies.
Una vez autenticado, el sistema devolverá un los datos necesarios a la extensión, habilitando el acceso completo a todas las funciones.

🔐 Los datos es gestionado automáticamente por la extensión. No necesitas configurarlo manualmente ni introducir datos adicionales.

Uso

Comandos disponibles

Comando	Descripción	¿Requiere selección?
Sonar Rules	Analiza el código en busca de problemas que no cumplen con las reglas de SonarQube.	No
Revisión Par	Revisión experta del código con principios de Clean Code, SOLID y buenas prácticas del lenguaje.	No
OpenAPI	Genera y añade anotaciones OpenAPI/Swagger al código seleccionado.	Sí
JavaDoc	Genera documentación JavaDoc para clases y métodos.	Sí
Unit Test Java	Crea pruebas unitarias con JUnit y Mockito, incluyendo pruebas de mutación.	Sí
Unit Test React	Crea pruebas unitarias para componentes React con React Testing Library, Jest y mutaciones con Stryker.	Sí
Code Explanation	Proporciona explicaciones técnicas y funcionales del código, con sugerencias de mejora basadas en buenas prácticas.	Sí

Pasos para usar la extensión

Abre un archivo de código en el editor
Selecciona el código que deseas analizar (si aplica)
Haz clic derecho y selecciona el menú “Sofka SDK”
Elige uno de los comandos disponibles
Espera mientras se procesa tu solicitud
Revisa los resultados en la ventana lateral
Usa los botones disponibles para:
- Copiar: Copiar el resultado al portapapeles
- Insertar en editor: Reemplazar el código original con el resultado

Panel de resultados

Resaltado de sintaxis para código generado
Formato Markdown para una lectura clara
Botones de acción rápida (copiar, insertar)
Indicadores visuales de carga y seguridad

Solución de problemas

Problemas comunes

El menú Sofka SDK no aparece: Asegúrate de estar en un archivo compatible (Java, JavaScript, TypeScript, etc.).
Error de autenticación: Intenta cerrar sesión y volver a iniciar sesión desde el navegador.
Resultados vacíos: Verifica que el código seleccionado sea apropiado para el comando utilizado.

Ver logs

Abre la Paleta de Comandos (Ctrl+Shift+P)
Escribe y selecciona Developer: Open Developer Tools
Revisa la pestaña “Console” para ver mensajes y errores

Desarrollo

Si deseas contribuir al desarrollo de la extensión:

Clona este repositorio
Instala las dependencias con pnpm install
Haz tus cambios
Compila con pnpm run compile
Presiona F5 para ejecutar y probar la extensión en un entorno aislado

Créditos

Sofka Technologies
Versión: 2.0.3 — 2025-11-11

Licencia Propietaria Interna

📄 Versión en Español

Plugins IntelliJ y VS Code

1. TITULARIDAD

El software, incluyendo los plugins para IntelliJ IDEA y la extensión para Visual Studio Code (en conjunto, los "Plugins"), es propiedad de Sofka Technologies S.A.S. y/o sus afiliadas con operaciones en Colombia, Estados Unidos, México, Uruguay, Ecuador y Panamá ("Sofka"). Todos los derechos están reservados.

2. CONCESIÓN LIMITADA

Sofka otorga una licencia no exclusiva, intransferible y revocable para instalar y usar los Plugins únicamente con fines internos por empleados y contratistas autorizados de Sofka, en dispositivos y cuentas gestionados por Sofka. No se concede derecho de acceso público ni de distribución externa.

3. RESTRICCIONES

Sin autorización previa y por escrito de Sofka, queda prohibido:

(a) usar los Plugins fuera de la organización;
(b) copiar, distribuir, publicar, vender, alquilar, sublicenciar o poner los Plugins a disposición de terceros;
(c) modificar, adaptar, traducir, descompilar o realizar ingeniería inversa, salvo lo permitido por ley no renunciable;
(d) eliminar u ocultar avisos de copyright o marcas;
(e) usar los Plugins en cuentas personales, marketplaces públicos o dispositivos no gestionados por Sofka.

4. CONFIDENCIALIDAD

El código fuente, binarios, documentación, configuraciones y cualquier información técnica de los Plugins son Información Confidencial de Sofka y deberán protegerse con al menos un grado de diligencia razonable.

5. ACTUALIZACIONES Y TELEMETRÍA

Los Plugins pueden incluir mecanismos de actualización y, opcionalmente, telemetría de uso estrictamente interna y anonimizada. El uso está sujeto a las políticas internas de Sofka.

6. SOFTWARE DE TERCEROS

Los Plugins pueden incorporar componentes de terceros regidos por sus propias licencias. Dichos componentes no alteran el carácter propietario de los Plugins. Sofka mantendrá un archivo NOTICE enumerando dichas licencias cuando aplique.

7. SOPORTE

El soporte es interno y provisto "según disponibilidad" por los equipos designados de Sofka.

8. TERMINACIÓN

La licencia termina automáticamente ante incumplimiento o al finalizar la relación laboral/contractual. Tras la terminación, cesará todo uso y se eliminarán las copias en posesión del usuario.

9. GARANTÍAS Y RESPONSABILIDAD

Los Plugins se proporcionan "TAL CUAL", sin garantías de ningún tipo. En la medida permitida por la ley, Sofka no será responsable por daños indirectos, incidentales, especiales, punitivos o consecuenciales derivados del uso o imposibilidad de uso de los Plugins.

10. CUMPLIMIENTO Y JURISDICCIÓN

El uso de los Plugins está sujeto a las políticas internas de Sofka y a las leyes de Colombia. Cualquier disputa será resuelta ante los tribunales de Medellín, Colombia.

📄 English Version

IntelliJ and VS Code Plugins

1. OWNERSHIP

The software, including the IntelliJ IDEA plugins and the Visual Studio Code extension (collectively, the "Plugins"), is owned by Sofka Technologies S.A.S. and/or its affiliates operating in Colombia, the United States, Mexico, Uruguay, Ecuador, and Panama ("Sofka"). All rights reserved.

2. LIMITED LICENSE GRANT

Sofka grants a non-exclusive, non-transferable, revocable license to install and use the Plugins for internal purposes only by Sofka's authorized employees and contractors, on Sofka-managed devices and accounts. No public access or external distribution rights are granted.

3. RESTRICTIONS

Without Sofka's prior written authorization, you shall not:

(a) use the Plugins outside the organization;
(b) copy, distribute, publish, sell, rent, sublicense, or make the Plugins available to third parties;
(c) modify, adapt, translate, decompile, reverse engineer, or create derivative works, except as non-waivable by law;
(d) remove or obscure copyright or trademark notices;
(e) use the Plugins on personal accounts, public marketplaces, or non-managed devices.

4. CONFIDENTIALITY

The source code, binaries, documentation, configurations, and any technical information related to the Plugins are Sofka's Confidential Information and must be protected with at least reasonable care.

5. UPDATES AND TELEMETRY

The Plugins may include update mechanisms and optional anonymized telemetry for strictly internal use, subject to Sofka's internal policies.

6. THIRD-PARTY SOFTWARE

The Plugins may include third-party components governed by their respective licenses. Such components do not change the proprietary nature of the Plugins. Sofka will maintain a NOTICE file listing such licenses where applicable.

7. SUPPORT

Support is internal and provided "as available" by Sofka's designated teams.

8. TERMINATION

This license automatically terminates upon breach or upon the end of the employment/contractor relationship. Upon termination, all use must cease and all copies must be deleted.

9. WARRANTY DISCLAIMER AND LIMITATION OF LIABILITY

The Plugins are provided "AS IS" without warranties of any kind. To the extent permitted by law, Sofka shall not be liable for any indirect, incidental, special, punitive, or consequential damages arising from use or inability to use the Plugins.

10. COMPLIANCE AND JURISDICTION

Use of the Plugins is subject to Sofka's internal policies and Colombian law. Any dispute shall be resolved exclusively before the courts of Medellín, Colombia.