Skip to content

github-copilot.md

Latest commit

 

History

History
480 lines (337 loc) · 10.9 KB

github-copilot.md

File metadata and controls

480 lines (337 loc) · 10.9 KB
Raw

Guía de AIOX para GitHub Copilot

🌐 EN | PT | ES

El Asistente de Programación Emparejada de GitHub - Integración Nativa con GitHub

Descripción General

¿Qué es GitHub Copilot?

GitHub Copilot es el asistente de programación impulsado por IA de GitHub que se integra directamente con VS Code y otros editores. Ofrece finalizaciones de código, asistencia de chat e integración profunda con GitHub para solicitudes de extracción y revisiones de código.

¿Por qué usar AIOX con GitHub Copilot?

GitHub Copilot proporciona ventajas únicas:

  • Integración con GitHub: Soporte nativo para PR e issues
  • Ubicuo: Disponible en la mayoría de editores
  • Modos de Chat: Comportamiento similar a agentes a través de modos de chat
  • Revisión de Código: Revisiones de PR asistidas por IA
  • @workspace: Contexto del proyecto completo

Comparación con Otras Plataformas

Característica GitHub Copilot Cursor Claude Code
GitHub Nativo Sí No No
Modos de Agentes 4 Integrados @mention /command
Soporte MCP Sí Configuración Nativo
Integración con PR Sí Limitada gh CLI
Finalización de Código Sí Sí No

Requisitos

Requisitos del Sistema

Requisito Mínimo Recomendado
VS Code 1.101+ Última versión
RAM 4GB 8GB+
Node.js 18.0+ (para AIOX) 20.0+

Requisitos de Cuenta

  • Suscripción a GitHub Copilot (Individual, Business o Enterprise)
  • Cuenta de GitHub

Configuración de VS Code

Habilitar el modo agente en VS Code:

{
  "chat.agent.enabled": true
}

Instalación

Paso 1: Instalar la Extensión GitHub Copilot

  1. Abre VS Code
  2. Ve a Extensiones (Cmd/Ctrl + Shift + X)
  3. Busca "GitHub Copilot"
  4. Instala ambas:
    • GitHub Copilot
    • GitHub Copilot Chat

Paso 2: Iniciar Sesión

  1. Haz clic en "Iniciar sesión en GitHub" cuando se le solicite
  2. Autoriza VS Code
  3. Verifica que la suscripción esté activa

Paso 3: Instalar AIOX

cd your-project
npx @anthropic/aiox init
# Selecciona "GitHub Copilot" cuando se le solicite

Paso 4: Verificar la Instalación

ls -la .github/

Estructura esperada:

.github/
├── copilot-instructions.md    # Instrucciones principales
├── chatmodes/                  # Modos de chat del agente
│   ├── aiox-dev.chatmode.md
│   ├── aiox-qa.chatmode.md
│   └── ...
└── agents/                     # Definiciones de agentes

Configuración

Instrucciones de Copilot

Ubicación: .github/copilot-instructions.md

Este archivo proporciona contexto global a Copilot:

# Instrucciones del Proyecto para GitHub Copilot

## Descripción General del Proyecto
Este proyecto utiliza Synkra AIOX para desarrollo orquestado por IA.

## Estándares de Codificación
- TypeScript con modo estricto
- Sigue los patrones existentes
- Incluye manejo de errores
- Escribe pruebas unitarias

## Sistema de Agentes
Utiliza modos de chat para asistencia especializada.

Modos de Chat

Ubicación: .github/chatmodes/

Cada agente tiene un modo de chat dedicado:

<!-- aiox-dev.chatmode.md -->
---
name: AIOX Developer
description: Agente Senior Full Stack Developer
---

# Agente de Desarrollador

Eres un Senior Full Stack Developer trabajando con Synkra AIOX.

## Experiencia
- TypeScript/JavaScript
- Node.js, React
- Diseño de bases de datos

## Flujo de Trabajo
1. Lee los requisitos de la historia
2. Planifica la implementación
3. Escribe código limpio y probado

Uso Básico

Abriendo Copilot Chat

Atajos de Teclado:

  • Windows/Linux: Ctrl + Alt + I
  • macOS: ⌃⌘I

O: View > Chat

Modos Integrados de Copilot

VS Code proporciona cuatro modos integrados:

Modo Propósito
Agent Codificación autónoma - edita archivos, ejecuta comandos, itera en errores
Plan Crea planes de implementación detallados antes de codificar
Ask Responde preguntas sin hacer cambios
Edit Control granular sobre las ediciones propuestas

Activando Modos de Agentes AIOX

  1. Abre la vista de Chat
  2. Haz clic en el selector de modo (parte superior del chat)
  3. Selecciona el modo deseado (Agent, Plan, Ask, Edit)
  4. Para agentes AIOX, usa modos de chat personalizados en .github/chatmodes/

Modos Personalizados AIOX

Modo Propósito
aiox-dev Desarrollo full-stack
aiox-qa Aseguramiento de calidad
aiox-architect Diseño de sistemas
aiox-pm Gestión de proyectos

Interacciones de Ejemplo

# En modo aiox-dev:
Implementa la función de autenticación de usuario de la historia

# En modo aiox-qa:
Revisa el módulo de auth para vulnerabilidades de seguridad

# En modo aiox-architect:
Diseña la arquitectura de microservicios

Usando @workspace

Referencia tu proyecto completo:

@workspace ¿Cómo se implementa el manejo de errores?

@workspace Explica el flujo de autenticación

Finalizaciones en Línea

GitHub Copilot proporciona sugerencias en línea:

  1. Comienza a escribir código
  2. Espera la sugerencia gris
  3. Presiona Tab para aceptar
  4. Presiona Escape para descartar

Uso Avanzado

Integración con PR

Usa Copilot para solicitudes de extracción:

# En descripción de PR
@copilot resume los cambios en este PR

# En revisión de PR
@copilot explica este cambio de código

Revisión de Código

Solicita revisiones asistidas por IA:

@copilot revisa este archivo para:
- Problemas de seguridad
- Problemas de rendimiento
- Mejores prácticas

Contexto de Múltiples Archivos

Referencia archivos específicos:

@file:src/auth/login.ts Explica este flujo de autenticación

Usando patrones de @file:src/services/userService.ts,
crea un productService

Integración de Terminal

@terminal ¿Cómo ejecuto las pruebas?

@terminal Genera un comando de git para hacer squash de commits

Características Específicas de GitHub Copilot

Atajos de Teclado

Atajo Acción
Tab Aceptar sugerencia
Escape Descartar sugerencia
Alt + ] Siguiente sugerencia
Alt + [ Sugerencia anterior
Ctrl + Alt + I Abrir Chat

Referencias de Contexto

Referencia Descripción
@workspace Proyecto completo
@file Archivo específico
@terminal Contexto de terminal
@vscode Configuración de VS Code

Participantes de Chat

Participante Propósito
@workspace Consultas a nivel de proyecto
@terminal Asistencia de comandos
@vscode Configuración del editor

Sincronización de Agentes

Cómo Funciona

flowchart LR
    Source["AIOX Core<br/>.aiox-core/development/agents"] --> Parser["Agent Parser"]
    Parser --> Transform["Copilot Transformer"]
    Transform --> Modes[".github/chatmodes/"]
    Transform --> Instructions[".github/copilot-instructions.md"]
Loading

Comandos de Sincronización

# Sincronizar todos los agentes
npm run sync:ide

# Sincronizar para GitHub Copilot
npm run sync:ide -- --ide github-copilot

Formato del Modo de Chat

---
name: AIOX Developer
description: Asistencia en desarrollo full-stack
---

# Agente de Desarrollador

## Rol
Eres un Senior Full Stack Developer.

## Capacidades
- Desarrollo TypeScript/JavaScript
- Diseño e implementación de API
- Diseño de esquema de base de datos
- Pruebas unitarias e integración

## Directrices
1. Sigue los estándares de codificación del proyecto
2. Escribe manejo de errores integral
3. Incluye pruebas para nueva funcionalidad
4. Actualiza la documentación según sea necesario

Limitaciones Conocidas

Limitaciones Actuales

Limitación Solución Alternativa
Ventana de contexto limitada Usar @workspace selectivamente
Sin generación de subagentes Usar agentes de fondo (VS Code 1.107+)
Selección de modelo limitada Usa la selección de modelo de GitHub

Adiciones Recientes (2025)

  • Soporte MCP: Extiende el chat con capacidades personalizadas a través del Protocolo de Contexto de Modelo
  • Orquestación Multi-Agente: Agent HQ para gestionar múltiples agentes (VS Code 1.107+)
  • Agentes de Fondo: Ejecuta agentes en espacios de trabajo aislados
  • Subagentes: Delega tareas dentro de sesiones de chat

Copilot vs Claude Code

Aspecto Copilot Claude Code
Herramienta de Tareas No Sí
MCP No Nativo
GitHub Nativo Sí gh CLI
Finalización en Línea Sí No

Solución de Problemas

Problemas Comunes

Los Modos de Chat No Aparecen

Problema: Los modos de agentes AIOX no aparecen en el selector

Solución:

  1. Asegúrate de tener VS Code 1.101+
  2. Habilita chat.agent.enabled: true
  3. Recarga VS Code
  4. Verifica los archivos en .github/chatmodes/

Copilot No Sugiere

Problema: Sin finalizaciones en línea

Solución:

  1. Verifica el estado de la suscripción
  2. Verifica la conexión a internet
  3. Verifica que el tipo de archivo sea compatible
  4. Reinicia VS Code

Las Instrucciones No Se Aplican

Problema: Copilot ignora las reglas del proyecto

Solución:

  1. Verifica que .github/copilot-instructions.md exista
  2. Revisa la sintaxis del archivo
  3. Recarga VS Code

Registros

# Salida de VS Code
View > Output > GitHub Copilot

# Herramientas de Desarrollador
Help > Toggle Developer Tools > Console

Preguntas Frecuentes

P: ¿Cuánto cuesta GitHub Copilot? R: Individual: $10/mes, Business: $19/usuario/mes, Enterprise: precios personalizados.

P: ¿Puedo usar otros modelos? R: No, Copilot utiliza exclusivamente modelos de OpenAI.

P: ¿Funciona sin conexión a internet? R: No, requiere conexión a internet.

P: ¿Cómo difieren los modos de chat de las @menciones? R: Los modos de chat son contextos persistentes, mientras que las @menciones son referencias por mensaje.

Migración

De Cursor a Copilot

  1. Instala AIOX para Copilot:

    npx @anthropic/aiox init --ide github-copilot

  2. Los agentes se transforman en modos de chat

De Copilot a Claude Code

  1. Los agentes almacenados en .aiox-core/ son portables
  2. Inicializa para Claude Code: 
    npx @anthropic/aiox init --ide claude-code

Recursos Adicionales

Synkra AIOX - Guía de Plataforma GitHub Copilot v1.0