Las primeras instrucciones personalizadas

Acerca de las personalizaciones

Puedes personalizar las respuestas de GitHub Copilot mediante dos tipos de archivos:

•           Las **Instrucciones personalizadas** proporcionan instrucciones continuas sobre cómo debe comportarse GitHub Copilot en todas las interacciones.
  

•           Los **archivos de mensaje (versión preliminar pública)** definen mensajes reutilizables para tareas específicas que puede invocar cuando sea necesario. Los archivos de comandos solo están disponibles en VS Code, Visual Studio y en IDEs de JetBrains. Para obtener un ejemplo introductorio, consulte [AUTOTITLE](/copilot/tutorials/customization-library/prompt-files/your-first-prompt-file).
  

Aunque las instrucciones personalizadas ayudan a agregar contexto a cada flujo de trabajo de IA, los archivos de mensaje te permiten agregar instrucciones a una interacción de chat específica.

Las instrucciones personalizadas de repositorio son las más usadas y admitidas, pero también puedes definir instrucciones personalizadas personales y de la organización, solo para GitHub Copilot Chat en GitHub. Puedes crear instrucciones personalizadas del repositorio de dos maneras:

•         **Instrucciones para todo el repositorio**: crea un único archivo`copilot-instructions.md` en la raíz del repositorio que se aplique a todos los archivos del repositorio.
  

•         **Instrucciones específicas de la ruta de acceso**: crea uno o varios archivos `.instructions.md` con un campo `applyTo` que solo se apliquen a archivos o directorios específicos. Actualmente se admiten instrucciones específicas de trayecto para **chat de Copilot** en Visual Studio Code, Visual Studio, y **GitHub Copilot agente de codificación**.
  

Las primeras instrucciones

Comienza con estas instrucciones personalizadas básicas que ayudan a GitHub Copilot a comprender tus preferencias de programación.

Instrucciones para escribir funciones

When writing functions, always:
- Add descriptive JSDoc comments
- Include input validation
- Use early returns for error conditions
- Add meaningful variable names
- Include at least one example usage in comments

When writing functions, always:
- Add descriptive JSDoc comments
- Include input validation
- Use early returns for error conditions
- Add meaningful variable names
- Include at least one example usage in comments

Estas instrucciones cambiarán la forma en que GitHub Copilot genera funciones.

Prueba

Para probar rápidamente la diferencia que pueden hacer las instrucciones personalizadas, puede usar instrucciones personalizadas personales en chat de Copilot.

1. En primer lugar, vaya a github.com/copilot y escriba este mensaje:

   Create a JavaScript function that calculates the area of a circle

          **Sin instrucciones personalizadas**, podría obtener lo siguiente:
   

   function areaOfCircle(radius) {
       if (typeof radius !== 'number' || radius < 0) {
           throw new Error('Radius must be a non-negative number');
       }
       return Math.PI * radius * radius;
   }
   

2. Ahora accede a tus instrucciones personalizadas haciendo clic en tu imagen de perfil en la esquina inferior izquierda de la página, luego haz clic en Instrucciones personales. Pega las instrucciones anteriores en el cuadro de texto y, después, haz clic en Save.

   Ahora, escribe el mismo mensaje anterior.

          **Con instrucciones personalizadas**, obtendrá algo parecido a lo siguiente:
   

   /**
    * Calculates the area of a circle given its radius.
    *
    * @param {number} radius - The radius of the circle. Must be a positive number.
    * @returns {number|null} The area of the circle, or null if the input is invalid.
    *
    * @example
    * // returns 78.53981633974483
    * areaOfCircle(5);
    *
    * @example
    * // returns null (invalid input)
    * areaOfCircle(-2);
    */
   function areaOfCircle(radius) {
     if (typeof radius !== "number" || isNaN(radius) || radius <= 0) {
       // Invalid input: radius must be a positive number
       return null;
     }
   
     const area = Math.PI * Math.pow(radius, 2);
     return area;
   }
   
   // Example usage:
   console.log(areaOfCircle(5));   // 78.53981633974483
   console.log(areaOfCircle(-2));  // null
   

Información adicional

•         [AUTOTITLE](/copilot/concepts/response-customization): Introducción a la personalización de respuestas en GitHub Copilot
  

•         [AUTOTITLE](/copilot/how-tos/configure-custom-instructions): Configuración de instrucciones personalizadas
  

•         [Awesome GitHub Copilot Customizations](https://github.com/github/awesome-copilot/blob/main/README.md): repositorio de instrucciones personalizadas aportadas por la comunidad y otras personalizaciones para lenguajes y escenarios específicos