Personalización de respuestas de Copilot Chat de GitHub

6 minutos

GitHub Copilot Chat puede generar respuestas y código que coincidan con las prácticas de codificación y los requisitos del proyecto cuando se le asigna el contexto adecuado. En lugar de agregar repetidamente esta información en cada mensaje de chat, puede almacenar este contexto en archivos e incluirla automáticamente en cada solicitud de chat.

Hay tres maneras principales de personalizar las respuestas de inteligencia artificial en Visual Studio Code:

Instrucciones personalizadas: defina directrices comunes para tareas como generar código, realizar revisiones de código o generar mensajes de confirmación. Estos describen cómo se deben realizar las tareas y pueden especificar prácticas de codificación, tecnologías preferidas, reglas de seguridad o formatos de mensaje de confirmación.
Archivos de indicaciones: Defina indicaciones reutilizables para tareas comunes. Estos avisos independientes describen lo que se debe hacer y pueden incluir componentes de estructuración, realizar revisiones de código, crear guías paso a paso o generar planes de implementación.
Modos de chat personalizados: defina cómo funciona el chat, qué herramientas puede usar y cómo interactúa con el código base. Entre los ejemplos se incluyen los modos de planeación con acceso de solo lectura, modos de investigación que acceden a recursos externos o modos específicos de roles, como el desarrollo front-end.

Instrucciones personalizadas

Las configuraciones personalizadas le permiten describir las directrices que generan respuestas que coinciden con sus prácticas de codificación específicas y su stack tecnológico. En lugar de incluir manualmente este contexto en cada consulta de chat, las instrucciones personalizadas incorporan automáticamente esta información con cada solicitud de chat.

Note

Las instrucciones personalizadas no se tienen en cuenta para las finalizaciones de código.

Tipos de instrucciones personalizadas

Visual Studio Code admite tres maneras de definir instrucciones personalizadas:

Type	Description	Casos de uso
`.github/copilot-instructions.md`	Archivo Markdown único en el área de trabajo, incluido automáticamente en todas las solicitudes, compatibilidad entre editores.	Procedimientos generales de codificación, tecnologías preferidas, requisitos para todo el proyecto.
`.instructions.md files`	Varios archivos Markdown con compatibilidad con patrones globales, área de trabajo o almacenamiento de perfiles de usuario.	Instrucciones específicas de la tarea, control pormenorizado sobre cuándo se aplican las instrucciones.
configuración de Visual Studio Code	Instrucciones de configuración de usuario o área de trabajo para escenarios específicos.	Generación de código, generación de pruebas, confirmación de mensajes, revisiones de código, descripciones de PR.

Puede combinar estos enfoques, pero evitar instrucciones en conflicto, ya que no se aplica ningún orden de prioridad.

Ejemplos de instrucciones personalizadas

Directrices generales de codificación:

---
applyTo: "**"
---
# Project coding standards

## Naming Conventions
- Use PascalCase for component names, interfaces, and type aliases.
- Use camelCase for variables, functions, and methods.
- Prefix private class members with underscore (_).
- Use ALL_CAPS for constants.

## Error Handling
- Use try/catch blocks for async operations.
- Implement proper error boundaries in React components.
- Always log errors with contextual information.

Instrucciones de TypeScript y React:

---
applyTo: "**/*.ts,**/*.tsx"
---
# TypeScript and React standards

Apply the [general coding guidelines](./general-coding.instructions.md) to all code.

## TypeScript Guidelines
- Use TypeScript for all new code.
- Follow functional programming principles where possible.
- Use interfaces for data structures and type definitions.
- Prefer immutable data (const, readonly).
- Use optional chaining (?.) and nullish coalescing (??) operators.

## React Guidelines
- Use functional components with hooks.
- Follow the React hooks rules (no conditional hooks).
- Use React.FC type for components with children.
- Keep components small and focused.
- Use CSS modules for component styling.

Use el archivo .github/copilot-instructions.md

Almacene instrucciones personalizadas en un .github/copilot-instructions.md archivo en la raíz del área de trabajo para describir los procedimientos de codificación, las tecnologías preferidas y los requisitos del proyecto. Estas instrucciones solo se aplican al área de trabajo y se incluyen automáticamente en cada solicitud de chat.

Pasos de configuración:

Compruebe que github.copilot.chat.codeGeneration.useInstructionFiles está habilitado (de forma predeterminada en versiones recientes de Visual Studio Code).
Cree .github/copilot-instructions.md en la raíz del área de trabajo.
Describir instrucciones con lenguaje natural y formato Markdown.

Note

Este archivo funciona en Visual Studio Code, Visual Studio y GitHub.com.

Usar archivos .instructions.md

Cree varios .instructions.md archivos para tareas específicas, lenguajes de programación, marcos de trabajo o tipos de proyecto. Estos se pueden aplicar automáticamente en función de los patrones de archivo o adjuntarlos manualmente a mensajes de chat.

Ubicaciones de archivo:

Archivos del área de trabajo: se almacenan en .github/instructions la carpeta y solo están disponibles en el área de trabajo.
Archivos de usuario: almacenados en el perfil de Visual Studio Code, disponibles en varias áreas de trabajo y sincronizada a través de la sincronización de configuración.

Estructura de archivos:

---
description: "Brief description of the instructions file"
applyTo: "**/*.ts,**/*.tsx"  # Glob pattern for automatic application
---
# Instructions content in Markdown format

Cree y use archivos de instrucciones:

Ejecute Chat: New Instructions File desde la paleta de comandos.
Elija el área de trabajo o la ubicación del usuario.
Escriba las instrucciones de nombre y autor en Markdown.
Use Chat: Configure Instructions para editar los archivos existentes.

Adjunto manual

En la vista Chat: Agregar instrucciones de contexto >
Paleta de comandos: Chat: Attach Instructions

Aplicación automática: use applyTo metadatos con patrones globales (** para todas las solicitudes, patrones específicos para la aplicación de destino)

Especificación de instrucciones personalizadas en la configuración

Configura instrucciones personalizadas en las opciones de Visual Studio Code para escenarios específicos.

Scenario	Setting
Generación de código	`github.copilot.chat.codeGeneration.instructions`
Generación de pruebas	`github.copilot.chat.testGeneration.instructions`
Revisión de código	`github.copilot.chat.reviewSelection.instructions`
Mensajes de confirmación	`github.copilot.chat.commitMessageGeneration.instructions`
Títulos y descripciones de PR	`github.copilot.chat.pullRequestDescriptionGeneration.instructions`

Defina las instrucciones como texto o haga referencia a archivos externos.

"github.copilot.chat.codeGeneration.instructions": [
  {
    "text": "Always add a comment: 'Generated by Copilot'."
  },
  {
    "text": "In TypeScript always use underscore for private field names."
  },
  {
    "file": "general.instructions.md"
  },
  {
    "file": "db.instructions.md"
  }
]

Procedimientos recomendados para obtener instrucciones personalizadas

Mantener las instrucciones concisas: cada instrucción debe ser una única instrucción simple.
Evitar referencias externas: no haga referencia a estándares o recursos de codificación externos.
Organizar por tema: divida las instrucciones en varios archivos para mejorar la organización.
Habilitar el uso compartido de equipos: almacene instrucciones en archivos controlados por versiones para la colaboración en equipo.
Usar la aplicación específica: aprovechar applyTo la propiedad para obtener instrucciones específicas del archivo.
Referencia eficaz: haga referencia a las instrucciones personalizadas de los archivos de solicitud para evitar la duplicación.

Archivos de mensajes

Los archivos de indicación son mensajes de tareas independientes y reutilizables almacenados como archivos .prompt.md. A diferencia de las instrucciones personalizadas (que describen cómo deben responder GitHub Copilot), los archivos de instrucciones describen qué debe realizarse para una tarea específica. Los ejecuta sobre demanda en lugar de aplicarlos automáticamente a cada solicitud.

Los archivos de indicación son adecuados para flujos de trabajo periódicos de codificación del entorno: estructurar un nuevo componente, generar un primer borrador de un documento de requisitos de producto, realizar una revisión de código o iniciar una sesión con el contexto del proyecto ya cargado.

Crear un archivo de indicación

Almacene los archivos de solicitud en la .github/prompts/ carpeta del área de trabajo. El nombre del archivo se convierte en el nombre del aviso.

Estructura de archivos:

---
mode: "ask"
description: "Generate a product requirements document for a new feature"
---
# Generate a PRD

Create a product requirements document for the described feature.

Include the following sections:
- Product summary
- Target audience
- Core features (prioritized by must-have / should-have / could-have)
- Out of scope
- Technical requirements

Feature description: ${input:Feature description}

Ejecución de un archivo de instrucción

Paleta de comandos: ejecute Chat: Run Prompt y seleccione el archivo.
Entrada de chat: escriba # en la vista Chat y seleccione el archivo de solicitud por nombre.

Los archivos de indicación admiten mode valores de ask, edit y agent. También pueden hacer referencia a los archivos de instrucciones personalizados mediante la sintaxis de vínculo de Markdown para evitar duplicar el contenido entre archivos.

Modos de chat personalizados

Los modos de chat personalizados le permiten configurar cómo funciona el panel de Copilot Chat de GitHub para un flujo de trabajo específico. Define qué herramientas están disponibles, cómo interactúa la inteligencia artificial con el código base y qué rol debe desempeñar, sin modificar las instrucciones personalizadas.

Para codificar el ambiente, esto es especialmente útil para separar la fase de planificación de la fase de construcción . Un modo de planeación puede restringir GitHub Copilot al análisis de solo lectura, por lo que propone diseños sin realizar cambios, mientras que un modo de implementación desbloquea herramientas de edición completas.

Crear un modo de chat personalizado

Almacene los archivos del modo de chat personalizados en la .github/chatmodes/ carpeta del área de trabajo.

Estructura de archivos:

---
description: "Plan mode: read-only analysis and architecture decisions"
tools: []
---
You are a software architect in planning mode. Analyze the codebase, identify patterns, suggest designs, and answer questions — but do not make any code changes.

Configuraciones comunes del modo de chat para "vibe coding":

Modo	Herramientas	Caso de uso
Planificación	Ninguno (solo lectura)	Decisiones de arquitectura, diseño de características, revisión de PRD
Investigación	Búsqueda web	Investigación de bibliotecas, comparación de enfoques
Implementation	Acceso completo a herramientas	Escribir y editar código, ejecutar comandos
Reseña	Solo lectura	Revisión de código, auditoría de seguridad, comprobación de rendimiento

Usar un modo de chat personalizado

Seleccione un modo desde el selector de modo de chat en la barra de herramientas de la vista de Chat. El modo persiste para la sesión hasta que cambie.

Summary

Personalizar las respuestas de GitHub Copilot le permite dar forma a la ayuda de inteligencia artificial para que se adapte a su flujo de trabajo específico. Instrucciones personalizadas — usando archivos .github/copilot-instructions.md, archivos .instructions.md, o configuración de Visual Studio Code — definen cómo debe responder GitHub Copilot, codificando tus prácticas de codificación, estándares y preferencias. Los archivos de indicación definen lo que se debe hacer para las tareas periódicas, proporcionando indicaciones reutilizables que puede ejecutar a petición. Los modos de chat personalizados configuran cómo funciona la sesión de chat, lo que le permite cambiar entre los flujos de trabajo de planeación, investigación, implementación y revisión sin cambiar las instrucciones subyacentes. En conjunto, estas tres herramientas le ayudan a crear un entorno de programación coherente donde GitHub Copilot entiende su proyecto desde el principio.

Comentarios

¿Le ha resultado útil esta página?