Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/es-es/real-world-development/app/10-review.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,15 @@ title: "Lección 10 - Repaso y pasos siguientes"
description: "Repasa el flujo de la aplicación, los dos hitos de PR, los ejercicios de lienzo y las prácticas de calidad reutilizables; después, explora otros recursos."
authors:
- geektrainer
lastUpdated: 2026-07-09
lastUpdated: 2026-09-29
---

Has utilizado la aplicación GitHub Copilot durante un flujo continuo de Tailspin Toys. Has aprendido a:

- conectar un repositorio, explorar el espacio de trabajo y la lista de trabajo pendiente inicial de la aplicación y probar un chat rápido.
- iniciar una sesión específica de valoraciones por estrellas, revisar el resultado en un lienzo de navegador y combinar manualmente tu primera solicitud de incorporación de cambios (PR).
- partir de la incidencia de filtrado, definir el enfoque en modo **Plan**, desarrollarlo en modo **Autopilot** y revisarlo en modo **Interactive**.
- orientar al agente con instrucciones personalizadas y después personalizar una habilidad existente y utilizarla para ejecutar lint, pruebas unitarias, pruebas de un extremo a otro y comprobaciones de tipos.
- orientar al agente con instrucciones personalizadas y después personalizar la habilidad `quality-checks` existente y utilizarla para ejecutar pruebas unitarias, lint y comprobaciones de tipos.
- probar el trabajo con el servidor MCP de Playwright en un navegador real.
- crear y seleccionar un agente personalizado QA para evaluar requisitos, cobertura, resultados de scripts de la habilidad y pruebas de observación del navegador.
- revisar el cambio completo de filtrado y autorizar **Agent Merge** para la segunda PR.
Expand All @@ -28,7 +28,7 @@ Desde la planificación del filtrado hasta la apertura de su PR, utilizaste la m

## Distintos tipos de verificación

Comprobaste el código de varias formas: pruebas automatizadas, tu propia inspección en el navegador y la exploración de Copilot en el navegador mediante MCP. La habilidad quality-checks ejecutó las comprobaciones del proyecto y presentó los resultados con el nuevo formato. QA reunió esos resultados junto con una revisión de los requisitos y la cobertura de pruebas antes de la PR.
Comprobaste el código de varias formas: pruebas automatizadas, tu propia inspección en el navegador y la exploración de Copilot en el navegador mediante MCP. La habilidad `quality-checks` ejecutó pruebas unitarias, lint y comprobaciones de tipos y presentó los resultados con el nuevo formato. QA reunió esos resultados junto con una revisión de los requisitos y la cobertura de pruebas antes de la PR.

Las pruebas añadidas deben cubrir carencias reales; una ejecución QA que no necesita pruebas nuevas puede ser correcta. Las herramientas ausentes, las comprobaciones omitidas y los fallos son bloqueos visibles, no resultados satisfactorios. Revisa el código y las pruebas de verificación antes de autorizar la combinación y actualiza las afectadas después de los cambios.

Expand Down
29 changes: 13 additions & 16 deletions docs/es-es/real-world-development/app/5-agent-skills.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: "Lección 5 - Personalizar y utilizar una habilidad quality-checks"
description: "Explora la habilidad quality-checks existente, personaliza el formato de su informe y utilízala para validar el filtrado."
authors:
- geektrainer
lastUpdated: 2026-09-11
lastUpdated: 2026-09-29
---

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)?
Expand All @@ -12,13 +12,13 @@ Para este tipo de tareas, las **habilidades de agente** son la mejor opción. La

En esta lección:

- explorarás la habilidad `quality-checks` existente y sus scripts incluidos.
- 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 dispone de un conjunto de pruebas unitarias y de un extremo a otro que siempre deben ejecutarse antes de crear cualquier solicitud de incorporación de cambios (PR). Como cabe esperar, es importante garantizar que se ejecuten de forma correcta y coherente. El equipo ya ha creado una habilidad de agente para ejecutar estas pruebas, pero quiere mejorar la salida para facilitar su lectura.
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

Expand All @@ -38,32 +38,29 @@ Las habilidades pueden residir en la carpeta `.github/skills` de un proyecto par

## Ejecutar la habilidad antes de realizar un cambio

Las habilidades se pueden invocar directamente mediante un comando con barra diagonal (`/`) o con lenguaje natural. La descripción destaca que la habilidad debe utilizarse cuando se solicite ejecutar pruebas o lint. Ejecutemos la habilidad pidiendo a Copilot que ejecute las pruebas.
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 pedir a Copilot que ejecute las pruebas y el linter, lo que invocará la habilidad:
2. Utiliza la indicación siguiente para invocar la habilidad:

```plaintext
Run the tests and linters.
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 muestre las pruebas ejecutadas, las tasas de éxito y error y cuánto han tardado. Actualicemos la habilidad para que Copilot genere ese 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. Busca al final del archivo el encabezado **Results output formatting**.
4. Justo debajo, añade lo siguiente para que los resultados se muestren según nuestras especificaciones:
3. Añade la siguiente sección al final del archivo:

```markdown
Upon completion of all tests, generate a report that provides a quick overview of both success and failure of the tests, and how long they took to ran. In particular, we need sections for:
## Results output formatting

- Unit tests, total number of tests, number succeeded, number failed, a percentage thereof, and the amount of time testing took.
- End to end tests, total number of tests, number succeeded, number failed, a percentage thereof, and the amount of time testing took.
- Linting, number of lines scanned, number of violations, and the percentage of lines of code that meet the linting requirements.
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.
Expand All @@ -73,10 +70,10 @@ El archivo se guardará automáticamente.
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 pedir a Copilot que ejecute las pruebas y el linter, lo que invocará la habilidad:
2. Utiliza la indicación siguiente para invocar la habilidad:

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

3. Observa el informe final.
Expand All @@ -85,7 +82,7 @@ Una vez realizado el cambio, veamos cómo funciona. Utilizaremos exactamente la

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

- has explorado la habilidad `quality-checks` y sus scripts incluidos.
- 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.

Expand Down
6 changes: 3 additions & 3 deletions docs/ja-jp/real-world-development/app/10-review.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,15 @@ title: "レッスン 10 - 振り返りと次のステップ"
description: "App のワークフロー、2つの PR マイルストーン、キャンバス演習、再利用可能な品質プラクティスを振り返り、追加のリソースを確認します。"
authors:
- geektrainer
lastUpdated: 2026-07-09
lastUpdated: 2026-09-29
---

GitHub Copilot app を使用して、Tailspin Toys の1つの連続したワークフローに取り組みました。実施した内容は次のとおりです。

- リポジトリを接続し、アプリのワークスペースと用意されたバックログを確認して、クイックチャットを試した。
- 星評価に対象を絞ったセッションを開始し、ブラウザーキャンバスで結果をレビューして、最初の pull request (PR) を手動でマージした。
- フィルター機能の Issue から開始し、**Plan** モードでアプローチを定義して、**Autopilot** モードで構築し、**Interactive** モードでレビューした。
- カスタム指示でエージェントをガイドし、既存の `quality-checks` スキルをカスタマイズして、lint、単体テスト、E2E テスト、型チェックを実行した。
- カスタム指示でエージェントをガイドし、既存の `quality-checks` スキルをカスタマイズして、単体テスト、lint、型チェックを実行した。
- Playwright Model Context Protocol (MCP) server を追加し、実際のブラウザーでフィルター機能を確認した。
- 要件、カバレッジ、スキルの結果、ブラウザーでの証拠を評価する品質保証 (QA) カスタムエージェントを作成して選択した。
- フィルター機能の変更全体をレビューし、2つ目の PR に **Agent Merge** を承認した。
Expand All @@ -28,7 +28,7 @@ GitHub Copilot app を使用して、Tailspin Toys の1つの連続したワー

## 検証方法の違い

自動テスト、手動のブラウザー確認、MCP を使った Copilot によるブラウザーでの調査など、複数の方法でコードを検証しました。quality-checks スキルはプロジェクトのチェックを実行し、新しい形式で結果を報告しました。QA では、PR の前にこれらの結果を要件とテストカバレッジのレビューと組み合わせました。
自動テスト、手動のブラウザー確認、MCP を使った Copilot によるブラウザーでの調査など、複数の方法でコードを検証しました。`quality-checks` スキルは単体テスト、lint、型チェックを実行し、新しい形式で結果を報告しました。QA では、PR の前にこれらの結果を要件とテストカバレッジのレビューと組み合わせました。

追加するテストは実際の不足を補うものにします。新しいテストが不要な QA 実行も正しい結果になり得ます。ツールの不足、スキップされたチェック、失敗は明示すべき阻害要因であり、成功ではありません。マージを承認する前にコードと証拠をレビューし、変更後は関連する証拠を更新してください。

Expand Down
31 changes: 14 additions & 17 deletions docs/ja-jp/real-world-development/app/5-agent-skills.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: "レッスン 5 - quality-checks スキルのカスタマイズと使用"
description: "既存の quality-checks スキルを確認し、報告形式をカスタマイズして、フィルター機能の検証に使用します。"
authors:
- geektrainer
lastUpdated: 2026-09-11
lastUpdated: 2026-09-29
---

コードを書く作業には、単にコードを書く以上のことが含まれます。コードが動作することは手動で検証し、指示ファイルを使用して標準に従っていることも確認しました。しかし、テストや lint、継続的インテグレーション (CI) のその他の作業はどうでしょうか。
Expand All @@ -12,13 +12,13 @@ lastUpdated: 2026-09-11

このレッスンでは、次の内容を学習します。

- 既存の `quality-checks` スキルと同梱のスクリプトを確認する。
- 既存の `quality-checks` スキルを確認する。
- 結果の報告形式をカスタマイズする。
- スキルを実行し、出力をレビューする。

## シナリオ

Tailspin Toys には、pull request (PR) を作成する前に必ず実行する必要がある単体テストと E2E テストがあります。これらを正しく一貫して実行することが重要です。チームはすでにテスト実行用のエージェントスキルを作成していますが、読みやすい出力に改善したいと考えています。
Tailspin Toys は、単体テスト、lint、型チェックに `quality-checks` スキルを使用します。チームは、結果を読みやすくするためにレポートを改善したいと考えています。

## 指示、スクリプト、リソース

Expand All @@ -31,7 +31,7 @@ Tailspin Toys には、pull request (PR) を作成する前に必ず実行する

## スキルを確認する

Tailspin Toys チームがテストと linter の実行用に作成した `quality-checks` というスキルを確認します。
Tailspin Toys チームが単体テスト、lint、型チェックの実行用に作成した `quality-checks` というスキルを確認します。

1. **Files** キャンバスをまだ開いていない場合は、レビューパネルで **+**、**File** の順に選択します。
2. `.github/skills/quality-checks/SKILL.md` を検索します。
Expand All @@ -40,32 +40,29 @@ Tailspin Toys チームがテストと linter の実行用に作成した `quali

## 変更前にスキルを実行する

スキルはスラッシュ (`/`) コマンドで直接呼び出すことも、自然言語で呼び出すこともできます。このスキルの説明には、テストまたは lint の実行を依頼されたときに使用することが示されています。Copilot にテストの実行を依頼して、スキルを実行しましょう。
スキルはスラッシュ (`/`) コマンドで直接呼び出すことも、自然言語で呼び出すこともできます。スキルの 3 種類のチェックを実行するよう Copilot に依頼しましょう。

1. モードのドロップダウンから **Interactive** を選択し、Copilot が Interactive モードになっていることを確認します。
2. 次のプロンプトを使って Copilot にテストと linter の実行を依頼し、スキルを呼び出します。
2. 次のプロンプトを使ってスキルを呼び出します。

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

3. 最後に表示されるレポートを確認します。

## 報告形式をカスタマイズする

実行したテスト、成功率と失敗率、実行にかかった時間を示す、よりわかりやすいレポートが必要です。Copilot がそのレポートを作成するようにスキルを更新しましょう。
何を実行したか、成功したか、ツールが実際に何を報告したかがわかる、よりよいレポートが必要です。そのレポートを作成するようスキルを更新しましょう。

1. **Files** キャンバスに戻ります。
2. まだ開いていない場合は、`.github/skills/quality-checks/SKILL.md` を開きます。
3. ファイルの末尾にある **Results output formatting** という見出しを見つけます。
4. その見出しのすぐ下に次の内容を追加し、指定した形式で結果を表示するようにします。
3. ファイルの末尾に次のセクションを追加します。

```markdown
Upon completion of all tests, generate a report that provides a quick overview of both success and failure of the tests, and how long they took to ran. In particular, we need sections for:
## Results output formatting

- Unit tests, total number of tests, number succeeded, number failed, a percentage thereof, and the amount of time testing took.
- End to end tests, total number of tests, number succeeded, number failed, a percentage thereof, and the amount of time testing took.
- Linting, number of lines scanned, number of violations, and the percentage of lines of code that meet the linting requirements.
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.
```

ファイルは自動的に保存されます。
Expand All @@ -75,10 +72,10 @@ Tailspin Toys チームがテストと linter の実行用に作成した `quali
変更したスキルを実際に試してみましょう。先ほどとまったく同じプロンプトを使用します。

1. モードのドロップダウンから **Interactive** を選択し、Copilot が Interactive モードになっていることを確認します。
2. 次のプロンプトを使って Copilot にテストと linter の実行を依頼し、スキルを呼び出します。
2. 次のプロンプトを使ってスキルを呼び出します。

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

3. 最後に表示されるレポートを確認します。
Expand All @@ -87,7 +84,7 @@ Tailspin Toys チームがテストと linter の実行用に作成した `quali

既存のエージェントスキルをカスタマイズして使用しました。このレッスンでは、次の作業を行いました。

- `quality-checks` スキルと同梱のスクリプトを確認した。
- 単体テスト、lint、型チェックを実行する `quality-checks` スキルを確認した。
- 結果の報告形式をカスタマイズした。
- スキルを実行し、出力をレビューした。

Expand Down
Loading
Loading