Nota:
Esta versión de este artículo trata sobre las instrucciones personalizadas en el sitio web de GitHub. Haz clic en las pestañas anteriores para otros entornos.
Acerca de la personalización de las respuestas de Copilot
GitHub Copilot puede proporcionar respuestas adaptadas a sus preferencias personales, la forma en que trabaja el equipo, las herramientas que usa o los detalles del proyecto, si proporciona suficiente contexto para hacerlo. En lugar de agregar repetidamente este detalle contextual a las indicaciones, puede crear instrucciones personalizadas que agreguen automáticamente esta información. La información adicional no se muestra, pero está disponible para Copilot para permitir que genere respuestas de mayor calidad.
Nota:
Debido a la naturaleza no determinista de la inteligencia artificial, Copilot puede que no siempre siga las instrucciones personalizadas de la misma manera cada vez que se usan.
Tipos de instrucciones personalizadas
Hay tres tipos principales de instrucciones personalizadas que puede usar para personalizar las respuestas de Copilot, en el sitio web de GitHub:
-
** [Las instrucciones personales](#about-personal-instructions)** se aplican a todas las conversaciones que realice con Chat de Copiloto en el sitio web de GitHub. Permiten especificar tus preferencias individuales, como el idioma preferido o el estilo de respuesta, lo que garantiza que las respuestas se adapten a tus necesidades personales. -
** [Las instrucciones personalizadas del repositorio](#about-repository-custom-instructions)** se aplican a las conversaciones dentro del contexto de un repositorio específico. Son útiles para definir estándares de codificación, marcos o herramientas específicos del proyecto. Por ejemplo, puedes especificar que un repositorio usa TypeScript y una biblioteca determinada, lo que garantiza respuestas coherentes para todos los colaboradores. -
** [Las instrucciones personalizadas](#about-organization-custom-instructions)** de la organización (versión preliminar pública) se aplican a las conversaciones dentro del contexto de una organización en el sitio web GitHub . Son ideales para aplicar preferencias de toda la organización, como un lenguaje común o directrices de seguridad. Las instrucciones personalizadas de la organización solo las pueden establecer los propietarios de la organización para las organizaciones con una suscripción de Copilot Empresarial.
Acerca de las instrucciones personales
Nota:
Las instrucciones personalizadas personales solo se admiten para Chat de GitHub Copilot en GitHub.
Puede personalizar cómo Chat de Copiloto le responde en GitHub.com agregando instrucciones personales, que Copilot se aplicarán solo a usted. Esto se hace en una ventana emergente en la página Chat de Copiloto en GitHub.com. Consulta Incorporación de instrucciones personalizadas individuales para GitHub Copilot.
Acerca de las instrucciones personalizadas del repositorio
Puede usar tres tipos de instrucciones personalizadas del repositorio en Copilot en GitHub.com:
-
**Instrucciones personalizadas para todo el repositorio**, que se aplican a todas las solicitudes realizadas en el contexto de un repositorio.Se especifican en un archivo
copilot-instructions.mden el directorio.githubdel repositorio. -
**Instrucciones personalizadas específicas de la ruta de acceso**, que se aplican a las solicitudes realizadas en el contexto de los archivos que coinciden con una ruta de acceso especificada.Se especifican en uno o varios
NAME.instructions.mdarchivos dentro o debajo del.github/instructionsdirectorio del repositorio.Al usar instrucciones específicas de la ruta de acceso, puedes evitar sobrecargar las instrucciones de todo el repositorio con información que solo se aplica a archivos de determinados tipos o en determinados directorios.
-
**Instrucciones del agente**, que son similares a las instrucciones personalizadas de todo el repositorio, pero que actualmente no son compatibles con todas las características de Copilot.Se especifican en archivos denominados
AGENTS.md,CLAUDE.mdoGEMINI.md.
Para obtener detalles sobre la compatibilidad de cada uno de estos tipos de e instrucciones personalizadas del repositorio a través de diferentes características de Copilot, consulte Compatibilidad con diferentes tipos de instrucciones personalizadas.
Para obtener una colección seleccionada de ejemplos, consulte Instrucciones personalizadas.
Acerca de las instrucciones personalizadas de la organización
Nota:
Esta característica se encuentra actualmente en versión preliminar pública y está sujeta a cambios.
**Soporte:** Actualmente, las instrucciones personalizadas de la organización solo se admiten para Chat de Copiloto en GitHub.com, Revisión del código de Copilot en GitHub.com y Agente de codificación de Copilot en GitHub.com.
Los propietarios de la organización pueden agregar instrucciones para Copilot, para adaptar las respuestas a las necesidades y preferencias de tu organización. Por ejemplo, puede elegir que Copilot siempre responda en el idioma preferido por su empresa o con un estilo particular.
Las instrucciones personalizadas definidas en la configuración de Copilot de una organización se usan para todos los miembros de la organización, independientemente de si reciben su suscripción de Copilot de esa organización.
Algunos ejemplos de instrucciones que puedes agregar son los siguientes:
Always respond in Spanish.Do not generate code blocks in responses.For questions related to security, use the Security Docs Knowledge Base.
Prioridad de las instrucciones personalizadas
Se pueden aplicar varios tipos de instrucciones personalizadas a una solicitud enviada a Copilot. Las instrucciones personales tienen la máxima prioridad. Las instrucciones del repositorio vienen a continuación y, a continuación, las instrucciones de la organización se priorizan en último lugar. Sin embargo, se proporcionan todos los conjuntos de instrucciones pertinentes a Copilot.
En la lista siguiente se muestra el orden completo de prioridad, con instrucciones superiores en esta lista que tienen prioridad sobre las inferiores de la lista:
-
**Instrucciones personales** -
* Instrucciones específicas de ruta en cualquier archivo aplicable**Instrucciones personalizadas del repositorio** :.github/instructions/**/*.instructions.md* Instrucciones para todo el repositorio en el.github/copilot-instructions.mdarchivo * Instrucciones del agente (por ejemplo, en unAGENTS.mdarchivo) - Instrucciones personalizadas de organización
Siempre que sea posible, intente evitar proporcionar conjuntos conflictivos de instrucciones. Si le preocupa la calidad de la respuesta, puede deshabilitar temporalmente las instrucciones del repositorio. Consulta Incorporación de instrucciones personalizadas del repositorio para GitHub Copilot.
Usar instrucciones personalizadas
Las instrucciones personalizadas constan de instrucciones de lenguaje natural y son más eficaces cuando son breves e independientes. Tenga en cuenta el ámbito en el que desea que se aplique la instrucción al elegir si desea agregar una instrucción en el nivel personal, repositorio o organización.
Estos son algunos casos de uso comunes y ejemplos para cada tipo de instrucciones personalizadas: * Instrucciones personales:
- Idioma individual preferido:
Always respond in Portuguese. - Preferencias de respuesta individuales:
Explain a single concept per line. Be clear and concise. -
**Instrucciones personalizadas del repositorio:**- Estándares de codificación:
Use early returns whenever possible. - Marcos de trabajo:
Use Vue with the PrimeVue library.oUse Typescript rather than Javascript. - Preferencias de estilo de código:
Use camel case for variable names.
- Estándares de codificación:
-
**Instrucciones personalizadas de la organización:**- Describir cómo responder a determinadas preguntas:
For questions related to security, use the Security Docs Knowledge Base or advise people to consult with #security on Slack. - Idioma preferido para una empresa que habla exclusivamente un único idioma:
Always respond in Portuguese. - Preferencias de toda la organización:
Do not generate code blocks in responses.
- Describir cómo responder a determinadas preguntas:
Redacción de instrucciones personalizadas eficientes
Las instrucciones que agregues al archivo de instrucciones personalizado deben ser cortas e independientes, y proporcionar a Copilot información pertinente para ayudarte a trabajar en este repositorio. Como las instrucciones se envían con todos los mensajes de chat, deben ser ampliamente aplicables a la mayoría de las solicitudes que realizarás en el contexto del repositorio.
La estructura exacta que uses para los archivos de instrucciones variará según el proyecto y las necesidades, pero las siguientes guías proporcionan un buen punto de partida:
- Proporciona información general sobre el proyecto en el que trabajas, incluidos su propósito, objetivos y cualquier información complementaria pertinente.
- Incluye la estructura de carpetas del repositorio, con los directorios o archivos importantes que sean relevantes para el proyecto.
- Especifica los estándares y convenciones de programación que se deban seguir, como convenciones de nomenclatura, reglas de formato y procedimientos recomendados.
- Incluye herramientas, bibliotecas o marcos específicos que se usen en el proyecto, junto con cualquier número de versión o configuraciones pertinentes.
El siguiente archivo de instrucciones es un ejemplo de estas prácticas en acción:
# Project Overview
This project is a web application that allows users to manage their tasks and to-do lists. It is built using React and Node.js, and uses MongoDB for data storage.
## Folder Structure
- `/src`: Contains the source code for the frontend.
- `/server`: Contains the source code for the Node.js backend.
- `/docs`: Contains documentation for the project, including API specifications and user guides.
## Libraries and Frameworks
- React and Tailwind CSS for the frontend.
- Node.js and Express for the backend.
- MongoDB for data storage.
## Coding Standards
- Use semicolons at the end of each statement.
- Use single quotes for strings.
- Use function based components in React.
- Use arrow functions for callbacks.
## UI guidelines
- A toggle is provided to switch between light and dark mode.
- Application should have a modern and clean design.
También debes tener en cuenta el tamaño y la complejidad del repositorio. Los siguientes tipos de instrucciones pueden funcionar para un repositorio pequeño con solo algunos colaboradores, pero para un repositorio grande y diverso, pueden causar problemas:
- Solicitudes para hacer referencia a recursos externos al formular una respuesta
- Instrucciones para responder con un estilo determinado
- Solicitudes para responder siempre con cierto nivel de detalle
Por ejemplo, es posible que las instrucciones siguientes no tengan los resultados previstos:
Always conform to the coding styles defined in styleguide.md in repo my-org/my-repo when generating code.
Use @terminal when answering questions about Git.
Answer all questions in the style of a friendly colleague, using informal language.
Answer all questions in less than 1000 characters, and words of no more than 12 characters.
Pasos siguientes
-
[AUTOTITLE](/copilot/customizing-copilot/adding-personal-custom-instructions-for-github-copilot) -
[AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot) -
[AUTOTITLE](/copilot/customizing-copilot/adding-organization-custom-instructions-for-github-copilot)
Lectura adicional
-
[AUTOTITLE](/copilot/concepts/agents/copilot-memory) -
[AUTOTITLE](/copilot/reference/customization-cheat-sheet)
Nota:
Esta versión de este artículo trata sobre las instrucciones personalizadas y los archivos de indicaciones en VS Code. Haz clic en las pestañas anteriores para otros entornos.
Acerca de la personalización de las respuestas de Copilot
GitHub Copilot pueden proporcionar respuestas adaptadas a la forma en que trabaja el equipo, las herramientas que usa o los detalles del proyecto, si proporciona suficiente contexto para hacerlo. En lugar de agregar repetidamente este detalle contextual a las indicaciones, puede crear archivos en el repositorio que le agreguen automáticamente esta información.
Hay dos tipos de archivos que puede utilizar para proporcionar contexto e instrucciones a Copilot en VS Code:
-
**Las instrucciones personalizadas del repositorio** le permiten especificar las instrucciones y preferencias que Copilot tendrá en cuenta al trabajar en el contexto del repositorio. -
Los **archivos de solicitudes** (versión preliminar pública) le permiten guardar instrucciones de solicitudes comunes y contexto relevante en archivos Markdown (`*.prompt.md`) que puede reutilizar en las solicitudes de chat. Los archivos de comandos solo están disponibles en VS Code, Visual Studio y en IDEs de JetBrains.
Aunque las instrucciones personalizadas ayudan a agregar contexto de todo el código base a cada flujo de trabajo de IA, los archivos de indicación te permiten agregar instrucciones a una interacción de chat específica.
Nota:
Debido a la naturaleza no determinista de la inteligencia artificial, Copilot puede que no siempre siga las instrucciones personalizadas de la misma manera cada vez que se usan.
Acerca de las instrucciones personalizadas del repositorio
Puede usar tres tipos de instrucciones de personalización del repositorio en VS Code:
-
**Instrucciones personalizadas para todo el repositorio**, que se aplican a todas las solicitudes realizadas en el contexto de un repositorio.Se especifican en un archivo
copilot-instructions.mden el directorio.githubdel repositorio. -
**Instrucciones personalizadas específicas de la ruta de acceso**, que se aplican a las solicitudes realizadas en el contexto de los archivos que coinciden con una ruta de acceso especificada.Se especifican en uno o varios
NAME.instructions.mdarchivos dentro o debajo del.github/instructionsdirectorio del repositorio.Al usar instrucciones específicas de la ruta de acceso, puedes evitar sobrecargar las instrucciones de todo el repositorio con información que solo se aplica a archivos de determinados tipos o en determinados directorios.
-
**Instrucciones del agente**, que son similares a las instrucciones personalizadas de todo el repositorio, pero que actualmente no son compatibles con todas las características de Copilot.Se especifican en archivos denominados
AGENTS.md,CLAUDE.mdoGEMINI.md.
Para obtener detalles sobre la compatibilidad de cada uno de estos tipos de e instrucciones personalizadas del repositorio a través de diferentes características de Copilot, consulte Compatibilidad con diferentes tipos de instrucciones personalizadas.
Para obtener una colección seleccionada de ejemplos, consulte Instrucciones personalizadas.
Acerca de los archivos de indicación
Nota:
Los archivos de indicación están en versión preliminar pública y sujetos a cambios.
Los archivos de indicación te permiten crear y compartir instrucciones de indicación reutilizables con más contexto. Un archivo de mensaje es un archivo Markdown, almacenado en tu área de trabajo, que imita el formato existente de escritura de mensajes en Chat de Copiloto (por ejemplo, Rewrite #file:x.ts). Esto permite combinar instrucciones de lenguaje natural, contexto adicional e incluso enlazar a otros archivos de indicación como dependencias.
Entre los casos de uso comunes se incluye:
-
**Generación de código** Cree solicitudes reutilizables para componentes, pruebas o migraciones (por ejemplo, formularios de React o simulación de API). -
**Especialización**. Comparte conocimientos especializados a través de solicitudes, como prácticas de seguridad o comprobaciones de cumplimiento. -
**Colaboración en equipo**. Documente patrones e instrucciones con referencias a especificaciones y documentación. -
**Incorporación**. Crea guías paso a paso para procesos complejos o patrones específicos del proyecto.
Puedes tener varios archivos de mensaje en el área de trabajo y cada uno define un mensaje para un propósito diferente.
Ejemplos
En los ejemplos a continuación se muestra cómo utilizar los archivos de indicación.
-
`New React form.prompt.md`: contiene instrucciones para una tarea reutilizable a fin de generar un formulario mediante React.Your goal is to generate a new React form component. Ask for the form name and fields if not provided. Requirements for the form: - Use form design system components: [design-system/Form.md](../docs/design-system/Form.md) - Use `react-hook-form` for form state management: - Always define TypeScript types for your form data - Prefer *uncontrolled* components using register - Use `defaultValues` to prevent unnecessary rerenders - Use `yup` for validation: - Create reusable validation schemas in separate files - Use TypeScript types to ensure type safety - Customize UX-friendly validation rules -
`API security review.prompt.md`: contiene información reutilizable sobre procedimientos de seguridad para las API REST, que se pueden usar para realizar revisiones de seguridad de las API REST.Secure REST API review: - Ensure all endpoints are protected by authentication and authorization - Validate all user inputs and sanitize data - Implement rate limiting and throttling - Implement logging and monitoring for security events …
Para obtener información sobre cómo habilitar, crear y usar archivos de solicitud, consulte Incorporación de instrucciones personalizadas del repositorio para GitHub Copilot.
Redacción de instrucciones personalizadas eficientes
Las instrucciones que agregues al archivo de instrucciones personalizado deben ser cortas e independientes, y proporcionar a Copilot información pertinente para ayudarte a trabajar en este repositorio. Como las instrucciones se envían con todos los mensajes de chat, deben ser ampliamente aplicables a la mayoría de las solicitudes que realizarás en el contexto del repositorio.
La estructura exacta que uses para los archivos de instrucciones variará según el proyecto y las necesidades, pero las siguientes guías proporcionan un buen punto de partida:
- Proporciona información general sobre el proyecto en el que trabajas, incluidos su propósito, objetivos y cualquier información complementaria pertinente.
- Incluye la estructura de carpetas del repositorio, con los directorios o archivos importantes que sean relevantes para el proyecto.
- Especifica los estándares y convenciones de programación que se deban seguir, como convenciones de nomenclatura, reglas de formato y procedimientos recomendados.
- Incluye herramientas, bibliotecas o marcos específicos que se usen en el proyecto, junto con cualquier número de versión o configuraciones pertinentes.
El siguiente archivo de instrucciones es un ejemplo de estas prácticas en acción:
# Project Overview
This project is a web application that allows users to manage their tasks and to-do lists. It is built using React and Node.js, and uses MongoDB for data storage.
## Folder Structure
- `/src`: Contains the source code for the frontend.
- `/server`: Contains the source code for the Node.js backend.
- `/docs`: Contains documentation for the project, including API specifications and user guides.
## Libraries and Frameworks
- React and Tailwind CSS for the frontend.
- Node.js and Express for the backend.
- MongoDB for data storage.
## Coding Standards
- Use semicolons at the end of each statement.
- Use single quotes for strings.
- Use function based components in React.
- Use arrow functions for callbacks.
## UI guidelines
- A toggle is provided to switch between light and dark mode.
- Application should have a modern and clean design.
También debes tener en cuenta el tamaño y la complejidad del repositorio. Los siguientes tipos de instrucciones pueden funcionar para un repositorio pequeño con solo algunos colaboradores, pero para un repositorio grande y diverso, pueden causar problemas:
- Solicitudes para hacer referencia a recursos externos al formular una respuesta
- Instrucciones para responder con un estilo determinado
- Solicitudes para responder siempre con cierto nivel de detalle
Por ejemplo, es posible que las instrucciones siguientes no tengan los resultados previstos:
Always conform to the coding styles defined in styleguide.md in repo my-org/my-repo when generating code.
Use @terminal when answering questions about Git.
Answer all questions in the style of a friendly colleague, using informal language.
Answer all questions in less than 1000 characters, and words of no more than 12 characters.
Pasos siguientes
-
[AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot) -
[AUTOTITLE](/copilot/tutorials/use-custom-instructions) -
[AUTOTITLE](/copilot/reference/customization-cheat-sheet)
Nota:
Esta versión de este artículo trata sobre las instrucciones personalizadas del repositorio y los archivos de solicitud en Visual Studio. Haz clic en las pestañas anteriores para otros entornos.
Acerca de la personalización de las respuestas de Copilot
GitHub Copilot pueden proporcionar respuestas adaptadas a la forma en que trabaja el equipo, las herramientas que usa o los detalles del proyecto, si proporciona suficiente contexto para hacerlo. En lugar de agregar repetidamente este detalle contextual a las indicaciones, puede crear archivos en el repositorio que le agreguen automáticamente esta información.
Hay dos tipos de archivos que puede usar a fin de proporcionar contexto e instrucciones a Copilot en Visual Studio:
-
**Las instrucciones personalizadas del repositorio** le permiten especificar las instrucciones y preferencias que Copilot tendrá en cuenta al trabajar en el contexto del repositorio. -
**Archivos de indicaciones** le permiten guardar instrucciones comunes de indicaciones y contexto relevante en archivos Markdown (`*.prompt.md`) que luego puede reutilizar en las indicaciones de chat. Los archivos de comandos solo están disponibles en VS Code, Visual Studio y en IDEs de JetBrains.
Aunque las instrucciones personalizadas ayudan a agregar contexto de todo el código base a cada flujo de trabajo de IA, los archivos de indicación te permiten agregar instrucciones a una interacción de chat específica.
Nota:
Debido a la naturaleza no determinista de la inteligencia artificial, Copilot puede que no siempre siga las instrucciones personalizadas de la misma manera cada vez que se usan.
Acerca de las instrucciones personalizadas del repositorio
Puede usar dos tipos de instrucciones personalizadas del repositorio en Visual Studio:
-
**Instrucciones personalizadas para todo el repositorio**, que se aplican a todas las solicitudes realizadas en el contexto de un repositorio.Se especifican en un archivo
copilot-instructions.mden el directorio.githubdel repositorio. -
**Instrucciones personalizadas específicas de la ruta de acceso**, que se aplican a las solicitudes realizadas en el contexto de los archivos que coinciden con una ruta de acceso especificada.Se especifican en uno o varios
NAME.instructions.mdarchivos dentro o debajo del.github/instructionsdirectorio del repositorio.Al usar instrucciones específicas de la ruta de acceso, puedes evitar sobrecargar las instrucciones de todo el repositorio con información que solo se aplica a archivos de determinados tipos o en determinados directorios.
Para obtener detalles sobre la compatibilidad de cada uno de estos tipos de e instrucciones personalizadas del repositorio a través de diferentes características de Copilot, consulte Compatibilidad con diferentes tipos de instrucciones personalizadas.
Para obtener una colección seleccionada de ejemplos, consulte Instrucciones personalizadas.
Acerca de los archivos de indicación
Los archivos de indicación te permiten crear y compartir instrucciones de indicación reutilizables con más contexto. Un archivo de mensaje es un archivo Markdown, almacenado en tu área de trabajo, que imita el formato existente de escritura de mensajes en Chat de Copiloto (por ejemplo, Rewrite #file:x.ts). Esto permite combinar instrucciones de lenguaje natural, contexto adicional e incluso enlazar a otros archivos de indicación como dependencias.
Entre los casos de uso comunes se incluye:
-
**Generación de código** Cree solicitudes reutilizables para componentes, pruebas o migraciones (por ejemplo, formularios de React o simulación de API). -
**Especialización**. Comparte conocimientos especializados a través de solicitudes, como prácticas de seguridad o comprobaciones de cumplimiento. -
**Colaboración en equipo**. Documente patrones e instrucciones con referencias a especificaciones y documentación. -
**Incorporación**. Crea guías paso a paso para procesos complejos o patrones específicos del proyecto.
Puedes tener varios archivos de mensaje en el área de trabajo y cada uno define un mensaje para un propósito diferente.
Ejemplos
En los ejemplos a continuación se muestra cómo utilizar los archivos de indicación.
-
`New React form.prompt.md`: contiene instrucciones para una tarea reutilizable a fin de generar un formulario mediante React.Your goal is to generate a new React form component. Ask for the form name and fields if not provided. Requirements for the form: - Use form design system components: [design-system/Form.md](../docs/design-system/Form.md) - Use `react-hook-form` for form state management: - Always define TypeScript types for your form data - Prefer *uncontrolled* components using register - Use `defaultValues` to prevent unnecessary rerenders - Use `yup` for validation: - Create reusable validation schemas in separate files - Use TypeScript types to ensure type safety - Customize UX-friendly validation rules -
`API security review.prompt.md`: contiene información reutilizable sobre procedimientos de seguridad para las API REST, que se pueden usar para realizar revisiones de seguridad de las API REST.Secure REST API review: - Ensure all endpoints are protected by authentication and authorization - Validate all user inputs and sanitize data - Implement rate limiting and throttling - Implement logging and monitoring for security events …
Para obtener información sobre cómo crear y usar archivos de solicitud, consulte Incorporación de instrucciones personalizadas del repositorio para GitHub Copilot.
Redacción de instrucciones personalizadas eficientes
Las instrucciones que agregues al archivo de instrucciones personalizado deben ser cortas e independientes, y proporcionar a Copilot información pertinente para ayudarte a trabajar en este repositorio. Como las instrucciones se envían con todos los mensajes de chat, deben ser ampliamente aplicables a la mayoría de las solicitudes que realizarás en el contexto del repositorio.
La estructura exacta que uses para los archivos de instrucciones variará según el proyecto y las necesidades, pero las siguientes guías proporcionan un buen punto de partida:
- Proporciona información general sobre el proyecto en el que trabajas, incluidos su propósito, objetivos y cualquier información complementaria pertinente.
- Incluye la estructura de carpetas del repositorio, con los directorios o archivos importantes que sean relevantes para el proyecto.
- Especifica los estándares y convenciones de programación que se deban seguir, como convenciones de nomenclatura, reglas de formato y procedimientos recomendados.
- Incluye herramientas, bibliotecas o marcos específicos que se usen en el proyecto, junto con cualquier número de versión o configuraciones pertinentes.
El siguiente archivo de instrucciones es un ejemplo de estas prácticas en acción:
# Project Overview
This project is a web application that allows users to manage their tasks and to-do lists. It is built using React and Node.js, and uses MongoDB for data storage.
## Folder Structure
- `/src`: Contains the source code for the frontend.
- `/server`: Contains the source code for the Node.js backend.
- `/docs`: Contains documentation for the project, including API specifications and user guides.
## Libraries and Frameworks
- React and Tailwind CSS for the frontend.
- Node.js and Express for the backend.
- MongoDB for data storage.
## Coding Standards
- Use semicolons at the end of each statement.
- Use single quotes for strings.
- Use function based components in React.
- Use arrow functions for callbacks.
## UI guidelines
- A toggle is provided to switch between light and dark mode.
- Application should have a modern and clean design.
También debes tener en cuenta el tamaño y la complejidad del repositorio. Los siguientes tipos de instrucciones pueden funcionar para un repositorio pequeño con solo algunos colaboradores, pero para un repositorio grande y diverso, pueden causar problemas:
- Solicitudes para hacer referencia a recursos externos al formular una respuesta
- Instrucciones para responder con un estilo determinado
- Solicitudes para responder siempre con cierto nivel de detalle
Por ejemplo, es posible que las instrucciones siguientes no tengan los resultados previstos:
Always conform to the coding styles defined in styleguide.md in repo my-org/my-repo when generating code.
Use @terminal when answering questions about Git.
Answer all questions in the style of a friendly colleague, using informal language.
Answer all questions in less than 1000 characters, and words of no more than 12 characters.
Pasos siguientes
-
[AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot) -
[AUTOTITLE](/copilot/reference/customization-cheat-sheet)
Nota:
Esta versión de este artículo trata sobre instrucciones personalizadas y archivos de solicitud en los IDE de JetBrains. Haz clic en las pestañas anteriores para otros entornos.
Acerca de la personalización de las respuestas de Copilot
GitHub Copilot pueden proporcionar respuestas adaptadas a la forma en que trabaja el equipo, las herramientas que usa o los detalles del proyecto, si proporciona suficiente contexto para hacerlo. En lugar de agregar repetidamente este detalle contextual a las indicaciones, puede crear un archivo de instrucciones personalizado en el repositorio que agregue automáticamente esta información.
Hay dos tipos de archivos que puede usar para proporcionar el contexto e instrucciones para Copilot en los IDE de JetBrains.
-
**Las instrucciones personalizadas del repositorio** le permiten especificar las instrucciones y preferencias que Copilot tendrá en cuenta al trabajar en el contexto del repositorio. -
Los **archivos de solicitudes** (versión preliminar pública) le permiten guardar instrucciones de solicitudes comunes y contexto relevante en archivos Markdown (`*.prompt.md`) que puede reutilizar en las solicitudes de chat. Los archivos de comandos solo están disponibles en VS Code, Visual Studio y en IDEs de JetBrains.
Aunque las instrucciones personalizadas ayudan a agregar contexto de todo el código base a cada flujo de trabajo de IA, los archivos de indicación te permiten agregar instrucciones a una interacción de chat específica.
Nota:
Debido a la naturaleza no determinista de la inteligencia artificial, Copilot puede que no siempre siga las instrucciones personalizadas de la misma manera cada vez que se usan.
Acerca de las instrucciones personalizadas del repositorio
En los IDE de JetBrains, las instrucciones personalizadas del repositorio constan de un único archivo, .github/copilot-instructions.md, que se crea en un repositorio. Las instrucciones que agregue al archivo deben ser breves y autónomas, y deben agregar contexto o información relevante para complementar una solicitud de Copilot.
Compatibilidad con instrucciones personalizadas del repositorio
Para obtener más información sobre qué tipos de instrucciones personalizadas se admiten en varios entornos, consulte Compatibilidad con diferentes tipos de instrucciones personalizadas.
Casos de uso para instrucciones personalizadas
Entre los casos de uso comunes para instrucciones personalizadas se incluyen:
-
**Generación de pruebas.** Crea instrucciones para la generación de pruebas, como especificar el uso de un marco de pruebas determinado. -
**Revisión de código.** Especifica instrucciones para revisar el código, como indicar a un revisor que busque un error específico en el código. -
**Generación del mensaje de confirmación.** Escribe instrucciones para generar mensajes de confirmación, como el formato o el tipo de información que se va a incluir.
Ejemplo
Este ejemplo de un archivo d.github/copilot-instructions.md contiene tres instrucciones para Copilot.
We use Bazel for managing our Java dependencies, not Maven, so when talking about Java packages, always give me instructions and code samples that use Bazel.
We always write JavaScript with double quotes and tabs for indentation, so when your responses include JavaScript code, please follow those conventions.
Our team uses Jira for tracking items of work.
Para obtener una colección seleccionada de ejemplos, consulte Instrucciones personalizadas.
Acerca de los archivos de indicación
Nota:
Los archivos de indicación están en versión preliminar pública y sujetos a cambios.
Los archivos de indicación te permiten crear y compartir instrucciones de indicación reutilizables con más contexto. Un archivo de mensaje es un archivo Markdown, almacenado en tu área de trabajo, que imita el formato existente de escritura de mensajes en Chat de Copiloto (por ejemplo, Rewrite #file:x.ts). Esto permite combinar instrucciones de lenguaje natural y contexto adicional.
Entre los casos de uso comunes se incluye:
-
**Generación de código** Cree solicitudes reutilizables para componentes, pruebas o migraciones (por ejemplo, formularios de React o simulación de API). -
**Especialización**. Comparte conocimientos especializados a través de solicitudes, como prácticas de seguridad o comprobaciones de cumplimiento. -
**Colaboración en equipo**. Documente patrones e instrucciones con referencias a especificaciones y documentación. -
**Incorporación**. Crea guías paso a paso para procesos complejos o patrones específicos del proyecto.
Puedes tener varios archivos de mensaje en el área de trabajo y cada uno define un mensaje para un propósito diferente.
Ejemplos
En los ejemplos a continuación se muestra cómo utilizar los archivos de indicación.
-
`New React form.prompt.md`: contiene instrucciones para una tarea reutilizable a fin de generar un formulario mediante React.Your goal is to generate a new React form component. Ask for the form name and fields if not provided. Requirements for the form: - Use form design system components: [design-system/Form.md](../docs/design-system/Form.md) - Use `react-hook-form` for form state management: - Always define TypeScript types for your form data - Prefer *uncontrolled* components using register - Use `defaultValues` to prevent unnecessary rerenders - Use `yup` for validation: - Create reusable validation schemas in separate files - Use TypeScript types to ensure type safety - Customize UX-friendly validation rules -
`API security review.prompt.md`: contiene información reutilizable sobre procedimientos de seguridad para las API REST, que se pueden usar para realizar revisiones de seguridad de las API REST.Secure REST API review: - Ensure all endpoints are protected by authentication and authorization - Validate all user inputs and sanitize data - Implement rate limiting and throttling - Implement logging and monitoring for security events …
Para obtener una colección seleccionada de ejemplos, consulte Archivos de mensajes.
Redacción de instrucciones personalizadas eficientes
Las instrucciones que agregues al archivo de instrucciones personalizado deben ser cortas e independientes, y proporcionar a Copilot información pertinente para ayudarte a trabajar en este repositorio. Como las instrucciones se envían con todos los mensajes de chat, deben ser ampliamente aplicables a la mayoría de las solicitudes que realizarás en el contexto del repositorio.
La estructura exacta que uses para los archivos de instrucciones variará según el proyecto y las necesidades, pero las siguientes guías proporcionan un buen punto de partida:
- Proporciona información general sobre el proyecto en el que trabajas, incluidos su propósito, objetivos y cualquier información complementaria pertinente.
- Incluye la estructura de carpetas del repositorio, con los directorios o archivos importantes que sean relevantes para el proyecto.
- Especifica los estándares y convenciones de programación que se deban seguir, como convenciones de nomenclatura, reglas de formato y procedimientos recomendados.
- Incluye herramientas, bibliotecas o marcos específicos que se usen en el proyecto, junto con cualquier número de versión o configuraciones pertinentes.
El siguiente archivo de instrucciones es un ejemplo de estas prácticas en acción:
# Project Overview
This project is a web application that allows users to manage their tasks and to-do lists. It is built using React and Node.js, and uses MongoDB for data storage.
## Folder Structure
- `/src`: Contains the source code for the frontend.
- `/server`: Contains the source code for the Node.js backend.
- `/docs`: Contains documentation for the project, including API specifications and user guides.
## Libraries and Frameworks
- React and Tailwind CSS for the frontend.
- Node.js and Express for the backend.
- MongoDB for data storage.
## Coding Standards
- Use semicolons at the end of each statement.
- Use single quotes for strings.
- Use function based components in React.
- Use arrow functions for callbacks.
## UI guidelines
- A toggle is provided to switch between light and dark mode.
- Application should have a modern and clean design.
También debes tener en cuenta el tamaño y la complejidad del repositorio. Los siguientes tipos de instrucciones pueden funcionar para un repositorio pequeño con solo algunos colaboradores, pero para un repositorio grande y diverso, pueden causar problemas:
- Solicitudes para hacer referencia a recursos externos al formular una respuesta
- Instrucciones para responder con un estilo determinado
- Solicitudes para responder siempre con cierto nivel de detalle
Por ejemplo, es posible que las instrucciones siguientes no tengan los resultados previstos:
Always conform to the coding styles defined in styleguide.md in repo my-org/my-repo when generating code.
Use @terminal when answering questions about Git.
Answer all questions in the style of a friendly colleague, using informal language.
Answer all questions in less than 1000 characters, and words of no more than 12 characters.
Pasos siguientes
-
[AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot) -
[AUTOTITLE](/copilot/tutorials/use-custom-instructions) -
[AUTOTITLE](/copilot/reference/customization-cheat-sheet)
Nota:
Esta versión de este artículo trata sobre instrucciones personalizadas en Xcode. Haz clic en las pestañas anteriores para otros entornos.
Acerca de la personalización de las respuestas de Copilot
GitHub Copilot pueden proporcionar respuestas adaptadas a la forma en que trabaja el equipo, las herramientas que usa o los detalles del proyecto, si proporciona suficiente contexto para hacerlo. En lugar de agregar repetidamente este detalle contextual a las indicaciones, puede crear un archivo de instrucciones personalizado en el repositorio que agregue automáticamente esta información. La información adicional no se muestra en el cuadro de entrada del chat, pero está disponible para Copilot para permitir que genere respuestas de mayor calidad.
Nota:
Debido a la naturaleza no determinista de la inteligencia artificial, Copilot puede que no siempre siga las instrucciones personalizadas de la misma manera cada vez que se usan.
Acerca de las instrucciones personalizadas del repositorio
En Xcode, las instrucciones personalizadas del repositorio constan de un único archivo, .github/copilot-instructions.md, que se crea en un repositorio. Las instrucciones que agregue al archivo deben ser breves y autónomas, y deben agregar contexto o información relevante para complementar una solicitud de Copilot.
Compatibilidad con instrucciones personalizadas del repositorio
Para obtener más información sobre qué tipos de instrucciones personalizadas se admiten en varios entornos, consulte Compatibilidad con diferentes tipos de instrucciones personalizadas.
Casos de uso para instrucciones personalizadas
Entre los casos de uso comunes para las instrucciones personalizadas del repositorio se incluyen:
-
**Generación de pruebas.** Crea instrucciones para la generación de pruebas, como especificar el uso de un marco de pruebas determinado. -
**Revisión de código.** Especifica instrucciones para revisar el código, como indicar a un revisor que busque un error específico en el código. -
**Generación del mensaje de confirmación.** Escribe instrucciones para generar mensajes de confirmación, como el formato o el tipo de información que se va a incluir.
Ejemplo
Este ejemplo de un archivo d.github/copilot-instructions.md contiene tres instrucciones para Copilot.
We use Bazel for managing our Java dependencies, not Maven, so when talking about Java packages, always give me instructions and code samples that use Bazel.
We always write JavaScript with double quotes and tabs for indentation, so when your responses include JavaScript code, please follow those conventions.
Our team uses Jira for tracking items of work.
Para obtener una colección seleccionada de ejemplos, consulte Instrucciones personalizadas.
Redacción de instrucciones personalizadas eficientes
Las instrucciones que agregues al archivo de instrucciones personalizado deben ser cortas e independientes, y proporcionar a Copilot información pertinente para ayudarte a trabajar en este repositorio. Como las instrucciones se envían con todos los mensajes de chat, deben ser ampliamente aplicables a la mayoría de las solicitudes que realizarás en el contexto del repositorio.
La estructura exacta que uses para los archivos de instrucciones variará según el proyecto y las necesidades, pero las siguientes guías proporcionan un buen punto de partida:
- Proporciona información general sobre el proyecto en el que trabajas, incluidos su propósito, objetivos y cualquier información complementaria pertinente.
- Incluye la estructura de carpetas del repositorio, con los directorios o archivos importantes que sean relevantes para el proyecto.
- Especifica los estándares y convenciones de programación que se deban seguir, como convenciones de nomenclatura, reglas de formato y procedimientos recomendados.
- Incluye herramientas, bibliotecas o marcos específicos que se usen en el proyecto, junto con cualquier número de versión o configuraciones pertinentes.
El siguiente archivo de instrucciones es un ejemplo de estas prácticas en acción:
# Project Overview
This project is a web application that allows users to manage their tasks and to-do lists. It is built using React and Node.js, and uses MongoDB for data storage.
## Folder Structure
- `/src`: Contains the source code for the frontend.
- `/server`: Contains the source code for the Node.js backend.
- `/docs`: Contains documentation for the project, including API specifications and user guides.
## Libraries and Frameworks
- React and Tailwind CSS for the frontend.
- Node.js and Express for the backend.
- MongoDB for data storage.
## Coding Standards
- Use semicolons at the end of each statement.
- Use single quotes for strings.
- Use function based components in React.
- Use arrow functions for callbacks.
## UI guidelines
- A toggle is provided to switch between light and dark mode.
- Application should have a modern and clean design.
También debes tener en cuenta el tamaño y la complejidad del repositorio. Los siguientes tipos de instrucciones pueden funcionar para un repositorio pequeño con solo algunos colaboradores, pero para un repositorio grande y diverso, pueden causar problemas:
- Solicitudes para hacer referencia a recursos externos al formular una respuesta
- Instrucciones para responder con un estilo determinado
- Solicitudes para responder siempre con cierto nivel de detalle
Por ejemplo, es posible que las instrucciones siguientes no tengan los resultados previstos:
Always conform to the coding styles defined in styleguide.md in repo my-org/my-repo when generating code.
Use @terminal when answering questions about Git.
Answer all questions in the style of a friendly colleague, using informal language.
Answer all questions in less than 1000 characters, and words of no more than 12 characters.
Pasos siguientes
-
[AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot) -
[AUTOTITLE](/copilot/tutorials/use-custom-instructions) -
[AUTOTITLE](/copilot/reference/customization-cheat-sheet)
Nota:
Esta versión de este artículo trata sobre instrucciones personalizadas en Eclipse. Haz clic en las pestañas anteriores para otros entornos.
Acerca de la personalización de las respuestas de Copilot
GitHub Copilot pueden proporcionar respuestas adaptadas a la forma en que trabaja el equipo, las herramientas que usa o los detalles del proyecto, si proporciona suficiente contexto para hacerlo. En lugar de agregar repetidamente este detalle contextual a las indicaciones, puede crear un archivo de instrucciones personalizado en el repositorio que agregue automáticamente esta información. La información adicional no se muestra en el cuadro de entrada del chat, pero está disponible para Copilot para permitir que genere respuestas de mayor calidad.
Hay dos tipos de instrucciones personalizadas del repositorio que puede usar para proporcionar contexto e instrucciones para Copilot en Eclipse:
-
**Instrucciones personalizadas del área de trabajo** que se aplican a todos los proyectos de un área de trabajo y permiten especificar las instrucciones y preferencias de todo el área de trabajo en un único archivo. -
**Instrucciones personalizadas del proyecto** que se aplican a un proyecto específico.
Nota:
Debido a la naturaleza no determinista de la inteligencia artificial, Copilot puede que no siempre siga las instrucciones personalizadas de la misma manera cada vez que se usan.
Acerca de las instrucciones personalizadas del repositorio
Las **instrucciones personalizadas del área de trabajo** se aplican a todos los proyectos de un área de trabajo y permiten especificar las instrucciones y preferencias de todo el área de trabajo. Puede usar instrucciones personalizadas del área de trabajo para dar contexto e instrucciones a Copilot en Eclipse.
Las **instrucciones personalizadas de proyecto** constan de un único archivo, `.github/copilot-instructions.md`, que se crea en un proyecto. Las instrucciones que agregue al archivo deben ser breves y autónomas, y deben agregar contexto o información relevante para complementar una solicitud de Copilot.
Entre los casos de uso comunes se incluye:
-
**Generación de pruebas.** Crea instrucciones para la generación de pruebas, como especificar el uso de un marco de pruebas determinado. -
**Revisión de código.** Especifica instrucciones para revisar el código, como indicar a un revisor que busque un error específico en el código. -
**Generación del mensaje de confirmación.** Escribe instrucciones para generar mensajes de confirmación, como el formato o el tipo de información que se va a incluir.
Ejemplo
Este ejemplo de un archivo d.github/copilot-instructions.md contiene tres instrucciones para Copilot.
We use Bazel for managing our Java dependencies, not Maven, so when talking about Java packages, always give me instructions and code samples that use Bazel.
We always write JavaScript with double quotes and tabs for indentation, so when your responses include JavaScript code, please follow those conventions.
Our team uses Jira for tracking items of work.
Para obtener una colección seleccionada de ejemplos, consulte Instrucciones personalizadas.
Redacción de instrucciones personalizadas eficientes
Las instrucciones que agregues al archivo de instrucciones personalizado deben ser cortas e independientes, y proporcionar a Copilot información pertinente para ayudarte a trabajar en este repositorio. Como las instrucciones se envían con todos los mensajes de chat, deben ser ampliamente aplicables a la mayoría de las solicitudes que realizarás en el contexto del repositorio.
La estructura exacta que uses para los archivos de instrucciones variará según el proyecto y las necesidades, pero las siguientes guías proporcionan un buen punto de partida:
- Proporciona información general sobre el proyecto en el que trabajas, incluidos su propósito, objetivos y cualquier información complementaria pertinente.
- Incluye la estructura de carpetas del repositorio, con los directorios o archivos importantes que sean relevantes para el proyecto.
- Especifica los estándares y convenciones de programación que se deban seguir, como convenciones de nomenclatura, reglas de formato y procedimientos recomendados.
- Incluye herramientas, bibliotecas o marcos específicos que se usen en el proyecto, junto con cualquier número de versión o configuraciones pertinentes.
El siguiente archivo de instrucciones es un ejemplo de estas prácticas en acción:
# Project Overview
This project is a web application that allows users to manage their tasks and to-do lists. It is built using React and Node.js, and uses MongoDB for data storage.
## Folder Structure
- `/src`: Contains the source code for the frontend.
- `/server`: Contains the source code for the Node.js backend.
- `/docs`: Contains documentation for the project, including API specifications and user guides.
## Libraries and Frameworks
- React and Tailwind CSS for the frontend.
- Node.js and Express for the backend.
- MongoDB for data storage.
## Coding Standards
- Use semicolons at the end of each statement.
- Use single quotes for strings.
- Use function based components in React.
- Use arrow functions for callbacks.
## UI guidelines
- A toggle is provided to switch between light and dark mode.
- Application should have a modern and clean design.
También debes tener en cuenta el tamaño y la complejidad del repositorio. Los siguientes tipos de instrucciones pueden funcionar para un repositorio pequeño con solo algunos colaboradores, pero para un repositorio grande y diverso, pueden causar problemas:
- Solicitudes para hacer referencia a recursos externos al formular una respuesta
- Instrucciones para responder con un estilo determinado
- Solicitudes para responder siempre con cierto nivel de detalle
Por ejemplo, es posible que las instrucciones siguientes no tengan los resultados previstos:
Always conform to the coding styles defined in styleguide.md in repo my-org/my-repo when generating code.
Use @terminal when answering questions about Git.
Answer all questions in the style of a friendly colleague, using informal language.
Answer all questions in less than 1000 characters, and words of no more than 12 characters.
Pasos siguientes
-
[AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot) -
[AUTOTITLE](/copilot/tutorials/use-custom-instructions) -
[AUTOTITLE](/copilot/reference/customization-cheat-sheet)