Añadir instrucciones personalizadas del repositorio para GitHub Copilot en tu IDE

Cree archivos de instrucciones personalizadas del repositorio que proporcionen Copilot contexto adicional sobre cómo comprender el proyecto y cómo compilar, probar y validar sus cambios.

Tool navigation

En este artículo

Esta versión de este artículo es para usar instrucciones personalizadas del repositorio y solicitar archivos en VS Code. Haz clic en las pestañas anteriores para obtener instrucciones sobre cómo usar instrucciones personalizadas en otros entornos.

Introducción

Las instrucciones personalizadas de repositorio te permiten proporcionar a Copilot instrucciones y preferencias específicas del repositorio. Para más información, consulta Acerca de la personalización de las respuestas de GitHub Copilot.

Requisitos previos para las instrucciones personalizadas del repositorio

Creación de instrucciones personalizadas

          VS Code admite tres tipos de instrucciones personalizadas del repositorio. Para más información sobre qué GitHub Copilot características admiten estos tipos de instrucciones, consulte [AUTOTITLE](/copilot/concepts/prompting/response-customization?tool=vscode#support-for-repository-custom-instructions-1).

  • 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.md en el directorio .github del repositorio. Consulta Creación de instrucciones personalizadas para todo el 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.

    Estos se especifican en uno o más NAME.instructions.md archivos dentro o debajo del directorio .github/instructions del repositorio. Consulta Crear instrucciones personalizadas específicas de la ruta.

    Si la ruta de acceso especificada coincide con un archivo en el que Copilot se está trabajando y también existe un archivo de instrucciones personalizadas para todo el repositorio, se usan las instrucciones de ambos archivos.

  •           Los agentes de IA usan las **instrucciones del agente**.

    Puedes crear uno o más archivos AGENTS.md, almacenados en cualquier lugar del repositorio. Cuando Copilot funciona, el archivo más AGENTS.md cercano del árbol de directorios tendrá prioridad. Para obtener más información, consulte el repositorio agentsmd/agents.md.

    Nota:

    La compatibilidad con archivos fuera de la raíz AGENTS.md del área de trabajo está desactivada de forma predeterminada. Para más información sobre cómo habilitar esta característica, consulte Uso de instrucciones personalizadas en VS Code en la VS Code documentación.

Creación de instrucciones personalizadas para todo el repositorio

  1. En la raíz del repositorio, cree un archivo denominado .github/copilot-instructions.md.

    Crea el directorio .github si no existe todavía.

  2. Agrega instrucciones de lenguaje natural al archivo en formato Markdown.

    Se ignora el espacio en blanco entre las instrucciones, por lo que estas pueden escribirse como un solo párrafo, cada una en una nueva línea o separadas por líneas en blanco para mejorar la legibilidad.

Creación de instrucciones personalizadas específicas de la ruta de acceso

  1. Crea el directorio .github/instructions si no existe todavía.

  2. Opcionalmente, cree subdirectorios de .github/instructions para organizar sus archivos de instrucciones.

  3. Crea uno o varios archivos NAME.instructions.md, donde NAME indica el propósito de las instrucciones. El nombre de archivo debe terminar con .instructions.md.

  4. Al principio del archivo, crea un bloque de texto preliminar que contenga la palabra clave applyTo. Usa la sintaxis global para especificar a qué archivos o directorios se aplican las instrucciones.

    Por ejemplo:

    ---
applyTo: "app/models/**/*.rb"
---

    Puedes especificar varios patrones si los separas con comas. Por ejemplo, para aplicar las instrucciones a todos los archivos TypeScript del repositorio, podrías usar el siguiente bloque de texto preliminar:

    ---
applyTo: "**/*.ts,**/*.tsx"
---

    Ejemplos de Glob:

    • * - coincidirá con todos los archivos del directorio actual.
    • ** o **/* - coincidirán con todos los archivos en todos los directorios.
    • *.py : coincidirá con todos los .py archivos del directorio actual.
    • **/*.py : coincidirá recursivamente con todos los .py archivos de todos los directorios.
    • src/*.py : coincidirá con todos los .py archivos del src directorio. Por ejemplo, src/foo.py y src/bar.pypero nosrc/foo/bar.py.
    • src/**/*.py : coincidirá recursivamente con todos los .py archivos del src directorio. Por ejemplo, src/foo.py, src/foo/bar.py y src/foo/bar/baz.py.
    • **/subdir/**/*.py : coincidirá recursivamente con todos los .py archivos de cualquier subdir directorio a cualquier profundidad. Por ejemplo, subdir/foo.py, subdir/nested/bar.py, parent/subdir/baz.pyy deep/parent/subdir/nested/qux.py, pero nofoo.py en una ruta de acceso que no contiene un subdir directorio.

  5. De forma opcional, para evitar que el archivo sea usado por agente en la nube de Copilot o revisión de código Copilot, agregue la palabra clave excludeAgent al bloque frontmatter. Use "code-review" o "cloud-agent".

    Por ejemplo, el archivo siguiente solo lo leerá agente en la nube de Copilot.

    ---
applyTo: "**"
excludeAgent: "code-review"
---

    Si la excludeAgent palabra clave no se incluye en el bloque de front matter, tanto revisión de código Copilot como agente en la nube de Copilot usarán tus instrucciones.

  6. Agrega las instrucciones personalizadas en lenguaje natural mediante el formato Markdown. Se ignora el espacio en blanco entre las instrucciones, por lo que estas pueden escribirse como un solo párrafo, cada una en una nueva línea o separadas por líneas en blanco para mejorar la legibilidad.

¿Has agregado correctamente un archivo de instrucciones personalizado al repositorio?

          <a href="https://docs.github.io/success-test/yes.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline">
          <span>Sí</span></a><a href="https://docs.github.io/success-test/no.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline"><span>No</span></a>

Instrucciones personalizadas en uso

Las instrucciones de los archivos están disponibles para su uso por Copilot tan pronto como guarde el/los archivo(s). Las instrucciones se agregan automáticamente a las solicitudes que envíe a Copilot.

Las instrucciones personalizadas no aparecen en la vista de chat ni en el chat en línea, pero puedes comprobar que Copilot las está usando si examinas la lista de referencias de una respuesta en la vista de chat. Si se han agregado instrucciones personalizadas a la solicitud que se ha enviado al modelo, el archivo .github/copilot-instructions.md aparece como referencia. Puedes hacer clic en la referencia para abrir el archivo.

Captura de pantalla de una lista de referencias expandida, en la que se muestra el archivo "copilot-instructions.md" resaltado con un contorno naranja oscuro.

Habilitación o deshabilitación de instrucciones personalizadas del repositorio

Puedes elegir si quieres que Copilot use instrucciones personalizadas basadas en repositorios o no.

Habilitación o deshabilitación de instrucciones personalizadas para Chat de Copiloto

Las instrucciones personalizadas están habilitadas para Chat de Copiloto de manera predeterminada, pero puedes deshabilitarlas o volver a habilitarlas en cualquier momento. Esto se aplica a tu propio uso de Chat de Copiloto y no afecta a otros usuarios.

  1. Abre el editor de configuración mediante el método abreviado de teclado Command+, (Mac)/Ctrl+, (Linux/Windows).
  2. Escriba instruction file en el cuadro de búsqueda.
  3. Selecciona o desmarca la casilla en Code Generation: Use Instruction Files.

Habilitación o deshabilitación de instrucciones personalizadas para revisión de código Copilot

Las instrucciones personalizadas están habilitadas para revisión de código Copilot de manera predeterminada, pero puedes deshabilitarlas o volver a habilitarlas en la configuración del repositorio en GitHub.com. Esto se aplica al uso por parte de Copilot de instrucciones personalizadas para todas las revisiones de código que realiza en este repositorio.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. Debajo del nombre del repositorio, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

    Captura de pantalla de un encabezado de repositorio en el que se muestran las pestañas. La pestaña "Configuración" está resaltada con un contorno naranja oscuro.

  3. En la sección "Code & automation" de la barra lateral, haz clic en Copilot y, a continuación, Code review.

  4. Activa o desactiva la opción "Use custom instructions when reviewing pull requests".

Habilitación y uso de archivos de indicaciones

Nota:

Los archivos de indicación te permiten crear y compartir instrucciones de indicación reutilizables con más contexto. Un archivo de sugerencias es un archivo Markdown, almacenado en el área de trabajo, que imita el formato existente de las sugerencias de escritura en Chat de Copiloto (por ejemplo, Rewrite #file:x.ts). Puedes tener varios archivos de mensaje en el área de trabajo y cada uno define un mensaje para un propósito diferente.

Habilitación de archivos de mensaje

Para habilitar los archivos de aviso, configura los valores del área de trabajo.

  1. Abra la paleta de comandos pulsando Ctrl+Mayús+P (Windows/Linux) / Comando+Mayús+P (Mac).
  2. Escribe "Open Workspace Settings (JSON)" y selecciona la opción que se muestra.
  3. En el archivo settings.json, agrega "chat.promptFiles": true para habilitar la carpeta .github/prompts como ubicación para los archivos de mensaje. Esta carpeta se creará si todavía no existe.

Creación de archivos de mensaje

  1. Abra la paleta de comandos pulsando Ctrl+Mayús+P (Windows/Linux) / Comando+Mayús+P (Mac).

  2. Escribe "prompt" y selecciona Chat: Create Prompt.

  3. Escribe un nombre para el archivo de indicación, sin incluir la extensión del nombre de archivo .prompt.md. El nombre puede contener caracteres alfanuméricos y espacios, y debe describir el propósito de la información del mensaje que contendrá el archivo.

  4. Escriba las instrucciones del mensaje en el formato Markdown.

    Puedes hacer referencia a otros archivos del área de trabajo mediante vínculos de Markdown; por ejemplo, [index](../../web/index.ts), o bien mediante la sintaxis #file:../../web/index.ts. Las rutas de acceso son relativas al archivo de solicitud. Hacer referencia a otros archivos te permite proporcionar contexto adicional, como especificaciones de API o documentación del producto.

Uso de los archivos de indicación

  1. En la parte inferior de la Chat de Copiloto vista, haga clic en el icono Asociar contexto ().

  2. En el menú desplegable, haz clic en Prompt... y elige el archivo de mensaje que quieras usar.

  3. Opcionalmente, adjunta archivos adicionales, incluidos los de mensaje, para proporcionar más contexto.

  4. Opcionalmente, escribe información adicional en el cuadro del mensaje de chat.

    Si necesitas hacerlo o no depende del contenido del aviso que estás usando.

  5. Envía el mensaje de chat.

Para obtener más información sobre archivos de indicaciones, consulte la documentación en Uso de archivos de indicaciones en Visual Studio CodeVisual Studio Code.

Lectura adicional

Esta versión de este artículo es para usar instrucciones personalizadas del repositorio y solicitar archivos en Visual Studio. Haz clic en las pestañas anteriores para obtener instrucciones sobre cómo usar instrucciones personalizadas en otros entornos.

Introducción

Las instrucciones personalizadas de repositorio te permiten proporcionar a Copilot instrucciones y preferencias específicas del repositorio. Para más información, consulta Acerca de la personalización de las respuestas de GitHub Copilot.

Requisitos previos para las instrucciones personalizadas del repositorio

Creación de instrucciones personalizadas

          Visual Studio admite dos tipos de instrucciones personalizadas. Para más información sobre qué GitHub Copilot características admiten estos tipos de instrucciones, consulte [AUTOTITLE](/copilot/concepts/prompting/response-customization?tool=visualstudio#support-for-repository-custom-instructions-2).

  • 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.md en el directorio .github del repositorio. Consulta Creación de instrucciones personalizadas para todo el 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.

    Estos se especifican en uno o más NAME.instructions.md archivos dentro o debajo del directorio .github/instructions del repositorio. Consulta Crear instrucciones personalizadas específicas de la ruta.

    Si la ruta de acceso especificada coincide con un archivo en el que Copilot se está trabajando y también existe un archivo de instrucciones personalizadas para todo el repositorio, se usan las instrucciones de ambos archivos.

Creación de instrucciones personalizadas para todo el repositorio

  1. En la raíz del repositorio, cree un archivo denominado .github/copilot-instructions.md.

    Crea el directorio .github si no existe todavía.

  2. Agrega instrucciones de lenguaje natural al archivo en formato Markdown.

    Se ignora el espacio en blanco entre las instrucciones, por lo que estas pueden escribirse como un solo párrafo, cada una en una nueva línea o separadas por líneas en blanco para mejorar la legibilidad.

Creación de instrucciones personalizadas específicas de la ruta de acceso

  1. Crea el directorio .github/instructions si no existe todavía.

  2. Opcionalmente, cree subdirectorios de .github/instructions para organizar sus archivos de instrucciones.

  3. Crea uno o varios archivos NAME.instructions.md, donde NAME indica el propósito de las instrucciones. El nombre de archivo debe terminar con .instructions.md.

  4. Al principio del archivo, crea un bloque de texto preliminar que contenga la palabra clave applyTo. Usa la sintaxis global para especificar a qué archivos o directorios se aplican las instrucciones.

    Por ejemplo:

    ---
applyTo: "app/models/**/*.rb"
---

    Puedes especificar varios patrones si los separas con comas. Por ejemplo, para aplicar las instrucciones a todos los archivos TypeScript del repositorio, podrías usar el siguiente bloque de texto preliminar:

    ---
applyTo: "**/*.ts,**/*.tsx"
---

    Ejemplos de Glob:

    • * - coincidirá con todos los archivos del directorio actual.
    • ** o **/* - coincidirán con todos los archivos en todos los directorios.
    • *.py : coincidirá con todos los .py archivos del directorio actual.
    • **/*.py : coincidirá recursivamente con todos los .py archivos de todos los directorios.
    • src/*.py : coincidirá con todos los .py archivos del src directorio. Por ejemplo, src/foo.py y src/bar.pypero nosrc/foo/bar.py.
    • src/**/*.py : coincidirá recursivamente con todos los .py archivos del src directorio. Por ejemplo, src/foo.py, src/foo/bar.py y src/foo/bar/baz.py.
    • **/subdir/**/*.py : coincidirá recursivamente con todos los .py archivos de cualquier subdir directorio a cualquier profundidad. Por ejemplo, subdir/foo.py, subdir/nested/bar.py, parent/subdir/baz.pyy deep/parent/subdir/nested/qux.py, pero nofoo.py en una ruta de acceso que no contiene un subdir directorio.

  5. De forma opcional, para evitar que el archivo sea usado por agente en la nube de Copilot o revisión de código Copilot, agregue la palabra clave excludeAgent al bloque frontmatter. Use "code-review" o "cloud-agent".

    Por ejemplo, el archivo siguiente solo lo leerá agente en la nube de Copilot.

    ---
applyTo: "**"
excludeAgent: "code-review"
---

    Si la excludeAgent palabra clave no se incluye en el bloque de front matter, tanto revisión de código Copilot como agente en la nube de Copilot usarán tus instrucciones.

  6. Agrega las instrucciones personalizadas en lenguaje natural mediante el formato Markdown. Se ignora el espacio en blanco entre las instrucciones, por lo que estas pueden escribirse como un solo párrafo, cada una en una nueva línea o separadas por líneas en blanco para mejorar la legibilidad.

¿Has agregado correctamente un archivo de instrucciones personalizado al repositorio?

          <a href="https://docs.github.io/success-test/yes.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline">
          <span>Sí</span></a><a href="https://docs.github.io/success-test/no.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline"><span>No</span></a>

Instrucciones personalizadas en uso

Las instrucciones de los archivos están disponibles para su uso por Copilot tan pronto como guarde el/los archivo(s). Las instrucciones se agregan automáticamente a las solicitudes que envíe a Copilot.

Las instrucciones personalizadas no aparecen en la vista de chat ni en el chat en línea, pero puedes comprobar que Copilot las está usando si examinas la lista de referencias de una respuesta en la vista de chat. Si se han agregado instrucciones personalizadas a la solicitud que se ha enviado al modelo, el archivo .github/copilot-instructions.md aparece como referencia. Puedes hacer clic en la referencia para abrir el archivo.

Captura de pantalla del menú emergente References, en la que se muestra el archivo "copilot-instructions.md" resaltado con un contorno naranja oscuro.

Habilitación o deshabilitación de instrucciones personalizadas del repositorio

Puedes elegir si quieres que Copilot use instrucciones personalizadas basadas en repositorios o no.

Habilitación o deshabilitación de instrucciones personalizadas para Chat de Copiloto

Las instrucciones personalizadas están habilitadas para Chat de Copiloto de manera predeterminada, pero puedes deshabilitarlas o volver a habilitarlas en cualquier momento. Esto se aplica a tu propio uso de Chat de Copiloto y no afecta a otros usuarios.

  1. En la barra de Visual Studio menús, en Herramientas, haga clic en Opciones.

    Captura de pantalla de la barra de menús Visual Studio. El menú "Herramientas" se expande y el elemento "Opciones" aparece resaltado con un contorno naranja.

  2. En el cuadro de diálogo "Opciones", escriba custom instructions en el cuadro de búsqueda y, a continuación, haga clic en Copilot.

  3. Selecciona o deselecciona la casilla de verificación para Enable custom instructions to be loaded from .github/copilot-instructions.md files and added to requests.

    Captura de pantalla del cuadro de diálogo Opciones de Visual Studio que muestra la casilla "Habilitar instrucciones personalizadas" seleccionada.

Habilitación o deshabilitación de instrucciones personalizadas para revisión de código Copilot

Las instrucciones personalizadas están habilitadas para revisión de código Copilot de manera predeterminada, pero puedes deshabilitarlas o volver a habilitarlas en la configuración del repositorio en GitHub.com. Esto se aplica al uso por parte de Copilot de instrucciones personalizadas para todas las revisiones de código que realiza en este repositorio.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. Debajo del nombre del repositorio, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

    Captura de pantalla de un encabezado de repositorio en el que se muestran las pestañas. La pestaña "Configuración" está resaltada con un contorno naranja oscuro.

  3. En la sección "Code & automation" de la barra lateral, haz clic en Copilot y, a continuación, Code review.

  4. Activa o desactiva la opción "Use custom instructions when reviewing pull requests".

Uso de los archivos de indicación

Nota:

Los archivos de indicación te permiten crear y compartir instrucciones de indicación reutilizables con más contexto. Un archivo de sugerencias es un archivo Markdown, almacenado en el área de trabajo, que imita el formato existente de las sugerencias de escritura en Chat de Copiloto (por ejemplo, Rewrite #file:x.ts). Puedes tener varios archivos de mensaje en el área de trabajo y cada uno define un mensaje para un propósito diferente.

Creación de archivos de mensaje

  1. Agregue un archivo prompt, incluyendo la extensión de nombre de archivo .prompt.md dentro de la carpeta .github/prompts en la raíz del repositorio. El nombre puede contener caracteres alfanuméricos y espacios, y debe describir el propósito de la información del mensaje que contendrá el archivo.

  2. Escriba las instrucciones del mensaje en el formato Markdown.

    Puedes hacer referencia a otros archivos del área de trabajo mediante vínculos de Markdown; por ejemplo, [index](../../web/index.ts), o bien mediante la sintaxis #file:'../../web/index.ts'. Las rutas de acceso son relativas al archivo de mensaje. Hacer referencia a otros archivos te permite proporcionar contexto adicional, como especificaciones de API o documentación del producto.

Para obtener más información sobre los archivos de solicitud, consulte Uso de archivos de solicitud en Visual Studio la Visual Studio documentación.

Lectura adicional

Esta versión de este artículo sirve para usar instrucciones personalizadas del repositorio en los IDE de JetBrains. Haz clic en las pestañas anteriores para obtener instrucciones sobre cómo usar instrucciones personalizadas en otros entornos.

Introducción

Las instrucciones personalizadas de repositorio te permiten proporcionar a Copilot instrucciones y preferencias específicas del repositorio. Para más información, consulta Acerca de la personalización de las respuestas de GitHub Copilot.

Requisitos previos para las instrucciones personalizadas del repositorio

  • Debes tener un archivo de instrucciones personalizado (consulta las instrucciones a continuación).

  • La versión más reciente de la Copilot extensión debe estar instalada en el IDE de JetBrains.

Creación de instrucciones personalizadas

Los IDE de JetBrains admiten un único archivo de instrucciones .github/copilot-instructions.md personalizado almacenado en el repositorio y un archivo de global-copilot-instructions.md almacenado localmente.

Puede crear el archivo en el .github/copilot-instructions.md repositorio mediante la Copilot página de configuración o puede crear el archivo manualmente.

Se ignora el espacio en blanco entre las instrucciones, por lo que estas pueden escribirse como un solo párrafo, cada una en una nueva línea o separadas por líneas en blanco para mejorar la legibilidad.

Usar la página de configuración

  1. En el IDE de JetBrains, haz clic en el menú Archivo (Windows) o en el nombre de la aplicación en la barra de menús (macOS) y, a continuación, haz clic en Configuración.

           1. En la barra lateral izquierda, haga clic en **Herramientas** y después en **GitHub Copilot**., a continuación, haga clic en **Personalizaciones**.

  2. En "Copilot Instrucciones", haga clic en Área de trabajo o Global para elegir si las instrucciones personalizadas se aplican al área de trabajo actual o a todas las áreas de trabajo.

Crear manualmente un archivo de instrucciones personalizadas del área de trabajo

  1. En la raíz del repositorio, cree un archivo denominado .github/copilot-instructions.md.

    Crea el directorio .github si no existe todavía.

  2. Agrega instrucciones de lenguaje natural al archivo en formato Markdown.

Una vez guardado, estas instrucciones se aplicarán al área de trabajo actual en los IDE de JetBrains que abra con Copilot habilitado.

Crear manualmente un archivo global de instrucciones personalizadas

Para aplicar las mismas instrucciones en todas las áreas de trabajo de los IDE de JetBrains, puedes crear un archivo global de instrucciones personalizadas en el equipo local.

  1. Abre el explorador de archivos o el terminal.

  2. Ve a la ubicación adecuada del sistema operativo:

    • macOS: /Users/YOUR-USERNAME/.config/github-copilot/intellij/
    • Windows: C:\Users\YOUR-USERNAME\AppData\Local\github-copilot\intellij\

  3. En ese directorio, crea un archivo denominado global-copilot-instructions.md.

  4. Agrega las instrucciones personalizadas en lenguaje natural mediante el formato Markdown.

Una vez guardadas, estas instrucciones se aplicarán globalmente en todas las áreas de trabajo de los IDE de JetBrains que abra con Copilot habilitado.

¿Has agregado correctamente un archivo de instrucciones personalizado al repositorio?

          <a href="https://docs.github.io/success-test/yes.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline">
          <span>Sí</span></a><a href="https://docs.github.io/success-test/no.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline"><span>No</span></a>

Instrucciones personalizadas en uso

Las instrucciones de los archivos están disponibles para su uso por Copilot tan pronto como guarde el/los archivo(s). Las instrucciones se agregan automáticamente a las solicitudes que envíe a Copilot.

Las instrucciones personalizadas no aparecen en la vista de chat ni en el chat en línea, pero puedes comprobar que Copilot las está usando si examinas la lista de referencias de una respuesta en la vista de chat. Si se han agregado instrucciones personalizadas a la solicitud que se ha enviado al modelo, el archivo .github/copilot-instructions.md aparece como referencia. Puedes hacer clic en la referencia para abrir el archivo.

Uso de los archivos de indicación

Nota:

Los archivos de indicación te permiten crear y compartir instrucciones de indicación reutilizables con más contexto. Un archivo de sugerencias es un archivo Markdown, almacenado en el área de trabajo, que imita el formato existente de las sugerencias de escritura en Chat de Copiloto (por ejemplo, Rewrite #file:x.ts). Puedes tener varios archivos de mensaje en el área de trabajo y cada uno define un mensaje para un propósito diferente.

Al escribir instrucciones de aviso, puede hacer referencia a otros archivos del área de trabajo mediante vínculos de Markdown (por ejemplo, [index](../../web/index.ts)) o mediante la #file:../../web/index.ts sintaxis . Las rutas de acceso son relativas al archivo de mensaje. Hacer referencia a otros archivos te permite proporcionar contexto adicional, como especificaciones de API o documentación del producto.

Una vez guardados los archivos de comandos, sus instrucciones se aplicarán en el espacio de trabajo actual en las IDE de JetBrains que abras con Copilot habilitado.

Creación de archivos de comandos usando la línea de comandos

  1. Cree el .github/prompts directorio si aún no existe en el área de trabajo. Este directorio será la ubicación de los archivos de indicaciones.
  2. Cree un archivo de solicitud en el directorio .github/prompts. El nombre del archivo de mensaje puede contener caracteres alfanuméricos y espacios, y debe describir el propósito de la información que el archivo contendrá. El nombre de archivo debe terminar con la .prompt.md extensión de nombre de archivo, por ejemplo TESTPROMPT.prompt.md.
  3. Escriba las instrucciones del aviso mediante el formato Markdown y guarde el archivo.

Creación de archivos de instrucciones mediante la página de ajustes

  1. En el IDE de JetBrains, haz clic en el menú Archivo (Windows) o en el nombre de la aplicación en la barra de menús (macOS) y, a continuación, haz clic en Configuración.
  2. En Herramientas, en GitHub Copilot, haga clic en Editar configuración.
  3. En "Categorías de configuración", haga clic en Personalizaciones.
  4. En "Prompt Files", haga clic en Workspace (Área de trabajo) para crear un archivo de aviso en el área de trabajo.
  5. Escribe un nombre para el archivo de solicitud, excluyendo la extensión de nombre de archivo .prompt.md. El nombre del archivo de solicitud puede contener caracteres y espacios alfanuméricos y debe describir el propósito de la información del aviso que contendrá el archivo.
  6. Haga clic en Aceptar para guardar el nombre del archivo del aviso.
  7. Escriba las instrucciones en formato Markdown y guarde el archivo.

Uso de los archivos de indicación

  1. En el cuadro de entrada del chat, escriba / seguido del nombre del archivo de solicitud. Por ejemplo: /TESTPROMPT.

  2. Opcionalmente, adjunte archivos adicionales para proporcionar más contexto.

  3. Opcionalmente, escribe información adicional en el cuadro del mensaje de chat.

    Que necesites hacerlo o no depende del contenido del aviso que estás utilizando.

  4. Envía el mensaje de chat.

Lectura adicional

Esta versión de este artículo es para usar instrucciones personalizadas del repositorio en Xcode. Haz clic en las pestañas anteriores para obtener instrucciones sobre cómo usar instrucciones personalizadas en otros entornos.

Introducción

Las instrucciones personalizadas de repositorio te permiten proporcionar a Copilot instrucciones y preferencias específicas del repositorio. Para más información, consulta Acerca de la personalización de las respuestas de GitHub Copilot.

Requisitos previos para las instrucciones personalizadas del repositorio

  • Debes tener un archivo de instrucciones personalizado (consulta las instrucciones a continuación).

  • La versión más reciente de la Copilot extensión debe instalarse en Xcode.

Creación de instrucciones personalizadas

Xcode admite un único archivo de instrucciones .github/copilot-instructions.md personalizado almacenado en el repositorio.

Puede crear un archivo de instrucciones personalizado en el repositorio a través de la Copilot página de configuración.

Se ignora el espacio en blanco entre las instrucciones, por lo que estas pueden escribirse como un solo párrafo, cada una en una nueva línea o separadas por líneas en blanco para mejorar la legibilidad.

  1. Abra la aplicación GitHub Copilot de Xcode.
  2. En la parte superior de la ventana de la aplicación, en Settings, haz clic en Advanced.
  3. A la derecha de "Custom Instructions", haz clic en Current Workspace o Global para elegir si las instrucciones personalizadas se aplican al área de trabajo actual o a todas las áreas de trabajo.

¿Has agregado correctamente un archivo de instrucciones personalizado al repositorio?

          <a href="https://docs.github.io/success-test/yes.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline">
          <span>Sí</span></a><a href="https://docs.github.io/success-test/no.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline"><span>No</span></a>

Instrucciones personalizadas en uso

Las instrucciones de los archivos están disponibles para su uso por Copilot tan pronto como guarde el/los archivo(s). Las instrucciones se agregan automáticamente a las solicitudes que envíe a Copilot.

Las instrucciones personalizadas no aparecen en la vista de chat ni en el chat en línea, pero puedes comprobar que Copilot las está usando si examinas la lista de referencias de una respuesta en la vista de chat. Si se han agregado instrucciones personalizadas a la solicitud que se ha enviado al modelo, el archivo .github/copilot-instructions.md aparece como referencia. Puedes hacer clic en la referencia para abrir el archivo.

Lectura adicional

Nota:

Esta característica está actualmente en versión preliminar pública y está sujeta a cambios.

Esta versión de este artículo es para usar instrucciones personalizadas de repositorio en Eclipse. Haz clic en las pestañas anteriores para obtener instrucciones sobre cómo usar instrucciones personalizadas en otros entornos.

Introducción

Las instrucciones personalizadas de repositorio te permiten proporcionar a Copilot instrucciones y preferencias específicas del repositorio. Para más información, consulta Acerca de la personalización de las respuestas de GitHub Copilot.

Requisitos previos para las instrucciones personalizadas del repositorio

  • Debes tener un archivo de instrucciones personalizado (consulta las instrucciones a continuación).

  • La versión más reciente de la Copilot extensión debe estar instalada en Eclipse.

Creación de instrucciones personalizadas

Eclipse admite dos tipos de instrucciones personalizadas del repositorio: instrucciones personalizadas de área de trabajo y de proyecto.

Para crear un archivo de instrucciones personalizado del área de trabajo, puede usar la página de configuración Copilot. Para crear un archivo de instrucciones personalizadas de proyecto, puedes crear el archivo manualmente en el directorio del proyecto.

Se ignora el espacio en blanco entre las instrucciones, por lo que estas pueden escribirse como un solo párrafo, cada una en una nueva línea o separadas por líneas en blanco para mejorar la legibilidad.

Creación de un archivo de instrucciones personalizadas de área de trabajo

  1. Para abrir el Chat de Copiloto panel, haga clic en el Copilot icono () en la barra de estado de la parte inferior de Eclipse.
  2. En el menú, selecciona "Edit preferences".
  3. En el panel izquierdo, expanda GitHub Copilot y haga clic en Instrucciones personalizadas.
  4. Selecciona Enable workspace instructions.
  5. En la sección "Área de trabajo", en "Establecer instrucciones personalizadas para guiar Copilotlas sugerencias de código de esta área de trabajo", agregue instrucciones de lenguaje natural al archivo, en formato Markdown.

Creación de un archivo de instrucciones personalizadas de proyecto

  1. En la raíz del directorio del proyecto, crea un archivo con el nombre .github/copilot-instructions.md.
  2. Agrega las instrucciones personalizadas en lenguaje natural mediante el formato Markdown.

Una vez guardado, estas instrucciones se aplicarán al proyecto actual en Eclipse que abra con Copilot habilitado.

¿Has agregado correctamente un archivo de instrucciones personalizado al repositorio?

          <a href="https://docs.github.io/success-test/yes.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline">
          <span>Sí</span></a><a href="https://docs.github.io/success-test/no.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline"><span>No</span></a>

Instrucciones personalizadas en uso

Las instrucciones de los archivos están disponibles para su uso por Copilot tan pronto como guarde el/los archivo(s). Las instrucciones se agregan automáticamente a las solicitudes que envíe a Copilot.

Lectura adicional