Ir al contenido
Copilot Workshops

Lección 5 - Personalizar y utilizar una habilidad quality-checks

Escribir código implica mucho más que limitarse a escribirlo. Hemos podido validar manualmente que funciona y hemos utilizado archivos de instrucciones para garantizar que sigue nuestros estándares. Pero ¿qué ocurre con las pruebas, lint y el resto de las tareas de integración continua (CI)?

Para este tipo de tareas, las habilidades de agente son la mejor opción. Las habilidades ayudan a Copilot a comprender cómo ejecutar correctamente operaciones como estas.

En esta lección:

  • explorarás la habilidad quality-checks existente.
  • personalizarás el formato de sus resultados.
  • ejecutarás la habilidad y revisarás su salida.

Escenario

Tailspin Toys utiliza la habilidad quality-checks para las pruebas unitarias, lint y las comprobaciones de tipos. El equipo quiere mejorar el informe para facilitar la lectura de los resultados.

Instrucciones, scripts y recursos

Las habilidades de agente reúnen instrucciones de tareas reutilizables, scripts ejecutables y recursos de apoyo que un agente carga cuando los necesita. En esencia, son una carpeta con el nombre de la habilidad y un archivo Markdown llamado SKILL.md. Este archivo contiene frontmatter con un nombre y una descripción que definen la habilidad, una introducción sobre lo que hace e indicaciones sobre cuándo debe invocarse. La carpeta también puede contener subcarpetas con scripts y otros recursos que utilizará la habilidad.

Una habilidad no necesita carpetas ni archivos adicionales. En nuestro ejemplo, la habilidad ejecutará comandos npm para iniciar las pruebas y los linters, así que no necesitamos archivos auxiliares.

Las habilidades pueden residir en la carpeta .github/skills de un proyecto para convertirse en un recurso del repositorio que el resto del equipo pueda compartir y reutilizar, o en la carpeta raíz de Copilot, que suele ser ~/.copilot/skills.

Explorar la habilidad

  1. Si todavía no tienes abierto un lienzo Files, selecciona + en el panel de revisión y, después, File.
  2. Busca .github/skills/quality-checks/SKILL.md.
  3. Lee name y description al principio. Observa que la descripción ayuda a Copilot a comprender cuándo debe invocar la habilidad.
  4. Lee las instrucciones y observa cómo orientan a Copilot durante el proceso de pruebas y lint.

Ejecutar la habilidad antes de realizar un cambio

Las habilidades se pueden invocar directamente mediante un comando con barra diagonal (/) o con lenguaje natural. Pidamos a Copilot que ejecute las tres comprobaciones de la habilidad.

  1. Selecciona el modo Interactive en el menú desplegable para confirmar que Copilot lo utiliza.

  2. Utiliza la indicación siguiente para invocar la habilidad:

    Run the quality-checks skill for unit tests, lint, and type checks.

  3. Observa el informe final.

Personalizar el informe

Queremos un informe mejor que indique qué se ha ejecutado, si ha tenido éxito y qué han comunicado realmente las herramientas. Actualicemos la habilidad para generar ese informe.

  1. Vuelve al lienzo Files.

  2. Si aún no está abierto, abre .github/skills/quality-checks/SKILL.md.

  3. Añade la siguiente sección al final del archivo:

    ## Results output formatting
    

    Upon completion, report each command that ran and whether it passed, failed, or was blocked. Include test counts, durations, errors, warnings, and other metrics only when the tool reports them. Identify the next action for any failure or blocker, and never describe a skipped or incomplete check as passed.

El archivo se guardará automáticamente.

Ejecutar la habilidad actualizada

Una vez realizado el cambio, veamos cómo funciona. Utilizaremos exactamente la misma indicación que antes.

  1. Selecciona el modo Interactive en el menú desplegable para confirmar que Copilot lo utiliza.

  2. Utiliza la indicación siguiente para invocar la habilidad:

    Run the quality-checks skill for unit tests, lint, and type checks.

  3. Observa el informe final.

Resumen y pasos siguientes

Has personalizado y utilizado una habilidad de agente existente. En esta lección:

  • has explorado la habilidad quality-checks para las pruebas unitarias, lint y las comprobaciones de tipos.
  • has personalizado el formato de sus resultados.
  • has ejecutado la habilidad y revisado su salida.

Este cambio acompañará al filtrado en la PR de la funcionalidad. A continuación, permitirás que Copilot interactúe directamente con el sitio mediante el servidor MCP de Playwright.

Más ejemplos de habilidades

Estos ejemplos de la comunidad son referencias, no tareas adicionales. Revisa sus requisitos previos y su comportamiento antes de adoptarlos:

El ejemplo de contribución original se llama make-repo-contribution; las plantillas antiguas de Tailspin utilizaban otro nombre, make-contribution. Este taller no depende de ninguna de esas habilidades de contribución.