🔧 Configuración de Visual Studio Code para IA¶

Esta guía explica cómo configurar Visual Studio Code con los plugins de IA necesarios y cómo utilizar los archivos de instrucciones de este repositorio.

📦 Plugins Recomendados¶

GitHub Copilot (Esencial)¶

Nombre: GitHub Copilot
ID: GitHub.copilot
Descripción: Asistente de código con IA

Instalación: 1. Abrir VS Code 2. Ir a Extensions (Ctrl+Shift+X) 3. Buscar "GitHub Copilot" 4. Instalar y autenticar con tu cuenta de GitHub

GitHub Copilot Chat (Recomendado)¶

Nombre: GitHub Copilot Chat
ID: GitHub.copilot-chat
Descripción: Chat interactivo con Copilot

Funcionalidades: - Chat en panel lateral - Explicación de código - Generación de tests - Refactoring asistido

Cline (Claude AI) - Alternativa Avanzada¶

Nombre: Cline
ID: saoudrizwan.claude-dev
Descripción: Asistente de desarrollo con Claude AI

Características: - Edición de múltiples archivos - Ejecución de comandos - Navegación web - Análisis completo de proyectos

⚙️ Configuración de Copilot¶

1. Configuración Básica¶

Agregar en settings.json:

{
  "github.copilot.enable": {
    "*": true,
    "yaml": true,
    "plaintext": true,
    "markdown": true
  },
  "github.copilot.advanced": {
    "secret_key": "github-copilot",
    "length": 500,
    "temperature": 0.1,
    "top_p": 1,
    "stop": ["\n\n"]
  }
}

2. Configuración por Lenguaje¶

{
  "[java]": {
    "github.copilot.enable": true
  },
  "[dart]": {
    "github.copilot.enable": true
  },
  "[typescript]": {
    "github.copilot.enable": true
  },
  "[javascript]": {
    "github.copilot.enable": true
  }
}

📋 Cómo Usar los Archivos de Instrucciones¶

Método 1: Copilot Chat con Instrucciones¶

Abrir Copilot Chat (Ctrl+Shift+I)
Cargar instrucciones al inicio de la conversación:

Sigue estas instrucciones para generar código Java:

[Pegar contenido completo de code_generation_guides/java-maven.md]

Ahora ayúdame a crear una clase UserService con las siguientes características...

Método 2: Comentarios en el Código¶

Agregar las instrucciones como comentarios al inicio del archivo:

/*
INSTRUCCIONES PARA COPILOT:
- Usar convenciones de nomenclatura Java estándar
- Aplicar principios SOLID
- Incluir validaciones apropiadas
- Documentar con JavaDoc
- Seguir patrones de Spring Boot

[Incluir sección relevante del archivo de instrucciones]
*/

public class UserService {
    // Copilot generará código siguiendo las instrucciones
}

Método 3: Archivo .copilotrc.json (Experimental)¶

Crear en la raíz del proyecto:

{
  "instructions": {
    "java": "./code_generation_guides/java-maven.md",
    "dart": "./code_generation_guides/flutter.md",
    "typescript": "./code_generation_guides/nodejs-fastify.md"
  },
  "rules": [
    "Seguir convenciones del archivo de instrucciones",
    "Aplicar mejores prácticas de arquitectura",
    "Incluir manejo de errores apropiado"
  ]
}

🎯 Uso Específico por Tecnología¶

Para Proyectos Java¶

Abrir el proyecto Java en VS Code
Instalar extensiones Java:
Extension Pack for Java
Spring Boot Extension Pack

Cargar instrucciones:

@workspace Sigue las instrucciones de java-maven.md para generar código Java empresarial

Para Proyectos Flutter¶

Instalar extensiones Flutter:
Flutter
Dart

Configurar Copilot para Dart:

{
  "[dart]": {
    "github.copilot.enable": true,
    "editor.suggest.snippetsPreventQuickSuggestions": false
  }
}

Usar instrucciones Flutter:

Sigue las instrucciones de flutter.md y flutter_ai_rules.md para generar código Flutter con arquitectura limpia

Para Proyectos Node.js/TypeScript¶

Instalar extensiones:
TypeScript and JavaScript Language Features
ESLint
Prettier

Cargar instrucciones TypeScript:

Aplica las instrucciones de nodejs-fastify.md para generar código TypeScript con Fastify

🔄 Flujo de Trabajo Recomendado¶

1. Inicio de Sesión de Desarrollo¶

1. Abrir VS Code
2. Abrir Copilot Chat
3. Cargar instrucciones relevantes
4. Especificar el contexto del proyecto

2. Durante el Desarrollo¶

1. Escribir comentarios descriptivos
2. Usar Copilot para autocompletado
3. Validar con Copilot Chat para refactoring
4. Aplicar convenciones de commit

3. Revisión de Código¶

1. Usar Copilot Chat para explicar código complejo
2. Solicitar sugerencias de mejora
3. Verificar cumplimiento de estándares

🛠️ Comandos Útiles de Copilot¶

Atajos de Teclado¶

Tab - Aceptar sugerencia
Esc - Rechazar sugerencia
Alt+] - Siguiente sugerencia
Alt+[ - Sugerencia anterior
Ctrl+Shift+I - Abrir Copilot Chat

Comandos de Chat¶

/explain - Explicar código seleccionado
/fix - Corregir errores en el código
/tests - Generar tests para el código
/doc - Generar documentación
/optimize - Optimizar rendimiento

📝 Plantillas de Prompts¶

Para Nuevas Funcionalidades¶

Siguiendo las instrucciones de [archivo-relevante.md], crea una nueva funcionalidad que:
1. [Descripción específica]
2. [Requisitos técnicos]
3. [Patrones a seguir]

Incluye:
- Validaciones apropiadas
- Manejo de errores
- Tests unitarios
- Documentación

Para Refactoring¶

Basándote en las mejores prácticas de [archivo-relevante.md], refactoriza este código para:
1. Mejorar la legibilidad
2. Aplicar principios SOLID
3. Optimizar el rendimiento
4. Seguir convenciones establecidas

[Código a refactorizar]

🚨 Solución de Problemas¶

Copilot No Responde¶

Verificar autenticación: Ctrl+Shift+P → "GitHub Copilot: Sign In"
Reiniciar VS Code
Verificar conexión a internet

Sugerencias de Baja Calidad¶

Proporcionar más contexto en comentarios
Usar nombres descriptivos para variables/funciones
Incluir las instrucciones específicas del proyecto

Configuración No Funciona¶

Verificar sintaxis del settings.json
Reiniciar VS Code después de cambios
Comprobar que las extensiones estén actualizadas

📚 Recursos Adicionales¶

💡 Consejo: Mantén las instrucciones específicas del proyecto siempre a mano y úsalas consistentemente para obtener mejores resultados de la IA.