diff --git a/docs/es-es/first-steps/copilot-app/0-prerequisites.md b/docs/es-es/first-steps/copilot-app/0-prerequisites.md index 18923aa8..5ca5a95e 100644 --- a/docs/es-es/first-steps/copilot-app/0-prerequisites.md +++ b/docs/es-es/first-steps/copilot-app/0-prerequisites.md @@ -24,6 +24,9 @@ Necesitas: - un plan activo de Copilot. [Activa Copilot Free o un plan de pago de Copilot][copilot-plans]. Si tu organización ya te proporciona acceso a Copilot, utiliza esa cuenta. - un ordenador con macOS, Windows o Linux. +> [!IMPORTANT] +> Copilot Free no incluye la revisión de código de Copilot para solicitudes de incorporación de cambios. La solicitud de revisión de la [lección 8][review-lesson] requiere [acceso a la revisión de código de Copilot][code-review]. Si no tienes acceso, sigue la alternativa de revisión manual de esa lección. + La aplicación incluye Git, así que no hay nada más que instalar. > [!NOTE] @@ -75,4 +78,6 @@ Has comprobado los requisitos previos, instalado la aplicación, elegido un mode [copilot-plans]: https://github.com/features/copilot/plans [download-app]: https://gh.io/app [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing +[review-lesson]: ../8-review-loop/ +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../1-create-workspace/ diff --git a/docs/es-es/first-steps/copilot-app/3-inspect-and-test.md b/docs/es-es/first-steps/copilot-app/3-inspect-and-test.md index b6f271ed..aab4723c 100644 --- a/docs/es-es/first-steps/copilot-app/3-inspect-and-test.md +++ b/docs/es-es/first-steps/copilot-app/3-inspect-and-test.md @@ -3,7 +3,7 @@ title: "Lección 3 - Inspeccionar la sesión y probar el cuestionario" description: "Lee los detalles de la sesión para confirmar en qué trabaja el agente y ejecuta una prueba de humo en el explorador antes de que Git escriba nada." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Ahora que la sesión ha realizado trabajo real, ya hay algo que inspeccionar. Confirma sobre qué está trabajando el agente y, después, deja que maneje el cuestionario en el explorador integrado e informe de lo que ha ocurrido realmente, no de lo que pretendía hacer. @@ -11,25 +11,28 @@ Ahora que la sesión ha realizado trabajo real, ya hay algo que inspeccionar. Co En esta lección: - leerás el panel de detalles de la sesión. -- comprobarás el proyecto, la ruta, la rama, los cambios y el uso del contexto de la sesión. +- comprobarás el proyecto, la ruta y el uso del contexto de la sesión. - ejecutarás una prueba de humo en el explorador y corregirás los fallos. ## Lee los detalles de la sesión Los detalles de la sesión te indican exactamente en qué trabaja el agente. No necesitas vigilar este panel constantemente, pero todo lo que contiene importa cuando un resultado te sorprende. -![Ilustración del panel de detalles de la sesión de la aplicación Copilot para la sesión de creación de Space Quiz. Muestra la rama main desde origin/main, la ruta, el proyecto, el nombre y el ID de la sesión, el agente, un archivo modificado, los recuentos de tokens, un uso del contexto del 27 %, el gasto de la sesión y opciones para habilitar el control remoto, cambiar el nombre, ver información, compartir como gist secreto o archivar la sesión.](../../../_images/first-steps-app-session-details.svg) +En este momento, Space Quiz sigue siendo una carpeta local, no un repositorio de Git. Comprueba el proyecto, la ruta y el uso del contexto. Después de [publicar el proyecto en la lección 5][publish-lesson], las sesiones vinculadas a Git muestran detalles adicionales, como la rama y **Changes**. -El panel muestra dónde se realiza el trabajo, qué ha cambiado y cuánto se ha llenado la ventana de contexto. No hay ninguna fila de modelo, porque eliges el modelo para cada solicitud en el cuadro de redacción. +La ilustración siguiente muestra una sesión posterior vinculada a Git. Los campos de rama y **Changes** todavía no están disponibles en tu sesión de carpeta local. -1. Confirma que **project**, **path** y **branch** corresponden al proyecto, la ruta y la rama que crees estar editando. -2. Lee **Changes** para ver si esta sesión ha modificado algo. -3. Comprueba **context usage**. A medida que aumenta, al agente le queda menos espacio para tu tarea, y esa es la señal para iniciar una sesión nueva. +![Ilustración del panel de detalles de la aplicación Copilot para una sesión de Space Quiz vinculada a Git. Muestra la rama main desde origin/main, la ruta, el proyecto, el nombre y el ID de la sesión, el agente, un archivo modificado, los recuentos de tokens, un uso del contexto del 27 %, el gasto de la sesión y opciones para habilitar el control remoto, cambiar el nombre, ver información, compartir como gist secreto o archivar la sesión.](../../../_images/first-steps-app-session-details.svg) + +El panel muestra dónde se realiza el trabajo y cuánto se ha llenado la ventana de contexto. No hay ninguna fila de modelo, porque eliges el modelo para cada solicitud en el cuadro de redacción. + +1. Confirma que **project** y **path** corresponden al proyecto y la ruta que crees estar editando. +2. Comprueba **context usage**. A medida que aumenta, al agente le queda menos espacio para tu tarea, y esa es la señal para iniciar una sesión nueva. > [!TIP] > **La mayoría de los malos resultados son problemas de contexto** > -> Una rama incorrecta, una carpeta equivocada o una ventana de contexto casi llena explican muchas más sorpresas que un mal prompt. +> Una carpeta equivocada o una ventana de contexto casi llena explican muchas más sorpresas que un mal prompt. ## Prueba antes de que Git escriba nada @@ -43,10 +46,11 @@ Run a browser-level smoke test for the quiz in the integrated browser. Check key 2. Si algo falla, deja que el agente lo corrija y vuelva a ejecutar la prueba hasta que todo pase. 3. Continúa solo cuando la creación del proyecto y las pruebas se hayan completado correctamente. -Todavía no se ha escrito nada en Git. El siguiente paso es `/init`, que lee el proyecto tal como está, así que conviene asegurarte primero de que funciona. +Todavía no se ha escrito nada en Git. En la siguiente lección ejecutarás `/init create simple rules for the project`, que lee el proyecto tal como está, así que conviene asegurarte primero de que funciona. ## Resumen y pasos siguientes Has confirmado en qué trabaja la sesión y comprobado el cuestionario con una prueba de humo en el explorador. Continúa con la [lección 4: Recoger las instrucciones del proyecto][next-lesson]. [next-lesson]: ../4-project-instructions/ +[publish-lesson]: ../5-publish/ diff --git a/docs/es-es/first-steps/copilot-app/4-project-instructions.md b/docs/es-es/first-steps/copilot-app/4-project-instructions.md index bb9b90ee..0b42f49d 100644 --- a/docs/es-es/first-steps/copilot-app/4-project-instructions.md +++ b/docs/es-es/first-steps/copilot-app/4-project-instructions.md @@ -3,7 +3,7 @@ title: "Lección 4 - Recoger las instrucciones del proyecto" description: "Ejecuta /init para generar instrucciones del agente que describan el Space Quiz terminado y adáptalas a tu forma de trabajar." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Ahora que el cuestionario está creado, perfeccionado y probado, recoge cómo deben tratar este proyecto las sesiones futuras. Cada sesión lee las instrucciones del agente antes de empezar a trabajar, así que te ahorran repetir las mismas directrices en cada prompt. @@ -16,7 +16,9 @@ En esta lección: ## Recoge las reglas con `/init` -1. Ejecuta `/init` en la sesión de la aplicación. +Incluye un prompt después de `/init`. Si envías el comando sin texto adicional, puede aparecer `Command input required`. + +1. Ejecuta `/init create simple rules for the project` en la sesión de la aplicación. 2. Revisa el archivo de instrucciones del agente generado antes de aceptarlo. 3. Redúcelo a directrices que reflejen este proyecto: un único archivo, sin dependencias, accesible y probado en el explorador. diff --git a/docs/es-es/first-steps/copilot-app/5-publish.md b/docs/es-es/first-steps/copilot-app/5-publish.md index 13c8a805..2c0f23f3 100644 --- a/docs/es-es/first-steps/copilot-app/5-publish.md +++ b/docs/es-es/first-steps/copilot-app/5-publish.md @@ -3,7 +3,7 @@ title: "Lección 5 - Publicar el proyecto" description: "Convierte el experimento local de Space Quiz en un repositorio público de GitHub." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Publica el Space Quiz para poder gestionar incidencias, utilizar árboles de trabajo aislados y completar un flujo de trabajo de solicitudes de incorporación de cambios. @@ -23,7 +23,7 @@ Initialize this folder as a Git repository, create an initial commit, and create ``` > [!WARNING] -> El agente pedirá confirmación antes de crear un repositorio o enviar código. Revisa la acción propuesta y el destino antes de aprobarla. +> Según la configuración de aprobación, el agente puede pedir confirmación antes de crear un repositorio o enviar código, o esas acciones pueden aprobarse automáticamente. Con **Approve all**, no esperes una solicitud de confirmación adicional. Revisa la configuración, la acción solicitada y el destino antes de enviar el prompt de publicación. Cuando el agente termine: diff --git a/docs/es-es/first-steps/copilot-app/8-review-loop.md b/docs/es-es/first-steps/copilot-app/8-review-loop.md index 4c407dda..a95bd685 100644 --- a/docs/es-es/first-steps/copilot-app/8-review-loop.md +++ b/docs/es-es/first-steps/copilot-app/8-review-loop.md @@ -3,7 +3,7 @@ title: "Lección 8 - Completar el ciclo de revisión de Copilot" description: "Crea una solicitud de incorporación de cambios, solicita una revisión de Copilot, atiende los comentarios pertinentes y deja que Agent Merge mantenga la solicitud en buen estado." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Convierte la incidencia implementada en una solicitud de incorporación de cambios, solicita una revisión de Copilot y atiende los comentarios antes de combinarla. @@ -18,6 +18,11 @@ En esta lección: ## Crea y revisa la solicitud de incorporación de cambios +> [!IMPORTANT] +> Copilot Free no incluye la revisión de código de Copilot para solicitudes de incorporación de cambios. Utiliza Copilot Student o un plan de pago de Copilot que incluya la revisión de código. Una organización también puede habilitar la revisión de código de pago en GitHub.com para miembros sin una licencia de Copilot. Consulta la [disponibilidad de la revisión de código de Copilot][code-review]. +> +> Si no tienes acceso, completa los pasos 1-4, revisa las diferencias tú mismo o pide a un compañero que las revise y omite los pasos 5-9, que dependen de los comentarios de revisión de Copilot. Atiende los comentarios de los revisores humanos y vuelve a probar la funcionalidad antes de continuar con la sección de combinación. + 1. Abre el panel desplegable de la derecha y selecciona la pestaña **Changes** para inspeccionar los archivos modificados en la sesión. 2. Selecciona **Create PR** en la barra de herramientas de la sesión. 3. Revisa el título y la descripción generados y crea la solicitud de incorporación de cambios. @@ -41,4 +46,5 @@ Si prefieres combinarla tú mismo, revisa las diferencias finales, comprueba la Has completado el ciclo de desarrollo desde la incidencia hasta la solicitud de incorporación de cambios revisada y combinada. Continúa con la [lección 9: Automatizar la clasificación de incidencias][next-lesson]. +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../9-automations/ diff --git a/docs/es-es/first-steps/copilot-cli/2-project-instructions.md b/docs/es-es/first-steps/copilot-cli/2-project-instructions.md index 142acc3f..e20bb1db 100644 --- a/docs/es-es/first-steps/copilot-cli/2-project-instructions.md +++ b/docs/es-es/first-steps/copilot-cli/2-project-instructions.md @@ -3,7 +3,7 @@ title: "Lección 2 - Recoger las instrucciones del proyecto" description: "Ejecuta /init para generar instrucciones del agente que describan el Space Quiz terminado y adáptalas a tu forma de trabajar." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Con un cuestionario funcional en el disco, genera instrucciones del agente que describan el proyecto real. Cada sesión futura lee estas instrucciones antes de empezar a trabajar, así que te ahorran repetir las mismas directrices en cada prompt. @@ -16,7 +16,9 @@ En esta lección: ## Recoge las reglas con `/init` -1. Ejecuta `/init` en la sesión. +Incluye un prompt después de `/init`. Si envías el comando sin texto adicional, puede aparecer `Command input required`. + +1. Ejecuta `/init create simple rules for the project` en la sesión. 2. Revisa el archivo de instrucciones generado antes de aceptarlo. 3. Conserva solo las directrices que correspondan a este proyecto: un único archivo, sin dependencias, accesible y probado en el explorador. diff --git a/docs/es-es/first-steps/vscode/0-prerequisites.md b/docs/es-es/first-steps/vscode/0-prerequisites.md index f68aa251..da057a24 100644 --- a/docs/es-es/first-steps/vscode/0-prerequisites.md +++ b/docs/es-es/first-steps/vscode/0-prerequisites.md @@ -24,6 +24,9 @@ Necesitas: - [Visual Studio Code][vscode]. - [Git][git] instalado. Ejecuta `git --version` en una terminal para comprobarlo. +> [!IMPORTANT] +> Copilot Free no incluye la revisión de código de Copilot para solicitudes de incorporación de cambios. La solicitud de revisión de la [lección 8][review-lesson] requiere [acceso a la revisión de código de Copilot][code-review]. Si no tienes acceso, sigue la alternativa de revisión manual de esa lección. + ## Configura VS Code 1. Instala [VS Code][vscode] e inicia sesión en GitHub. Copilot y Copilot Chat están integrados, así que abre la vista **Chat** desde la barra de título y confirma que responde. @@ -51,4 +54,6 @@ VS Code está listo con Copilot Chat, la extensión de GitHub y una carpeta `spa [git]: https://git-scm.com/downloads [pr-extension]: https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing +[review-lesson]: ../8-review-and-merge/ +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../1-build-and-polish/ diff --git a/docs/es-es/first-steps/vscode/2-project-instructions.md b/docs/es-es/first-steps/vscode/2-project-instructions.md index 4e518f71..71a3ec4f 100644 --- a/docs/es-es/first-steps/vscode/2-project-instructions.md +++ b/docs/es-es/first-steps/vscode/2-project-instructions.md @@ -3,7 +3,7 @@ title: "Lección 2 - Recoger las instrucciones del proyecto" description: "Ejecuta /init en Copilot Chat para generar .github/copilot-instructions.md para Space Quiz y adáptalo." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Con un cuestionario funcional en el área de trabajo, genera instrucciones personalizadas del repositorio que describan el proyecto real. Copilot lee estas instrucciones con cada solicitud de chat. @@ -16,7 +16,7 @@ En esta lección: ## Recoge las reglas con `/init` -1. Ejecuta `/init` en Copilot Chat. +1. Ejecuta `/init create simple rules for the project` en Copilot Chat. 2. Revisa el archivo `.github/copilot-instructions.md` generado antes de guardarlo. 3. Conserva solo las directrices que correspondan a este proyecto: un único archivo, sin dependencias, accesible y probado en el explorador. diff --git a/docs/es-es/first-steps/vscode/8-review-and-merge.md b/docs/es-es/first-steps/vscode/8-review-and-merge.md index f7cc5a8a..bfc8c3f2 100644 --- a/docs/es-es/first-steps/vscode/8-review-and-merge.md +++ b/docs/es-es/first-steps/vscode/8-review-and-merge.md @@ -3,7 +3,7 @@ title: "Lección 8 - Revisar y combinar" description: "Crea una solicitud de incorporación de cambios desde Source Control, solicita una revisión de código de Copilot, atiende los comentarios con las herramientas de GitHub y combínala." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Inspecciona, revisa y combina el nuevo trabajo con las herramientas de GitHub en VS Code. @@ -17,6 +17,11 @@ En esta lección: ## Inspecciona, revisa y combina +> [!IMPORTANT] +> Copilot Free no incluye la revisión de código de Copilot para solicitudes de incorporación de cambios. Utiliza Copilot Student o un plan de pago de Copilot que incluya la revisión de código. Una organización también puede habilitar la revisión de código de pago en GitHub.com para miembros sin una licencia de Copilot, pero esto no concede acceso a la revisión de código en los IDE. Consulta la [disponibilidad de la revisión de código de Copilot][code-review]. +> +> Si no tienes acceso, omite la solicitud de revisión de Copilot del paso 4. Revisa las diferencias tú mismo o pide a un compañero que las revise y continúa con los pasos restantes, atendiendo los comentarios de los revisores humanos y volviendo a probar antes de combinar. + 1. Abre **Source Control** para inspeccionar los archivos modificados y las diferencias antes de crear nada. 2. Crea un commit con el nuevo trabajo utilizando de nuevo el botón **sparkle** para escribir el mensaje. 3. Selecciona el botón **Create Pull Request** que aparece en **Source Control**. Copilot redacta el título y la descripción a partir de tus commits, así que obtienes una solicitud de incorporación de cambios mejor que si la pides desde cero. @@ -32,4 +37,5 @@ En esta lección: Has revisado y combinado una solicitud de incorporación de cambios sin salir de VS Code. Continúa con la [lección 9: Entregar la siguiente idea a una sesión en la nube][next-lesson]. +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../9-cloud-session/ diff --git a/docs/first-steps/copilot-app/0-prerequisites.md b/docs/first-steps/copilot-app/0-prerequisites.md index 50eb3868..a36e050f 100644 --- a/docs/first-steps/copilot-app/0-prerequisites.md +++ b/docs/first-steps/copilot-app/0-prerequisites.md @@ -24,6 +24,9 @@ You need: - an active Copilot plan. [Activate Copilot Free or a paid Copilot plan][copilot-plans]. If your organization already provides Copilot access, use that account. - a computer running macOS, Windows, or Linux. +> [!IMPORTANT] +> Copilot Free does not include Copilot code review for pull requests. The review request in [Lesson 8][review-lesson] requires [access to Copilot code review][code-review]. If you do not have access, follow that lesson's manual-review alternative. + The app ships with Git, so there is nothing else to install. > [!NOTE] @@ -75,4 +78,6 @@ You verified the prerequisites, installed the app, chose a model, and explored i [copilot-plans]: https://github.com/features/copilot/plans [download-app]: https://gh.io/app [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing +[review-lesson]: ../8-review-loop/ +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../1-create-workspace/ diff --git a/docs/first-steps/copilot-app/3-inspect-and-test.md b/docs/first-steps/copilot-app/3-inspect-and-test.md index d158d5ce..2683a971 100644 --- a/docs/first-steps/copilot-app/3-inspect-and-test.md +++ b/docs/first-steps/copilot-app/3-inspect-and-test.md @@ -3,7 +3,7 @@ title: "Lesson 3 - Inspect the session and test the quiz" description: "Read the session details to confirm what the agent is working on, then run a browser-level smoke test before Git writes anything." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Now that your session has done real work, there is something to inspect. Confirm what the agent is pointed at, then let it drive the quiz in the integrated browser and report what actually happened rather than what it intended. @@ -11,25 +11,28 @@ Now that your session has done real work, there is something to inspect. Confirm In this lesson, you will: - read the session details panel. -- check the session's project, path, branch, changes, and context usage. +- check the session's project, path, and context usage. - run a browser-level smoke test and fix any failures. ## Read the session details The session details tell you exactly what the agent is working on. You do not need to watch this panel constantly, but everything in it matters when a result surprises you. -![Illustration of the Copilot app session details panel for the Space Quiz build session. It shows the main branch from origin/main, the path, project, session name, session ID, and agent, one file changed, token counts, context usage at 27 percent, session spend, and options to enable remote control, rename, view insights, share as a secret gist, or archive the session.](../../_images/first-steps-app-session-details.svg) +At this point, Space Quiz is still a local folder, not a Git repository. Check its project, path, and context usage. After you [publish the project in Lesson 5][publish-lesson], Git-backed sessions show additional details such as the branch and **Changes**. -The panel shows where the work is happening, what has changed, and how full the context window is. There is no model row, because you choose the model for each request in the composer. +The illustration below shows a later, Git-backed session. Its branch and **Changes** fields are not available in your local-folder session yet. -1. Confirm that the **project**, **path**, and **branch** are the ones you think you are editing. -2. Read **Changes** to see whether this session has touched anything yet. -3. Check **context usage**. As it climbs, the agent has less room for your actual task, and that is your cue to start a fresh session. +![Illustration of the Copilot app session details panel for a Git-backed Space Quiz session. It shows the main branch from origin/main, the path, project, session name, session ID, and agent, one file changed, token counts, context usage at 27 percent, session spend, and options to enable remote control, rename, view insights, share as a secret gist, or archive the session.](../../_images/first-steps-app-session-details.svg) + +The panel shows where the work is happening and how full the context window is. There is no model row, because you choose the model for each request in the composer. + +1. Confirm that the **project** and **path** are the ones you think you are editing. +2. Check **context usage**. As it climbs, the agent has less room for your actual task, and that is your cue to start a fresh session. > [!TIP] > **Most bad results are context problems** > -> A wrong branch, a wrong folder, or a nearly full context window explains far more surprises than a bad prompt does. +> A wrong folder or a nearly full context window explains far more surprises than a bad prompt does. ## Test before Git writes anything @@ -43,10 +46,11 @@ Run a browser-level smoke test for the quiz in the integrated browser. Check key 2. If anything fails, let the agent fix it and rerun the test until everything passes. 3. Move on only when the build and test are green. -Nothing has been written to Git yet. The next step is `/init`, which reads the project as it stands, so it is worth making sure the project works first. +Nothing has been written to Git yet. In the next lesson, you will run `/init create simple rules for the project`, which reads the project as it stands, so it is worth making sure the project works first. ## Summary and next steps You confirmed what the session is working on and verified the quiz with a browser-level smoke test. Continue to [Lesson 4: Capture project instructions][next-lesson]. [next-lesson]: ../4-project-instructions/ +[publish-lesson]: ../5-publish/ diff --git a/docs/first-steps/copilot-app/4-project-instructions.md b/docs/first-steps/copilot-app/4-project-instructions.md index 229bed2e..6a208993 100644 --- a/docs/first-steps/copilot-app/4-project-instructions.md +++ b/docs/first-steps/copilot-app/4-project-instructions.md @@ -3,7 +3,7 @@ title: "Lesson 4 - Capture project instructions" description: "Run /init to generate agent instructions that describe the finished Space Quiz, then tailor them to how you work." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Now that the quiz is built, polished, and tested, capture how future sessions should treat this project. Agent instructions are read by every session before it starts work, so they save you from repeating the same guidance in every prompt. @@ -16,7 +16,9 @@ In this lesson, you will: ## Capture the rules with `/init` -1. Run `/init` in the app session. +Include a prompt after `/init`. Submitting the command on its own can produce `Command input required`. + +1. Run `/init create simple rules for the project` in the app session. 2. Review the generated agent instructions file before accepting it. 3. Trim it to guidance that reflects this project: a single file, no dependencies, accessible, and browser-tested. diff --git a/docs/first-steps/copilot-app/5-publish.md b/docs/first-steps/copilot-app/5-publish.md index 0292392f..4e786799 100644 --- a/docs/first-steps/copilot-app/5-publish.md +++ b/docs/first-steps/copilot-app/5-publish.md @@ -3,7 +3,7 @@ title: "Lesson 5 - Publish the project" description: "Turn the local Space Quiz experiment into a public GitHub repository." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Publish the Space Quiz so you can manage issues, use isolated worktrees, and complete a pull request workflow. @@ -23,7 +23,7 @@ Initialize this folder as a Git repository, create an initial commit, and create ``` > [!WARNING] -> The agent will ask for confirmation before it creates a repository or pushes code. Review the proposed action and destination before you approve it. +> Depending on your approval settings, the agent may ask for confirmation before it creates a repository or pushes code, or those actions may be approved automatically. With **Approve all**, do not expect a separate confirmation prompt. Review your settings, the requested action, and the destination before sending the publishing prompt. After the agent finishes: diff --git a/docs/first-steps/copilot-app/8-review-loop.md b/docs/first-steps/copilot-app/8-review-loop.md index 40e24def..c2b0aa7c 100644 --- a/docs/first-steps/copilot-app/8-review-loop.md +++ b/docs/first-steps/copilot-app/8-review-loop.md @@ -3,7 +3,7 @@ title: "Lesson 8 - Complete the Copilot review loop" description: "Create a pull request, request a Copilot review, address actionable feedback, and let Agent Merge keep the pull request healthy." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Turn the implemented issue into a pull request, request a review from Copilot, and address the feedback before merging. @@ -18,6 +18,11 @@ In this lesson, you will: ## Create and review the pull request +> [!IMPORTANT] +> Copilot Free does not include Copilot code review for pull requests. Use Copilot Student or a paid Copilot plan that includes code review. An organization can also enable paid code review on GitHub.com for members without a Copilot license. See [Copilot code review availability][code-review]. +> +> If you do not have access, complete steps 1-4, review the diff yourself or ask a teammate to review it, and skip steps 5-9 that depend on Copilot review feedback. Address any human review feedback and retest the feature before continuing to the merge section. + 1. Open the right-side flyout and select the **Changes** tab to inspect the files changed in the session. 2. Select **Create PR** in the session toolbar. 3. Review the generated title and description, then create the pull request. @@ -41,4 +46,5 @@ If you prefer to merge yourself, review the final diff, verify the feature, and You completed the development loop from issue to reviewed and merged pull request. Continue to [Lesson 9: Automate issue triage][next-lesson]. +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../9-automations/ diff --git a/docs/first-steps/copilot-cli/2-project-instructions.md b/docs/first-steps/copilot-cli/2-project-instructions.md index 79e05f1f..22a728a6 100644 --- a/docs/first-steps/copilot-cli/2-project-instructions.md +++ b/docs/first-steps/copilot-cli/2-project-instructions.md @@ -3,7 +3,7 @@ title: "Lesson 2 - Capture project instructions" description: "Run /init to generate agent instructions that describe the finished Space Quiz, then tailor them to how you work." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- With a working quiz on disk, generate agent instructions that describe the real project. Every future session reads these instructions before it starts work, so they save you from repeating the same guidance in every prompt. @@ -16,7 +16,9 @@ In this lesson, you will: ## Capture the rules with `/init` -1. Run `/init` in the session. +Include a prompt after `/init`. Submitting the command on its own can produce `Command input required`. + +1. Run `/init create simple rules for the project` in the session. 2. Review the generated instructions file before accepting it. 3. Keep only guidance that matches this project: a single file, no dependencies, accessible, and browser-tested. diff --git a/docs/first-steps/vscode/0-prerequisites.md b/docs/first-steps/vscode/0-prerequisites.md index adf82037..90a9c74d 100644 --- a/docs/first-steps/vscode/0-prerequisites.md +++ b/docs/first-steps/vscode/0-prerequisites.md @@ -24,6 +24,9 @@ You need: - [Visual Studio Code][vscode]. - [Git][git] installed. Run `git --version` in a terminal to verify it. +> [!IMPORTANT] +> Copilot Free does not include Copilot code review for pull requests. The review request in [Lesson 8][review-lesson] requires [access to Copilot code review][code-review]. If you do not have access, follow that lesson's manual-review alternative. + ## Set up VS Code 1. Install [VS Code][vscode] and sign in to GitHub. Copilot and Copilot Chat are built in, so open the **Chat** view from the title bar and confirm that it responds. @@ -51,4 +54,6 @@ VS Code is ready with Copilot Chat, the GitHub extension, and an empty `space-qu [git]: https://git-scm.com/downloads [pr-extension]: https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing +[review-lesson]: ../8-review-and-merge/ +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../1-build-and-polish/ diff --git a/docs/first-steps/vscode/2-project-instructions.md b/docs/first-steps/vscode/2-project-instructions.md index b15c3d59..204b3a25 100644 --- a/docs/first-steps/vscode/2-project-instructions.md +++ b/docs/first-steps/vscode/2-project-instructions.md @@ -3,7 +3,7 @@ title: "Lesson 2 - Capture project instructions" description: "Run /init in Copilot Chat to generate .github/copilot-instructions.md for the Space Quiz, then tailor it." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- With a working quiz in the workspace, generate repository custom instructions that describe the real project. Copilot reads these instructions with every chat request. @@ -16,7 +16,7 @@ In this lesson, you will: ## Capture the rules with `/init` -1. Run `/init` in Copilot Chat. +1. Run `/init create simple rules for the project` in Copilot Chat. 2. Review the generated `.github/copilot-instructions.md` file before saving it. 3. Keep only guidance that matches this project: a single file, no dependencies, accessible, and browser-tested. diff --git a/docs/first-steps/vscode/8-review-and-merge.md b/docs/first-steps/vscode/8-review-and-merge.md index ce52e022..82332b46 100644 --- a/docs/first-steps/vscode/8-review-and-merge.md +++ b/docs/first-steps/vscode/8-review-and-merge.md @@ -3,7 +3,7 @@ title: "Lesson 8 - Review and merge" description: "Create a pull request from Source Control, request a Copilot code review, address feedback with GitHub tools, and merge." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Inspect, review, and merge the new work with GitHub tools in VS Code. @@ -17,6 +17,11 @@ In this lesson, you will: ## Inspect, review, and merge +> [!IMPORTANT] +> Copilot Free does not include Copilot code review for pull requests. Use Copilot Student or a paid Copilot plan that includes code review. An organization can also enable paid code review on GitHub.com for members without a Copilot license, but this does not grant IDE code review access. See [Copilot code review availability][code-review]. +> +> If you do not have access, skip the Copilot review request in step 4. Review the diff yourself or ask a teammate to review it, then continue with the remaining steps, addressing any human review feedback and retesting before merging. + 1. Open **Source Control** to inspect the changed files and diff before you create anything. 2. Commit the new work, using the **sparkle** button to write the message again. 3. Select the **Create Pull Request** button that appears in **Source Control**. Copilot drafts the title and description from your commits, so you get a better pull request than asking for one from scratch. @@ -32,4 +37,5 @@ In this lesson, you will: You reviewed and merged a pull request without leaving VS Code. Continue to [Lesson 9: Hand the next idea to a cloud session][next-lesson]. +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../9-cloud-session/ diff --git a/docs/ja-jp/first-steps/copilot-app/0-prerequisites.md b/docs/ja-jp/first-steps/copilot-app/0-prerequisites.md index 3ea76b7b..7040e3ce 100644 --- a/docs/ja-jp/first-steps/copilot-app/0-prerequisites.md +++ b/docs/ja-jp/first-steps/copilot-app/0-prerequisites.md @@ -24,6 +24,9 @@ Space Quiz を構築する前に、必要なものが揃っていることを確 - 有効な Copilot プラン。[Copilot Free または有料の Copilot プランを有効にします][copilot-plans]。組織からすでに Copilot へのアクセスが提供されている場合は、そのアカウントを使用します。 - macOS、Windows、Linux のいずれかを搭載したコンピューター。 +> [!IMPORTANT] +> Copilot Free には、プルリクエスト向けの Copilot コードレビューは含まれません。[レッスン 8][review-lesson]でレビューを依頼するには、[Copilot コードレビューへのアクセス][code-review]が必要です。アクセスできない場合は、そのレッスンにある手動レビューの手順に従います。 + アプリには Git が同梱されているため、ほかにインストールするものはありません。 > [!NOTE] @@ -75,4 +78,6 @@ How does the GitHub Copilot app use worktrees? [copilot-plans]: https://github.com/features/copilot/plans [download-app]: https://gh.io/app [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing +[review-lesson]: ../8-review-loop/ +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../1-create-workspace/ diff --git a/docs/ja-jp/first-steps/copilot-app/3-inspect-and-test.md b/docs/ja-jp/first-steps/copilot-app/3-inspect-and-test.md index 21c51a16..df1266fd 100644 --- a/docs/ja-jp/first-steps/copilot-app/3-inspect-and-test.md +++ b/docs/ja-jp/first-steps/copilot-app/3-inspect-and-test.md @@ -3,7 +3,7 @@ title: "レッスン 3 - セッションの確認とクイズのテスト" description: "セッションの詳細を読んでエージェントの作業対象を確認し、Git に変更を記録する前にブラウザーレベルのスモークテストを実行します。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- セッションで実際に作業を行ったので、確認する内容ができました。エージェントがどこを作業対象にしているかを確認し、その後、統合ブラウザーでクイズを操作してもらいます。意図したことではなく、実際に起きたことを報告してもらいましょう。 @@ -11,25 +11,28 @@ lastUpdated: 2026-09-28 このレッスンでは、次の内容を学習します。 - セッションの詳細パネルを読む。 -- セッションのプロジェクト、パス、ブランチ、変更、コンテキストの使用率を確認する。 +- セッションのプロジェクト、パス、コンテキストの使用率を確認する。 - ブラウザーレベルのスモークテストを実行し、問題があれば修正する。 ## セッションの詳細を読む セッションの詳細は、エージェントが何に取り組んでいるかを正確に示します。このパネルを常に見ている必要はありませんが、予想外の結果が出たときには、どの情報も重要です。 -![Space Quiz の構築セッションの Copilot app 詳細パネルの図。origin/main を基にした main ブランチ、パス、プロジェクト、セッション名、セッション ID、エージェント、変更された 1 つのファイル、トークン数、27 パーセントのコンテキスト使用率、セッションの費用を表示しています。リモート操作の有効化、名前の変更、インサイトの表示、secret gist としての共有、セッションのアーカイブのオプションもあります。](../../../_images/first-steps-app-session-details.svg) +この時点の Space Quiz は、まだローカルフォルダーであり、Git リポジトリではありません。プロジェクト、パス、コンテキストの使用率を確認します。[レッスン 5 でプロジェクトを公開][publish-lesson]すると、Git を使うセッションでは、ブランチや **Changes** などの詳細も表示されます。 -このパネルには、作業場所、変更内容、コンテキストウィンドウの使用状況が表示されます。モデルの行はありません。モデルは、入力欄でリクエストごとに選びます。 +次の図は、後の段階で Git を使うセッションを示しています。ローカルフォルダーのセッションでは、ブランチと **Changes** の項目はまだ表示されません。 -1. **project**、**path**、**branch** が、編集しているつもりの対象と一致していることを確認します。 -2. **Changes** を読み、このセッションですでに何か変更したかを確認します。 -3. **context usage** を確認します。使用率が上がるほど、実際のタスクに使える余地が少なくなります。これは新しいセッションを始める目安です。 +![Git を使う Space Quiz セッションの Copilot app 詳細パネルの図。origin/main を基にした main ブランチ、パス、プロジェクト、セッション名、セッション ID、エージェント、変更された 1 つのファイル、トークン数、27 パーセントのコンテキスト使用率、セッションの費用を表示しています。リモート操作の有効化、名前の変更、インサイトの表示、secret gist としての共有、セッションのアーカイブのオプションもあります。](../../../_images/first-steps-app-session-details.svg) + +このパネルには、作業場所とコンテキストウィンドウの使用状況が表示されます。モデルの行はありません。モデルは、入力欄でリクエストごとに選びます。 + +1. **project** と **path** が、編集しているつもりの対象と一致していることを確認します。 +2. **context usage** を確認します。使用率が上がるほど、実際のタスクに使える余地が少なくなります。これは新しいセッションを始める目安です。 > [!TIP] > **望ましくない結果の多くはコンテキストの問題です** > -> 間違ったブランチやフォルダー、ほぼ満杯のコンテキストウィンドウは、よくないプロンプトよりもはるかに多くの予想外の結果の原因になります。 +> 間違ったフォルダーや、ほぼ満杯のコンテキストウィンドウは、よくないプロンプトよりもはるかに多くの予想外の結果の原因になります。 ## Git に変更を記録する前にテストする @@ -43,10 +46,11 @@ Run a browser-level smoke test for the quiz in the integrated browser. Check key 2. 何か失敗した場合は、すべて合格するまで、エージェントに修正とテストの再実行をしてもらいます。 3. ビルドとテストが成功してから次に進みます。 -まだ Git には何も記録していません。次のステップの `/init` は、現状のプロジェクトを読み取るため、先にプロジェクトが動作することを確認しておく価値があります。 +まだ Git には何も記録していません。次のレッスンでは `/init create simple rules for the project` を実行します。現状のプロジェクトを読み取るため、先にプロジェクトが動作することを確認しておく価値があります。 ## まとめと次のステップ セッションの作業対象を確認し、ブラウザーレベルのスモークテストでクイズを検証しました。[レッスン 4: プロジェクトの指示の記録][next-lesson]に進みます。 [next-lesson]: ../4-project-instructions/ +[publish-lesson]: ../5-publish/ diff --git a/docs/ja-jp/first-steps/copilot-app/4-project-instructions.md b/docs/ja-jp/first-steps/copilot-app/4-project-instructions.md index 7a58b88a..380e7f1f 100644 --- a/docs/ja-jp/first-steps/copilot-app/4-project-instructions.md +++ b/docs/ja-jp/first-steps/copilot-app/4-project-instructions.md @@ -3,7 +3,7 @@ title: "レッスン 4 - プロジェクトの指示の記録" description: "/init を実行して完成した Space Quiz を説明するエージェントへの指示を生成し、自分の作業方法に合わせて調整します。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- クイズの構築、仕上げ、テストが済んだので、今後のセッションでこのプロジェクトをどう扱うべきかを記録します。どのセッションも作業を始める前にエージェントへの指示を読むため、同じ方針を毎回プロンプトに書く必要がなくなります。 @@ -16,7 +16,9 @@ lastUpdated: 2026-09-28 ## `/init` でルールを記録する -1. アプリのセッションで `/init` を実行します。 +`/init` の後にプロンプトを入力します。コマンドだけを送信すると、`Command input required` が表示される場合があります。 + +1. アプリのセッションで `/init create simple rules for the project` を実行します。 2. 生成されたエージェントへの指示ファイルを受け入れる前にレビューします。 3. このプロジェクトを反映する指示に絞ります。単一ファイルであること、依存関係がないこと、アクセシブルであること、ブラウザーでテストすることが該当します。 diff --git a/docs/ja-jp/first-steps/copilot-app/5-publish.md b/docs/ja-jp/first-steps/copilot-app/5-publish.md index 1e33204a..dc78ab55 100644 --- a/docs/ja-jp/first-steps/copilot-app/5-publish.md +++ b/docs/ja-jp/first-steps/copilot-app/5-publish.md @@ -3,7 +3,7 @@ title: "レッスン 5 - プロジェクトの公開" description: "ローカルで試作した Space Quiz を GitHub のパブリックリポジトリにします。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Space Quiz を公開して、Issue を管理し、分離された worktree を使い、プルリクエストのワークフローを完了できるようにします。 @@ -23,7 +23,7 @@ Initialize this folder as a Git repository, create an initial commit, and create ``` > [!WARNING] -> エージェントは、リポジトリの作成やコードのプッシュの前に確認を求めます。承認する前に、提案された操作とその対象をレビューしてください。 +> 承認設定によって、リポジトリの作成やコードのプッシュの前にエージェントが確認を求める場合と、操作が自動で承認される場合があります。**Approve all** では、個別の確認プロンプトが表示されるとは限りません。公開用のプロンプトを送信する前に、設定、依頼する操作、その対象をレビューしてください。 エージェントの作業が完了したら、次を行います。 diff --git a/docs/ja-jp/first-steps/copilot-app/8-review-loop.md b/docs/ja-jp/first-steps/copilot-app/8-review-loop.md index 4f101f12..abe6ec3c 100644 --- a/docs/ja-jp/first-steps/copilot-app/8-review-loop.md +++ b/docs/ja-jp/first-steps/copilot-app/8-review-loop.md @@ -3,7 +3,7 @@ title: "レッスン 8 - Copilot のレビューの流れの完了" description: "プルリクエストを作成し、Copilot にレビューを依頼して対応すべきフィードバックを修正し、Agent Merge にプルリクエストをマージ可能な状態に保ってもらいます。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 実装した Issue のプルリクエストを作成し、Copilot にレビューを依頼して、マージ前にフィードバックに対応します。 @@ -18,6 +18,11 @@ lastUpdated: 2026-09-28 ## プルリクエストを作成してレビューする +> [!IMPORTANT] +> Copilot Free には、プルリクエスト向けの Copilot コードレビューは含まれません。Copilot Student、またはコードレビューを含む有料の Copilot プランを使用します。組織は、Copilot ライセンスを持たないメンバー向けに、GitHub.com での有料コードレビューを有効にすることもできます。[Copilot コードレビューの利用条件][code-review]を確認してください。 +> +> アクセスできない場合は、手順 1-4 を完了し、自分で差分をレビューするかチームメンバーにレビューを依頼して、Copilot のレビュー結果に依存する手順 5-9 を省略します。人によるレビューのフィードバックに対応し、機能を再テストしてから、マージのセクションに進みます。 + 1. 右側のフライアウトを開いて **Changes** タブを選択し、セッションで変更したファイルを確認します。 2. セッションのツールバーで **Create PR** を選択します。 3. 生成されたタイトルと説明をレビューし、プルリクエストを作成します。 @@ -41,4 +46,5 @@ lastUpdated: 2026-09-28 Issue から、レビューしてマージしたプルリクエストまで、開発の流れを完了しました。[レッスン 9: Issue のトリアージの自動化][next-lesson]に進みます。 +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../9-automations/ diff --git a/docs/ja-jp/first-steps/copilot-cli/2-project-instructions.md b/docs/ja-jp/first-steps/copilot-cli/2-project-instructions.md index 2d734a1d..40b2ebbc 100644 --- a/docs/ja-jp/first-steps/copilot-cli/2-project-instructions.md +++ b/docs/ja-jp/first-steps/copilot-cli/2-project-instructions.md @@ -3,7 +3,7 @@ title: "レッスン 2 - プロジェクトの指示の記録" description: "/init を実行して完成した Space Quiz を説明するエージェントへの指示を生成し、自分の作業方法に合わせて調整します。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 動作するクイズがディスクに保存されたので、実際のプロジェクトを説明するエージェントへの指示を生成します。今後のすべてのセッションは作業を始める前にこれらの指示を読むため、同じ方針を毎回プロンプトに書く必要がなくなります。 @@ -16,7 +16,9 @@ lastUpdated: 2026-09-28 ## `/init` でルールを記録する -1. セッションで `/init` を実行します。 +`/init` の後にプロンプトを入力します。コマンドだけを送信すると、`Command input required` が表示される場合があります。 + +1. セッションで `/init create simple rules for the project` を実行します。 2. 生成された指示ファイルを受け入れる前にレビューします。 3. このプロジェクトに合う指示だけを残します。単一ファイルであること、依存関係がないこと、アクセシブルであること、ブラウザーでテストすることが該当します。 diff --git a/docs/ja-jp/first-steps/vscode/0-prerequisites.md b/docs/ja-jp/first-steps/vscode/0-prerequisites.md index 9bb22c8d..8bc8f8d5 100644 --- a/docs/ja-jp/first-steps/vscode/0-prerequisites.md +++ b/docs/ja-jp/first-steps/vscode/0-prerequisites.md @@ -24,6 +24,9 @@ lastUpdated: 2026-10-05 - [Visual Studio Code][vscode]。 - インストール済みの [Git][git]。ターミナルで `git --version` を実行して確認します。 +> [!IMPORTANT] +> Copilot Free には、プルリクエスト向けの Copilot コードレビューは含まれません。[レッスン 8][review-lesson]でレビューを依頼するには、[Copilot コードレビューへのアクセス][code-review]が必要です。アクセスできない場合は、そのレッスンにある手動レビューの手順に従います。 + ## VS Code のセットアップ 1. [VS Code][vscode] をインストールし、GitHub にサインインします。Copilot と Copilot Chat は組み込まれているため、タイトルバーから **Chat** ビューを開き、応答することを確認します。 @@ -51,4 +54,6 @@ VS Code に Copilot Chat、GitHub 拡張機能、空の `space-quiz` フォル [git]: https://git-scm.com/downloads [pr-extension]: https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing +[review-lesson]: ../8-review-and-merge/ +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../1-build-and-polish/ diff --git a/docs/ja-jp/first-steps/vscode/2-project-instructions.md b/docs/ja-jp/first-steps/vscode/2-project-instructions.md index f10326e5..b9722080 100644 --- a/docs/ja-jp/first-steps/vscode/2-project-instructions.md +++ b/docs/ja-jp/first-steps/vscode/2-project-instructions.md @@ -3,7 +3,7 @@ title: "レッスン 2 - プロジェクトの指示の記録" description: "Copilot Chat で /init を実行して Space Quiz 用の .github/copilot-instructions.md を生成し、調整します。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- ワークスペースに動作するクイズができたので、実際のプロジェクトを説明するリポジトリのカスタム指示を生成します。Copilot は、チャットのリクエストごとにこれらの指示を読みます。 @@ -16,7 +16,7 @@ lastUpdated: 2026-09-28 ## `/init` でルールを記録する -1. Copilot Chat で `/init` を実行します。 +1. Copilot Chat で `/init create simple rules for the project` を実行します。 2. 生成された `.github/copilot-instructions.md` ファイルを保存する前にレビューします。 3. このプロジェクトに合う指示だけを残します。単一ファイルであること、依存関係がないこと、アクセシブルであること、ブラウザーでテストすることが該当します。 diff --git a/docs/ja-jp/first-steps/vscode/8-review-and-merge.md b/docs/ja-jp/first-steps/vscode/8-review-and-merge.md index 83468264..1f3fb647 100644 --- a/docs/ja-jp/first-steps/vscode/8-review-and-merge.md +++ b/docs/ja-jp/first-steps/vscode/8-review-and-merge.md @@ -3,7 +3,7 @@ title: "レッスン 8 - レビューとマージ" description: "Source Control からプルリクエストを作成し、Copilot にコードレビューを依頼して GitHub のツールでフィードバックに対応し、マージします。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- VS Code の GitHub ツールで、新しい作業を確認し、レビューしてマージします。 @@ -17,6 +17,11 @@ VS Code の GitHub ツールで、新しい作業を確認し、レビューし ## 確認、レビュー、マージ +> [!IMPORTANT] +> Copilot Free には、プルリクエスト向けの Copilot コードレビューは含まれません。Copilot Student、またはコードレビューを含む有料の Copilot プランを使用します。組織は、Copilot ライセンスを持たないメンバー向けに、GitHub.com での有料コードレビューを有効にすることもできます。ただし、これによって IDE でのコードレビューへのアクセスが許可されるわけではありません。[Copilot コードレビューの利用条件][code-review]を確認してください。 +> +> アクセスできない場合は、手順 4 の Copilot へのレビュー依頼を省略します。自分で差分をレビューするかチームメンバーにレビューを依頼して、残りの手順を続けます。マージ前に、人によるレビューのフィードバックに対応し、再テストします。 + 1. 何かを作成する前に **Source Control** を開き、変更されたファイルと差分を確認します。 2. もう一度**きらめき**ボタンでメッセージを書いてもらい、新しい作業をコミットします。 3. **Source Control** に表示される **Create Pull Request** ボタンを選択します。Copilot がコミットに基づいてタイトルと説明の下書きを作成するため、何もない状態から依頼するよりもよいプルリクエストになります。 @@ -32,4 +37,5 @@ VS Code の GitHub ツールで、新しい作業を確認し、レビューし VS Code を離れずにプルリクエストをレビューしてマージしました。[レッスン 9: 次のアイデアをクラウドセッションに任せる][next-lesson]に進みます。 +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../9-cloud-session/ diff --git a/docs/ko-kr/first-steps/copilot-app/0-prerequisites.md b/docs/ko-kr/first-steps/copilot-app/0-prerequisites.md index 809cccce..936f1b20 100644 --- a/docs/ko-kr/first-steps/copilot-app/0-prerequisites.md +++ b/docs/ko-kr/first-steps/copilot-app/0-prerequisites.md @@ -24,6 +24,9 @@ Space Quiz를 만들기 전에 필요한 사항을 확인하고, GitHub Copilot - 활성 Copilot 플랜. [Copilot Free 또는 유료 Copilot 플랜을 활성화합니다][copilot-plans]. 조직에서 이미 Copilot 액세스를 제공한다면 해당 계정을 사용합니다. - macOS, Windows 또는 Linux를 실행하는 컴퓨터. +> [!IMPORTANT] +> Copilot Free에는 풀 리퀘스트용 Copilot 코드 검토가 포함되지 않습니다. [레슨 8][review-lesson]에서 검토를 요청하려면 [Copilot 코드 검토 액세스][code-review]가 필요합니다. 액세스할 수 없다면 해당 레슨의 수동 검토 대안을 따릅니다. + 앱에 Git이 포함되어 있으므로 다른 도구를 설치할 필요가 없습니다. > [!NOTE] @@ -75,4 +78,6 @@ How does the GitHub Copilot app use worktrees? [copilot-plans]: https://github.com/features/copilot/plans [download-app]: https://gh.io/app [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing +[review-lesson]: ../8-review-loop/ +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../1-create-workspace/ diff --git a/docs/ko-kr/first-steps/copilot-app/3-inspect-and-test.md b/docs/ko-kr/first-steps/copilot-app/3-inspect-and-test.md index 399b7f95..ce82f974 100644 --- a/docs/ko-kr/first-steps/copilot-app/3-inspect-and-test.md +++ b/docs/ko-kr/first-steps/copilot-app/3-inspect-and-test.md @@ -3,7 +3,7 @@ title: "레슨 3 - 세션 살펴보기 및 퀴즈 테스트" description: "세션 세부 정보에서 에이전트의 작업 대상을 확인한 다음, Git에 기록하기 전에 브라우저 수준의 스모크 테스트를 실행합니다." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 이제 세션에서 실제 작업을 수행했으므로 살펴볼 내용이 있습니다. 에이전트의 작업 대상을 확인한 다음, 통합 브라우저에서 퀴즈를 조작하고 의도한 결과가 아니라 실제로 일어난 결과를 보고하게 합니다. @@ -11,25 +11,28 @@ lastUpdated: 2026-09-28 이 레슨에서는 다음 작업을 수행합니다. - 세션 세부 정보 패널을 읽습니다. -- 세션의 프로젝트, 경로, 브랜치, 변경 사항, 컨텍스트 사용량을 확인합니다. +- 세션의 프로젝트, 경로, 컨텍스트 사용량을 확인합니다. - 브라우저 수준의 스모크 테스트(Smoke test)를 실행하고 실패한 부분을 수정합니다. ## 세션 세부 정보 읽기 세션 세부 정보는 에이전트가 정확히 무엇을 작업하는지 알려 줍니다. 이 패널을 계속 지켜볼 필요는 없지만, 예상과 다른 결과가 나오면 패널의 모든 정보가 중요합니다. -![Space Quiz 빌드 세션의 Copilot app 세션 세부 정보 패널 일러스트레이션. origin/main에서 시작한 main 브랜치, 경로, 프로젝트, 세션 이름, 세션 ID 및 에이전트, 변경된 파일 1개, 토큰 수, 컨텍스트 사용량 27%, 세션 비용, 원격 제어 활성화, 이름 변경, 인사이트 보기, 비밀 gist로 공유, 세션 보관 옵션이 표시되어 있습니다.](../../../_images/first-steps-app-session-details.svg) +이 시점의 Space Quiz는 아직 Git 리포지토리가 아닌 로컬 폴더입니다. 프로젝트, 경로, 컨텍스트 사용량을 확인합니다. [레슨 5에서 프로젝트를 게시][publish-lesson]하면 Git 기반 세션에 브랜치와 **Changes** 같은 추가 세부 정보가 표시됩니다. -패널에는 작업 위치, 변경 사항, 컨텍스트 윈도우(Context window)가 얼마나 찼는지가 표시됩니다. 요청마다 입력 영역에서 모델을 선택하므로 모델 행은 없습니다. +아래 일러스트레이션은 이후 단계의 Git 기반 세션을 보여 줍니다. 로컬 폴더 세션에는 아직 브랜치와 **Changes** 필드가 표시되지 않습니다. -1. **project**, **path**, **branch**가 편집하려는 대상과 일치하는지 확인합니다. -2. **Changes**를 읽고 세션에서 변경한 내용이 있는지 확인합니다. -3. **context usage**를 확인합니다. 사용량이 늘어날수록 에이전트가 실제 작업에 활용할 여유 공간이 줄어듭니다. 이때 새 세션을 시작합니다. +![Git 기반 Space Quiz 세션의 Copilot app 세션 세부 정보 패널 일러스트레이션. origin/main에서 시작한 main 브랜치, 경로, 프로젝트, 세션 이름, 세션 ID 및 에이전트, 변경된 파일 1개, 토큰 수, 컨텍스트 사용량 27%, 세션 비용, 원격 제어 활성화, 이름 변경, 인사이트 보기, 비밀 gist로 공유, 세션 보관 옵션이 표시되어 있습니다.](../../../_images/first-steps-app-session-details.svg) + +패널에는 작업 위치와 컨텍스트 윈도우(Context window)가 얼마나 찼는지가 표시됩니다. 요청마다 입력 영역에서 모델을 선택하므로 모델 행은 없습니다. + +1. **project**와 **path**가 편집하려는 대상과 일치하는지 확인합니다. +2. **context usage**를 확인합니다. 사용량이 늘어날수록 에이전트가 실제 작업에 활용할 여유 공간이 줄어듭니다. 이때 새 세션을 시작합니다. > [!TIP] > **잘못된 결과는 대부분 컨텍스트 문제에서 비롯됩니다** > -> 잘못된 브랜치, 잘못된 폴더, 거의 가득 찬 컨텍스트 윈도우가 부정확한 프롬프트보다 훨씬 더 자주 예상 밖 결과의 원인이 됩니다. +> 잘못된 폴더나 거의 가득 찬 컨텍스트 윈도우가 부정확한 프롬프트보다 훨씬 더 자주 예상 밖 결과의 원인이 됩니다. ## Git에 기록하기 전에 테스트하기 @@ -43,10 +46,11 @@ Run a browser-level smoke test for the quiz in the integrated browser. Check key 2. 실패한 부분이 있으면 에이전트가 수정하고 모든 항목이 통과할 때까지 테스트를 다시 실행하게 합니다. 3. 빌드와 테스트가 모두 통과한 뒤에만 다음 단계로 진행합니다. -아직 Git에 기록한 내용은 없습니다. 다음 단계인 `/init`은 현재 상태의 프로젝트를 읽으므로, 먼저 프로젝트가 정상적으로 작동하는지 확인하는 것이 좋습니다. +아직 Git에 기록한 내용은 없습니다. 다음 레슨에서는 `/init create simple rules for the project`를 실행합니다. 현재 상태의 프로젝트를 읽으므로, 먼저 프로젝트가 정상적으로 작동하는지 확인하는 것이 좋습니다. ## 요약 및 다음 단계 세션의 작업 대상을 확인하고 브라우저 수준의 스모크 테스트로 퀴즈를 검증했습니다. [레슨 4: 프로젝트 지침 작성][next-lesson]을 계속 진행합니다. [next-lesson]: ../4-project-instructions/ +[publish-lesson]: ../5-publish/ diff --git a/docs/ko-kr/first-steps/copilot-app/4-project-instructions.md b/docs/ko-kr/first-steps/copilot-app/4-project-instructions.md index b0b9a3e9..3c838c6e 100644 --- a/docs/ko-kr/first-steps/copilot-app/4-project-instructions.md +++ b/docs/ko-kr/first-steps/copilot-app/4-project-instructions.md @@ -3,7 +3,7 @@ title: "레슨 4 - 프로젝트 지침 작성" description: "/init을 실행하여 완성된 Space Quiz를 설명하는 에이전트 지침을 생성한 다음, 작업 방식에 맞게 조정합니다." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 이제 퀴즈를 만들고 다듬고 테스트했으므로, 이후 세션에서 이 프로젝트를 어떻게 다뤄야 하는지 기록합니다. 모든 세션이 작업을 시작하기 전에 에이전트 지침을 읽으므로, 프롬프트마다 같은 안내를 반복할 필요가 없습니다. @@ -16,7 +16,9 @@ lastUpdated: 2026-09-28 ## `/init`으로 규칙 기록하기 -1. 앱 세션에서 `/init`을 실행합니다. +`/init` 뒤에 프롬프트를 입력합니다. 명령만 보내면 `Command input required`가 표시될 수 있습니다. + +1. 앱 세션에서 `/init create simple rules for the project`를 실행합니다. 2. 생성된 에이전트 지침 파일을 수락하기 전에 검토합니다. 3. 단일 파일, 의존성 없음, 접근성, 브라우저 테스트 등 이 프로젝트에 맞는 안내만 남깁니다. diff --git a/docs/ko-kr/first-steps/copilot-app/5-publish.md b/docs/ko-kr/first-steps/copilot-app/5-publish.md index f01dc4d2..a6396c34 100644 --- a/docs/ko-kr/first-steps/copilot-app/5-publish.md +++ b/docs/ko-kr/first-steps/copilot-app/5-publish.md @@ -3,7 +3,7 @@ title: "레슨 5 - 프로젝트 게시" description: "로컬 Space Quiz 실험 프로젝트를 공개 GitHub 리포지토리로 전환합니다." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Space Quiz를 게시하여 이슈를 관리하고, 격리된 워크트리(Worktree)를 사용하고, 풀 리퀘스트(Pull request) 워크플로를 완료할 수 있도록 합니다. @@ -23,7 +23,7 @@ Initialize this folder as a Git repository, create an initial commit, and create ``` > [!WARNING] -> 에이전트는 리포지토리를 만들거나 코드를 푸시하기 전에 확인을 요청합니다. 승인하기 전에 제안한 작업과 대상을 검토합니다. +> 승인 설정에 따라 에이전트가 리포지토리를 만들거나 코드를 푸시하기 전에 확인을 요청할 수도 있고, 해당 작업이 자동으로 승인될 수도 있습니다. **Approve all**에서는 별도의 확인 프롬프트가 표시된다고 기대하지 마십시오. 게시 프롬프트를 보내기 전에 설정, 요청한 작업, 대상을 검토합니다. 에이전트가 작업을 마치면 다음을 수행합니다. diff --git a/docs/ko-kr/first-steps/copilot-app/8-review-loop.md b/docs/ko-kr/first-steps/copilot-app/8-review-loop.md index e2ecc338..d0736e2c 100644 --- a/docs/ko-kr/first-steps/copilot-app/8-review-loop.md +++ b/docs/ko-kr/first-steps/copilot-app/8-review-loop.md @@ -3,7 +3,7 @@ title: "레슨 8 - Copilot 검토 사이클 완료" description: "풀 리퀘스트를 만들고, Copilot 검토를 요청하고, 반영할 수 있는 피드백을 처리하고, Agent Merge가 풀 리퀘스트를 병합 가능한 상태로 유지하게 합니다." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 구현한 이슈를 풀 리퀘스트(Pull request)로 만들고, Copilot에 검토를 요청하고, 병합 전에 피드백을 처리합니다. @@ -18,6 +18,11 @@ lastUpdated: 2026-09-28 ## 풀 리퀘스트 생성 및 검토 +> [!IMPORTANT] +> Copilot Free에는 풀 리퀘스트용 Copilot 코드 검토가 포함되지 않습니다. Copilot Student 또는 코드 검토가 포함된 유료 Copilot 플랜을 사용합니다. 조직은 Copilot 라이선스가 없는 구성원을 위해 GitHub.com에서 유료 코드 검토를 활성화할 수도 있습니다. [Copilot 코드 검토 사용 가능 여부][code-review]를 확인하십시오. +> +> 액세스할 수 없다면 1-4단계를 완료하고, 변경 사항을 직접 검토하거나 팀원에게 검토를 요청한 다음, Copilot 검토 피드백에 의존하는 5-9단계는 건너뜁니다. 사람이 남긴 검토 피드백을 처리하고 기능을 다시 테스트한 뒤 병합 섹션으로 진행합니다. + 1. 오른쪽 플라이아웃 패널을 열고 **Changes** 탭을 선택하여 세션에서 변경한 파일을 살펴봅니다. 2. 세션 도구 모음에서 **Create PR**을 선택합니다. 3. 생성된 제목과 설명을 검토한 다음 풀 리퀘스트를 만듭니다. @@ -41,4 +46,5 @@ lastUpdated: 2026-09-28 이슈부터 검토와 병합을 마친 풀 리퀘스트까지 개발 사이클을 완료했습니다. [레슨 9: 이슈 분류 자동화][next-lesson]를 계속 진행합니다. +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../9-automations/ diff --git a/docs/ko-kr/first-steps/copilot-cli/2-project-instructions.md b/docs/ko-kr/first-steps/copilot-cli/2-project-instructions.md index 0fa7b0ce..1ee55863 100644 --- a/docs/ko-kr/first-steps/copilot-cli/2-project-instructions.md +++ b/docs/ko-kr/first-steps/copilot-cli/2-project-instructions.md @@ -3,7 +3,7 @@ title: "레슨 2 - 프로젝트 지침 작성" description: "/init을 실행하여 완성된 Space Quiz를 설명하는 에이전트 지침을 생성한 다음, 작업 방식에 맞게 조정합니다." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 디스크에 정상적으로 작동하는 퀴즈가 있으므로 실제 프로젝트를 설명하는 에이전트 지침을 생성합니다. 이후 모든 세션은 작업을 시작하기 전에 이 지침을 읽으므로, 프롬프트마다 같은 안내를 반복할 필요가 없습니다. @@ -16,7 +16,9 @@ lastUpdated: 2026-09-28 ## `/init`으로 규칙 기록하기 -1. 세션에서 `/init`을 실행합니다. +`/init` 뒤에 프롬프트를 입력합니다. 명령만 보내면 `Command input required`가 표시될 수 있습니다. + +1. 세션에서 `/init create simple rules for the project`를 실행합니다. 2. 생성된 지침 파일을 수락하기 전에 검토합니다. 3. 단일 파일, 의존성 없음, 접근성, 브라우저 테스트 등 이 프로젝트에 맞는 안내만 남깁니다. diff --git a/docs/ko-kr/first-steps/vscode/0-prerequisites.md b/docs/ko-kr/first-steps/vscode/0-prerequisites.md index 139ce369..e4a75d52 100644 --- a/docs/ko-kr/first-steps/vscode/0-prerequisites.md +++ b/docs/ko-kr/first-steps/vscode/0-prerequisites.md @@ -24,6 +24,9 @@ lastUpdated: 2026-10-05 - [Visual Studio Code][vscode]. - 설치된 [Git][git]. 터미널에서 `git --version`을 실행하여 확인합니다. +> [!IMPORTANT] +> Copilot Free에는 풀 리퀘스트용 Copilot 코드 검토가 포함되지 않습니다. [레슨 8][review-lesson]에서 검토를 요청하려면 [Copilot 코드 검토 액세스][code-review]가 필요합니다. 액세스할 수 없다면 해당 레슨의 수동 검토 대안을 따릅니다. + ## VS Code 설정 1. [VS Code][vscode]를 설치하고 GitHub에 로그인합니다. Copilot과 Copilot Chat은 기본 제공되므로 제목 표시줄에서 **Chat** 보기를 열고 응답하는지 확인합니다. @@ -51,4 +54,6 @@ VS Code에 Copilot Chat, GitHub 확장, 빈 `space-quiz` 폴더가 준비되었 [git]: https://git-scm.com/downloads [pr-extension]: https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing +[review-lesson]: ../8-review-and-merge/ +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../1-build-and-polish/ diff --git a/docs/ko-kr/first-steps/vscode/2-project-instructions.md b/docs/ko-kr/first-steps/vscode/2-project-instructions.md index ae05205e..f4e9afb3 100644 --- a/docs/ko-kr/first-steps/vscode/2-project-instructions.md +++ b/docs/ko-kr/first-steps/vscode/2-project-instructions.md @@ -3,7 +3,7 @@ title: "레슨 2 - 프로젝트 지침 작성" description: "Copilot Chat에서 /init을 실행하여 Space Quiz의 .github/copilot-instructions.md를 생성한 다음 조정합니다." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 워크스페이스에 정상적으로 작동하는 퀴즈가 있으므로 실제 프로젝트를 설명하는 리포지토리 커스텀 지침을 생성합니다. Copilot은 채팅 요청마다 이 지침을 읽습니다. @@ -16,7 +16,7 @@ lastUpdated: 2026-09-28 ## `/init`으로 규칙 기록하기 -1. Copilot Chat에서 `/init`을 실행합니다. +1. Copilot Chat에서 `/init create simple rules for the project`를 실행합니다. 2. 생성된 `.github/copilot-instructions.md` 파일을 저장하기 전에 검토합니다. 3. 단일 파일, 의존성 없음, 접근성, 브라우저 테스트 등 이 프로젝트에 맞는 안내만 남깁니다. diff --git a/docs/ko-kr/first-steps/vscode/8-review-and-merge.md b/docs/ko-kr/first-steps/vscode/8-review-and-merge.md index 462d22a2..a56b4668 100644 --- a/docs/ko-kr/first-steps/vscode/8-review-and-merge.md +++ b/docs/ko-kr/first-steps/vscode/8-review-and-merge.md @@ -3,7 +3,7 @@ title: "레슨 8 - 검토 및 병합" description: "Source Control에서 풀 리퀘스트를 만들고, Copilot 코드 검토를 요청하고, GitHub 도구로 피드백을 처리하고, 병합합니다." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- VS Code의 GitHub 도구로 새 작업을 살펴보고 검토하고 병합합니다. @@ -17,6 +17,11 @@ VS Code의 GitHub 도구로 새 작업을 살펴보고 검토하고 병합합니 ## 확인, 검토, 병합 +> [!IMPORTANT] +> Copilot Free에는 풀 리퀘스트용 Copilot 코드 검토가 포함되지 않습니다. Copilot Student 또는 코드 검토가 포함된 유료 Copilot 플랜을 사용합니다. 조직은 Copilot 라이선스가 없는 구성원을 위해 GitHub.com에서 유료 코드 검토를 활성화할 수도 있지만, 이를 통해 IDE 코드 검토 액세스가 부여되지는 않습니다. [Copilot 코드 검토 사용 가능 여부][code-review]를 확인하십시오. +> +> 액세스할 수 없다면 4단계의 Copilot 검토 요청은 건너뜁니다. 변경 사항을 직접 검토하거나 팀원에게 검토를 요청한 다음 나머지 단계를 진행합니다. 병합 전에 사람이 남긴 검토 피드백을 처리하고 다시 테스트합니다. + 1. 무언가를 만들기 전에 **Source Control**을 열어 변경된 파일과 변경 사항을 살펴봅니다. 2. **sparkle** 버튼을 다시 사용하여 메시지를 작성하고 새 작업을 커밋합니다. 3. **Source Control**에 나타나는 **Create Pull Request** 버튼을 선택합니다. Copilot은 커밋을 바탕으로 제목과 설명 초안을 작성하므로 처음부터 작성하도록 요청하는 것보다 더 나은 풀 리퀘스트를 얻을 수 있습니다. @@ -32,4 +37,5 @@ VS Code의 GitHub 도구로 새 작업을 살펴보고 검토하고 병합합니 VS Code를 벗어나지 않고 풀 리퀘스트를 검토하고 병합했습니다. [레슨 9: 다음 아이디어를 클라우드 세션에 맡기기][next-lesson]를 계속 진행합니다. +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../9-cloud-session/ diff --git a/docs/pt-br/first-steps/copilot-app/0-prerequisites.md b/docs/pt-br/first-steps/copilot-app/0-prerequisites.md index 22c2a69e..3b751b13 100644 --- a/docs/pt-br/first-steps/copilot-app/0-prerequisites.md +++ b/docs/pt-br/first-steps/copilot-app/0-prerequisites.md @@ -24,6 +24,9 @@ Você precisa de: - um plano ativo do Copilot. [Ative o Copilot Free ou um plano pago do Copilot][copilot-plans]. Se sua organização já oferece acesso ao Copilot, use essa conta. - um computador com macOS, Windows ou Linux. +> [!IMPORTANT] +> O Copilot Free não inclui a revisão de código do Copilot para pull requests. A solicitação de revisão na [Lição 8][review-lesson] exige [acesso à revisão de código do Copilot][code-review]. Se não tiver acesso, siga a alternativa de revisão manual dessa lição. + O aplicativo vem com o Git, então não é necessário instalar mais nada. > [!NOTE] @@ -75,4 +78,6 @@ Você verificou os pré-requisitos, instalou o aplicativo, escolheu um modelo e [copilot-plans]: https://github.com/features/copilot/plans [download-app]: https://gh.io/app [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing +[review-lesson]: ../8-review-loop/ +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../1-create-workspace/ diff --git a/docs/pt-br/first-steps/copilot-app/3-inspect-and-test.md b/docs/pt-br/first-steps/copilot-app/3-inspect-and-test.md index 5a68fc23..3c73d3eb 100644 --- a/docs/pt-br/first-steps/copilot-app/3-inspect-and-test.md +++ b/docs/pt-br/first-steps/copilot-app/3-inspect-and-test.md @@ -3,7 +3,7 @@ title: "Lição 3 - Inspecionar a sessão e testar o quiz" description: "Leia os detalhes da sessão para confirmar em que o agente está trabalhando e execute um teste básico de funcionamento no navegador antes de qualquer gravação no Git." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Agora que a sessão realizou trabalho de verdade, há algo para inspecionar. Confirme qual é o alvo do trabalho do agente e, depois, deixe que ele opere o quiz no navegador integrado e relate o que realmente aconteceu, em vez do que pretendia fazer. @@ -11,25 +11,28 @@ Agora que a sessão realizou trabalho de verdade, há algo para inspecionar. Con Nesta lição, você vai: - ler o painel de detalhes da sessão. -- verificar o projeto, o caminho, a branch, as alterações e o uso de contexto da sessão. +- verificar o projeto, o caminho e o uso de contexto da sessão. - executar um teste básico de funcionamento no navegador e corrigir eventuais falhas. ## Ler os detalhes da sessão Os detalhes da sessão mostram exatamente em que o agente está trabalhando. Você não precisa observar esse painel o tempo todo, mas tudo nele importa quando um resultado surpreende você. -![Ilustração do painel de detalhes da sessão de criação do Space Quiz no aplicativo Copilot. Ele mostra a branch main a partir de origin/main, o caminho, o projeto, o nome da sessão, o ID da sessão e o agente, um arquivo alterado, contagens de tokens, uso de contexto de 27%, gasto da sessão e opções para habilitar o controle remoto, renomear, ver informações, compartilhar como um gist secreto ou arquivar a sessão.](../../../_images/first-steps-app-session-details.svg) +Neste momento, o Space Quiz ainda é uma pasta local, não um repositório Git. Verifique o projeto, o caminho e o uso de contexto. Depois de [publicar o projeto na Lição 5][publish-lesson], as sessões que usam Git mostram detalhes adicionais, como a branch e **Changes**. -O painel mostra onde o trabalho acontece, o que mudou e quanto da janela de contexto está ocupado. Não há uma linha de modelo, porque você escolhe o modelo para cada solicitação na caixa de composição. +A ilustração abaixo mostra uma sessão posterior que usa Git. Os campos de branch e **Changes** ainda não estão disponíveis na sessão de pasta local. -1. Confirme que **project**, **path** e **branch** correspondem ao que você acredita estar editando. -2. Leia **Changes** para ver se esta sessão já alterou alguma coisa. -3. Verifique **context usage**. Conforme o uso aumenta, o agente tem menos espaço para a tarefa em si, e esse é o sinal para iniciar uma nova sessão. +![Ilustração do painel de detalhes de uma sessão do Space Quiz que usa Git no aplicativo Copilot. Ele mostra a branch main a partir de origin/main, o caminho, o projeto, o nome da sessão, o ID da sessão e o agente, um arquivo alterado, contagens de tokens, uso de contexto de 27%, gasto da sessão e opções para habilitar o controle remoto, renomear, ver informações, compartilhar como um gist secreto ou arquivar a sessão.](../../../_images/first-steps-app-session-details.svg) + +O painel mostra onde o trabalho acontece e quanto da janela de contexto está ocupado. Não há uma linha de modelo, porque você escolhe o modelo para cada solicitação na caixa de composição. + +1. Confirme que **project** e **path** correspondem ao que você acredita estar editando. +2. Verifique **context usage**. Conforme o uso aumenta, o agente tem menos espaço para a tarefa em si, e esse é o sinal para iniciar uma nova sessão. > [!TIP] > **A maioria dos resultados ruins vem de problemas de contexto** > -> Uma branch errada, uma pasta errada ou uma janela de contexto quase cheia explicam muito mais surpresas do que um prompt ruim. +> Uma pasta errada ou uma janela de contexto quase cheia explicam muito mais surpresas do que um prompt ruim. ## Testar antes de qualquer gravação no Git @@ -43,10 +46,11 @@ Run a browser-level smoke test for the quiz in the integrated browser. Check key 2. Se algo falhar, deixe o agente corrigir o problema e executar o teste novamente até que tudo passe. 3. Avance apenas quando a criação do projeto e o teste tiverem sido concluídos com sucesso. -Nada foi gravado no Git ainda. O próximo passo é `/init`, que lê o projeto no estado atual, então vale a pena garantir primeiro que o projeto funciona. +Nada foi gravado no Git ainda. Na próxima lição, você executará `/init create simple rules for the project`, que lê o projeto no estado atual, então vale a pena garantir primeiro que o projeto funciona. ## Resumo e próximos passos Você confirmou em que a sessão está trabalhando e verificou o quiz com um teste básico de funcionamento no navegador. Continue com a [Lição 4: Registrar instruções do projeto][next-lesson]. [next-lesson]: ../4-project-instructions/ +[publish-lesson]: ../5-publish/ diff --git a/docs/pt-br/first-steps/copilot-app/4-project-instructions.md b/docs/pt-br/first-steps/copilot-app/4-project-instructions.md index 6fbd8828..25cfb516 100644 --- a/docs/pt-br/first-steps/copilot-app/4-project-instructions.md +++ b/docs/pt-br/first-steps/copilot-app/4-project-instructions.md @@ -3,7 +3,7 @@ title: "Lição 4 - Registrar instruções do projeto" description: "Execute /init para gerar instruções para o agente que descrevam o Space Quiz concluído e adapte-as à sua forma de trabalhar." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Agora que o quiz foi criado, aprimorado e testado, registre como as futuras sessões devem tratar este projeto. As instruções para o agente são lidas por todas as sessões antes do início do trabalho, para que você não precise repetir as mesmas orientações em todos os prompts. @@ -16,7 +16,9 @@ Nesta lição, você vai: ## Registrar as regras com `/init` -1. Execute `/init` na sessão do aplicativo. +Inclua um prompt depois de `/init`. Enviar apenas o comando pode exibir `Command input required`. + +1. Execute `/init create simple rules for the project` na sessão do aplicativo. 2. Revise o arquivo gerado de instruções para o agente antes de aceitá-lo. 3. Enxugue-o para manter orientações que reflitam este projeto: um único arquivo, sem dependências, acessível e testado no navegador. diff --git a/docs/pt-br/first-steps/copilot-app/5-publish.md b/docs/pt-br/first-steps/copilot-app/5-publish.md index 3f87ea39..c44e7d17 100644 --- a/docs/pt-br/first-steps/copilot-app/5-publish.md +++ b/docs/pt-br/first-steps/copilot-app/5-publish.md @@ -3,7 +3,7 @@ title: "Lição 5 - Publicar o projeto" description: "Transforme o experimento local do Space Quiz em um repositório público no GitHub." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Publique o Space Quiz para gerenciar issues, usar worktrees isoladas e concluir um fluxo de trabalho com pull requests. @@ -23,7 +23,7 @@ Initialize this folder as a Git repository, create an initial commit, and create ``` > [!WARNING] -> O agente pedirá confirmação antes de criar um repositório ou enviar código. Revise a ação proposta e o destino antes de aprovar. +> Dependendo das configurações de aprovação, o agente pode pedir confirmação antes de criar um repositório ou enviar código, ou essas ações podem ser aprovadas automaticamente. Com **Approve all**, não espere um prompt de confirmação separado. Revise as configurações, a ação solicitada e o destino antes de enviar o prompt de publicação. Quando o agente terminar: diff --git a/docs/pt-br/first-steps/copilot-app/8-review-loop.md b/docs/pt-br/first-steps/copilot-app/8-review-loop.md index b9427735..560017ee 100644 --- a/docs/pt-br/first-steps/copilot-app/8-review-loop.md +++ b/docs/pt-br/first-steps/copilot-app/8-review-loop.md @@ -3,7 +3,7 @@ title: "Lição 8 - Concluir o ciclo de revisão do Copilot" description: "Crie um pull request, solicite uma revisão do Copilot, trate o feedback que exige ação e deixe o Agent Merge manter o pull request em boas condições." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Transforme a issue implementada em um pull request, solicite uma revisão do Copilot e trate o feedback antes de mesclar. @@ -18,6 +18,11 @@ Nesta lição, você vai: ## Criar e revisar o pull request +> [!IMPORTANT] +> O Copilot Free não inclui a revisão de código do Copilot para pull requests. Use o Copilot Student ou um plano pago do Copilot que inclua revisão de código. Uma organização também pode habilitar a revisão de código paga no GitHub.com para membros sem uma licença do Copilot. Consulte a [disponibilidade da revisão de código do Copilot][code-review]. +> +> Se não tiver acesso, conclua os passos 1-4, revise o diff por conta própria ou peça a um colega de equipe para revisá-lo e pule os passos 5-9, que dependem do feedback da revisão do Copilot. Trate o feedback de revisores humanos e teste o recurso novamente antes de continuar para a seção de mesclagem. + 1. Abra o painel lateral à direita e selecione a aba **Changes** para inspecionar os arquivos alterados na sessão. 2. Selecione **Create PR** na barra de ferramentas da sessão. 3. Revise o título e a descrição gerados e crie o pull request. @@ -41,4 +46,5 @@ Se preferir mesclar por conta própria, revise o diff final, verifique o recurso Você concluiu o ciclo de desenvolvimento, da issue ao pull request revisado e mesclado. Continue com a [Lição 9: Automatizar a triagem de issues][next-lesson]. +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../9-automations/ diff --git a/docs/pt-br/first-steps/copilot-cli/2-project-instructions.md b/docs/pt-br/first-steps/copilot-cli/2-project-instructions.md index 5aeb4c34..e5e66c6a 100644 --- a/docs/pt-br/first-steps/copilot-cli/2-project-instructions.md +++ b/docs/pt-br/first-steps/copilot-cli/2-project-instructions.md @@ -3,7 +3,7 @@ title: "Lição 2 - Registrar instruções do projeto" description: "Execute /init para gerar instruções para o agente que descrevam o Space Quiz concluído e adapte-as à sua forma de trabalhar." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Com um quiz funcional salvo em disco, gere instruções para o agente que descrevam o projeto real. Todas as futuras sessões leem essas instruções antes do início do trabalho, para que você não precise repetir as mesmas orientações em todos os prompts. @@ -16,7 +16,9 @@ Nesta lição, você vai: ## Registrar as regras com `/init` -1. Execute `/init` na sessão. +Inclua um prompt depois de `/init`. Enviar apenas o comando pode exibir `Command input required`. + +1. Execute `/init create simple rules for the project` na sessão. 2. Revise o arquivo de instruções gerado antes de aceitá-lo. 3. Mantenha apenas orientações que correspondam a este projeto: um único arquivo, sem dependências, acessível e testado no navegador. diff --git a/docs/pt-br/first-steps/vscode/0-prerequisites.md b/docs/pt-br/first-steps/vscode/0-prerequisites.md index d183992e..499768c6 100644 --- a/docs/pt-br/first-steps/vscode/0-prerequisites.md +++ b/docs/pt-br/first-steps/vscode/0-prerequisites.md @@ -24,6 +24,9 @@ Você precisa de: - [Visual Studio Code][vscode]. - [Git][git] instalado. Execute `git --version` em um terminal para verificar. +> [!IMPORTANT] +> O Copilot Free não inclui a revisão de código do Copilot para pull requests. A solicitação de revisão na [Lição 8][review-lesson] exige [acesso à revisão de código do Copilot][code-review]. Se não tiver acesso, siga a alternativa de revisão manual dessa lição. + ## Configurar o VS Code 1. Instale o [VS Code][vscode] e faça login no GitHub. O Copilot e o Copilot Chat são integrados, então abra a visualização **Chat** pela barra de título e confirme que ela responde. @@ -51,4 +54,6 @@ O VS Code está pronto com o Copilot Chat, a extensão do GitHub e uma pasta `sp [git]: https://git-scm.com/downloads [pr-extension]: https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing +[review-lesson]: ../8-review-and-merge/ +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../1-build-and-polish/ diff --git a/docs/pt-br/first-steps/vscode/2-project-instructions.md b/docs/pt-br/first-steps/vscode/2-project-instructions.md index 95ae5f21..707fd71e 100644 --- a/docs/pt-br/first-steps/vscode/2-project-instructions.md +++ b/docs/pt-br/first-steps/vscode/2-project-instructions.md @@ -3,7 +3,7 @@ title: "Lição 2 - Registrar instruções do projeto" description: "Execute /init no Copilot Chat para gerar .github/copilot-instructions.md para o Space Quiz e adapte o arquivo." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Com um quiz funcional no espaço de trabalho, gere instruções personalizadas do repositório que descrevam o projeto real. O Copilot lê essas instruções em todas as solicitações de conversa. @@ -16,7 +16,7 @@ Nesta lição, você vai: ## Registrar as regras com `/init` -1. Execute `/init` no Copilot Chat. +1. Execute `/init create simple rules for the project` no Copilot Chat. 2. Revise o arquivo `.github/copilot-instructions.md` gerado antes de salvá-lo. 3. Mantenha apenas orientações que correspondam a este projeto: um único arquivo, sem dependências, acessível e testado no navegador. diff --git a/docs/pt-br/first-steps/vscode/8-review-and-merge.md b/docs/pt-br/first-steps/vscode/8-review-and-merge.md index 83911380..fcf537b2 100644 --- a/docs/pt-br/first-steps/vscode/8-review-and-merge.md +++ b/docs/pt-br/first-steps/vscode/8-review-and-merge.md @@ -3,7 +3,7 @@ title: "Lição 8 - Revisar e mesclar" description: "Crie um pull request em Source Control, solicite uma revisão de código do Copilot, trate o feedback com as ferramentas do GitHub e mescle." authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- Inspecione, revise e mescle o novo trabalho com as ferramentas do GitHub no VS Code. @@ -17,6 +17,11 @@ Nesta lição, você vai: ## Inspecionar, revisar e mesclar +> [!IMPORTANT] +> O Copilot Free não inclui a revisão de código do Copilot para pull requests. Use o Copilot Student ou um plano pago do Copilot que inclua revisão de código. Uma organização também pode habilitar a revisão de código paga no GitHub.com para membros sem uma licença do Copilot, mas isso não concede acesso à revisão de código nos IDEs. Consulte a [disponibilidade da revisão de código do Copilot][code-review]. +> +> Se não tiver acesso, pule a solicitação de revisão do Copilot no passo 4. Revise o diff por conta própria ou peça a um colega de equipe para revisá-lo e continue com os passos restantes, tratando o feedback de revisores humanos e testando novamente antes de mesclar. + 1. Abra **Source Control** para inspecionar os arquivos alterados e o diff antes de criar qualquer coisa. 2. Faça commit do novo trabalho, usando o botão de **brilho** para escrever a mensagem novamente. 3. Selecione o botão **Create Pull Request** que aparece em **Source Control**. O Copilot redige o título e a descrição a partir dos commits, para que você obtenha um pull request melhor do que se pedisse um do zero. @@ -32,4 +37,5 @@ Nesta lição, você vai: Você revisou e mesclou um pull request sem sair do VS Code. Continue com a [Lição 9: Passar a próxima ideia para uma sessão na nuvem][next-lesson]. +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../9-cloud-session/ diff --git a/docs/zh-cn/first-steps/copilot-app/0-prerequisites.md b/docs/zh-cn/first-steps/copilot-app/0-prerequisites.md index 605a6595..7f9c9252 100644 --- a/docs/zh-cn/first-steps/copilot-app/0-prerequisites.md +++ b/docs/zh-cn/first-steps/copilot-app/0-prerequisites.md @@ -24,6 +24,9 @@ lastUpdated: 2026-10-05 - 有效的 Copilot 计划。[启用 Copilot Free 或付费 Copilot 计划][copilot-plans]。如果组织已提供 Copilot 访问权限，使用对应账户。 - 一台运行 macOS、Windows 或 Linux 的计算机。 +> [!IMPORTANT] +> Copilot Free 不包含针对拉取请求的 Copilot 代码审查。[第 8 课][review-lesson]中的审查请求需要 [Copilot 代码审查访问权限][code-review]。如果没有访问权限，按照该课的手动审查替代方案操作。 + 应用自带 Git，无需再安装其他软件。 > [!NOTE] @@ -75,4 +78,6 @@ How does the GitHub Copilot app use worktrees? [copilot-plans]: https://github.com/features/copilot/plans [download-app]: https://gh.io/app [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing +[review-lesson]: ../8-review-loop/ +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../1-create-workspace/ diff --git a/docs/zh-cn/first-steps/copilot-app/3-inspect-and-test.md b/docs/zh-cn/first-steps/copilot-app/3-inspect-and-test.md index 07b3a157..8665621c 100644 --- a/docs/zh-cn/first-steps/copilot-app/3-inspect-and-test.md +++ b/docs/zh-cn/first-steps/copilot-app/3-inspect-and-test.md @@ -3,7 +3,7 @@ title: "第 3 课 - 检查会话并测试测验" description: "查看会话详情，确认智能体正在处理的内容，然后在向 Git 写入任何内容之前运行浏览器级冒烟测试。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 会话已经完成实际工作，现在有内容可以检查了。确认智能体的工作目标，然后让它在集成浏览器中操作测验，报告实际发生的情况，而不是预期会发生的情况。 @@ -11,25 +11,28 @@ lastUpdated: 2026-09-28 本课将： - 查看会话详情面板。 -- 检查会话的项目、路径、分支、更改和上下文使用量。 +- 检查会话的项目、路径和上下文使用量。 - 运行浏览器级冒烟测试，并修复所有失败项。 ## 查看会话详情 会话详情准确显示智能体正在处理的内容。无需时刻关注这个面板，但当结果出乎意料时，其中的每一项都值得检查。 -![Copilot app 中 Space Quiz 构建会话的详情面板示意图。面板显示基于 origin/main 的 main 分支、路径、项目、会话名称、会话 ID、智能体、一个已更改的文件、token 数量、27% 的上下文使用量、会话费用，以及启用远程控制、重命名、查看洞察、以机密 gist 分享或归档会话的选项。](../../../_images/first-steps-app-session-details.svg) +此时，Space Quiz 仍是本地文件夹，而不是 Git 存储库。检查项目、路径和上下文使用量。[在第 5 课发布项目][publish-lesson]后，基于 Git 的会话会显示分支和 **Changes** 等更多详情。 -面板显示工作位置、更改内容，以及上下文窗口的使用程度。这里没有模型行，因为模型是在输入区域中为每次请求单独选择的。 +下图展示的是后续阶段基于 Git 的会话。本地文件夹会话中尚无分支和 **Changes** 字段。 -1. 确认 **project**、**path** 和 **branch** 与预期编辑的目标一致。 -2. 查看 **Changes**，了解会话是否已修改任何内容。 -3. 检查 **context usage**。使用量越高，留给实际任务的空间越少，这时就该启动新会话。 +![Copilot app 中基于 Git 的 Space Quiz 会话详情面板示意图。面板显示基于 origin/main 的 main 分支、路径、项目、会话名称、会话 ID、智能体、一个已更改的文件、token 数量、27% 的上下文使用量、会话费用，以及启用远程控制、重命名、查看洞察、以机密 gist 分享或归档会话的选项。](../../../_images/first-steps-app-session-details.svg) + +面板显示工作位置和上下文窗口的使用程度。这里没有模型行，因为模型是在输入区域中为每次请求单独选择的。 + +1. 确认 **project** 和 **path** 与预期编辑的目标一致。 +2. 检查 **context usage**。使用量越高，留给实际任务的空间越少，这时就该启动新会话。 > [!TIP] > **大多数不理想的结果都源于上下文问题** > -> 分支错误、文件夹错误或上下文窗口接近耗尽，比提示词不佳更常导致意外结果。 +> 文件夹错误或上下文窗口接近耗尽，比提示词不佳更常导致意外结果。 ## 在向 Git 写入任何内容之前测试 @@ -43,10 +46,11 @@ Run a browser-level smoke test for the quiz in the integrated browser. Check key 2. 如果有任何失败项，让智能体修复并重新测试，直到全部通过。 3. 只有构建和测试都通过后才继续。 -目前尚未向 Git 写入任何内容。下一步的 `/init` 会读取项目的当前状态，因此值得先确认项目能正常工作。 +目前尚未向 Git 写入任何内容。下一课将运行 `/init create simple rules for the project`，它会读取项目的当前状态，因此值得先确认项目能正常工作。 ## 总结与后续步骤 已经确认会话正在处理的内容，并通过浏览器级冒烟测试验证了测验。继续学习[第 4 课：记录项目指令][next-lesson]。 [next-lesson]: ../4-project-instructions/ +[publish-lesson]: ../5-publish/ diff --git a/docs/zh-cn/first-steps/copilot-app/4-project-instructions.md b/docs/zh-cn/first-steps/copilot-app/4-project-instructions.md index 0202fffe..580337e4 100644 --- a/docs/zh-cn/first-steps/copilot-app/4-project-instructions.md +++ b/docs/zh-cn/first-steps/copilot-app/4-project-instructions.md @@ -3,7 +3,7 @@ title: "第 4 课 - 记录项目指令" description: "运行 /init，生成描述已完成 Space Quiz 的智能体指令，再根据工作习惯调整。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 测验已经完成构建、优化和测试，现在记录后续会话应如何处理项目。每个会话开始工作前都会读取智能体指令，省去在每个提示词中重复相同要求的麻烦。 @@ -16,7 +16,9 @@ lastUpdated: 2026-09-28 ## 使用 `/init` 记录规则 -1. 在应用会话中运行 `/init`。 +在 `/init` 后添加提示词。只发送命令本身可能会出现 `Command input required`。 + +1. 在应用会话中运行 `/init create simple rules for the project`。 2. 接受生成的智能体指令文件之前先审查。 3. 将内容精简为符合项目的指导：单文件、无依赖项、支持无障碍，并经过浏览器测试。 diff --git a/docs/zh-cn/first-steps/copilot-app/5-publish.md b/docs/zh-cn/first-steps/copilot-app/5-publish.md index 159fca10..311889dd 100644 --- a/docs/zh-cn/first-steps/copilot-app/5-publish.md +++ b/docs/zh-cn/first-steps/copilot-app/5-publish.md @@ -3,7 +3,7 @@ title: "第 5 课 - 发布项目" description: "将本地 Space Quiz 实验项目发布为公开的 GitHub 存储库。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 发布 Space Quiz，以便管理议题、使用隔离的工作树，并完成拉取请求工作流。 @@ -23,7 +23,7 @@ Initialize this folder as a Git repository, create an initial commit, and create ``` > [!WARNING] -> 创建存储库或推送代码之前，智能体会要求确认。批准之前，先审查拟执行的操作和目标位置。 +> 根据审批设置，智能体可能在创建存储库或推送代码前要求确认，也可能自动批准这些操作。启用 **Approve all** 时，不要指望出现单独的确认提示。发送发布提示词前，先审查设置、请求的操作和目标位置。 智能体完成后： diff --git a/docs/zh-cn/first-steps/copilot-app/8-review-loop.md b/docs/zh-cn/first-steps/copilot-app/8-review-loop.md index 01795ec3..ed035a09 100644 --- a/docs/zh-cn/first-steps/copilot-app/8-review-loop.md +++ b/docs/zh-cn/first-steps/copilot-app/8-review-loop.md @@ -3,7 +3,7 @@ title: "第 8 课 - 完成 Copilot 审查流程" description: "创建拉取请求，请求 Copilot 审查，处理可执行的反馈，并让 Agent Merge 持续维护拉取请求。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 将已实现的议题提交为拉取请求，请求 Copilot 审查，并在合并前处理反馈。 @@ -18,6 +18,11 @@ lastUpdated: 2026-09-28 ## 创建并审查拉取请求 +> [!IMPORTANT] +> Copilot Free 不包含针对拉取请求的 Copilot 代码审查。使用 Copilot Student 或包含代码审查的付费 Copilot 计划。组织也可以为没有 Copilot 许可证的成员启用 GitHub.com 上的付费代码审查。查看 [Copilot 代码审查的可用性说明][code-review]。 +> +> 如果没有访问权限，完成步骤 1-4，自行审查差异或请团队成员审查，然后跳过依赖 Copilot 审查反馈的步骤 5-9。处理人工审查反馈并重新测试功能后，再继续合并部分。 + 1. 打开右侧弹出面板，选择 **Changes** 选项卡，检查会话中更改的文件。 2. 在会话工具栏中选择 **Create PR**。 3. 审查生成的标题和描述，然后创建拉取请求。 @@ -41,4 +46,5 @@ lastUpdated: 2026-09-28 已经完成从议题到经过审查并合并的拉取请求的开发流程。继续学习[第 9 课：自动化议题分类][next-lesson]。 +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../9-automations/ diff --git a/docs/zh-cn/first-steps/copilot-cli/2-project-instructions.md b/docs/zh-cn/first-steps/copilot-cli/2-project-instructions.md index e752d5e0..8f17a578 100644 --- a/docs/zh-cn/first-steps/copilot-cli/2-project-instructions.md +++ b/docs/zh-cn/first-steps/copilot-cli/2-project-instructions.md @@ -3,7 +3,7 @@ title: "第 2 课 - 记录项目指令" description: "运行 /init，生成描述已完成 Space Quiz 的智能体指令，再根据工作习惯调整。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 磁盘上已有可正常运行的测验，现在生成描述真实项目的智能体指令。后续每个会话开始工作前都会读取这些指令，省去在每个提示词中重复相同要求的麻烦。 @@ -16,7 +16,9 @@ lastUpdated: 2026-09-28 ## 使用 `/init` 记录规则 -1. 在会话中运行 `/init`。 +在 `/init` 后添加提示词。只发送命令本身可能会出现 `Command input required`。 + +1. 在会话中运行 `/init create simple rules for the project`。 2. 接受生成的指令文件之前先审查。 3. 只保留符合项目的指导：单文件、无依赖项、支持无障碍，并经过浏览器测试。 diff --git a/docs/zh-cn/first-steps/vscode/0-prerequisites.md b/docs/zh-cn/first-steps/vscode/0-prerequisites.md index ef4f5191..69321f95 100644 --- a/docs/zh-cn/first-steps/vscode/0-prerequisites.md +++ b/docs/zh-cn/first-steps/vscode/0-prerequisites.md @@ -24,6 +24,9 @@ lastUpdated: 2026-10-05 - [Visual Studio Code][vscode]。 - 已安装 [Git][git]。在终端中运行 `git --version` 验证。 +> [!IMPORTANT] +> Copilot Free 不包含针对拉取请求的 Copilot 代码审查。[第 8 课][review-lesson]中的审查请求需要 [Copilot 代码审查访问权限][code-review]。如果没有访问权限，按照该课的手动审查替代方案操作。 + ## 设置 VS Code 1. 安装 [VS Code][vscode] 并登录 GitHub。Copilot 和 Copilot Chat 已内置，因此从标题栏打开 **Chat** 视图，确认它能正常响应。 @@ -51,4 +54,6 @@ VS Code 已准备就绪，具备 Copilot Chat、GitHub 扩展和空的 `space-qu [git]: https://git-scm.com/downloads [pr-extension]: https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing +[review-lesson]: ../8-review-and-merge/ +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../1-build-and-polish/ diff --git a/docs/zh-cn/first-steps/vscode/2-project-instructions.md b/docs/zh-cn/first-steps/vscode/2-project-instructions.md index 8a1ff2b3..b17ee4fe 100644 --- a/docs/zh-cn/first-steps/vscode/2-project-instructions.md +++ b/docs/zh-cn/first-steps/vscode/2-project-instructions.md @@ -3,7 +3,7 @@ title: "第 2 课 - 记录项目指令" description: "在 Copilot Chat 中运行 /init，为 Space Quiz 生成 .github/copilot-instructions.md，然后进行调整。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 工作区中已有可正常运行的测验，现在生成描述真实项目的存储库自定义指令。Copilot 会在每次聊天请求时读取这些指令。 @@ -16,7 +16,7 @@ lastUpdated: 2026-09-28 ## 使用 `/init` 记录规则 -1. 在 Copilot Chat 中运行 `/init`。 +1. 在 Copilot Chat 中运行 `/init create simple rules for the project`。 2. 保存生成的 `.github/copilot-instructions.md` 文件之前先审查。 3. 只保留符合项目的指导：单文件、无依赖项、支持无障碍，并经过浏览器测试。 diff --git a/docs/zh-cn/first-steps/vscode/8-review-and-merge.md b/docs/zh-cn/first-steps/vscode/8-review-and-merge.md index 5f66d605..b2ea4a4f 100644 --- a/docs/zh-cn/first-steps/vscode/8-review-and-merge.md +++ b/docs/zh-cn/first-steps/vscode/8-review-and-merge.md @@ -3,7 +3,7 @@ title: "第 8 课 - 审查与合并" description: "从 Source Control 创建拉取请求，请求 Copilot 代码审查，使用 GitHub 工具处理反馈，然后合并。" authors: - jamesmontemagno -lastUpdated: 2026-09-28 +lastUpdated: 2026-10-05 --- 使用 VS Code 中的 GitHub 工具检查、审查并合并新工作。 @@ -17,6 +17,11 @@ lastUpdated: 2026-09-28 ## 检查、审查与合并 +> [!IMPORTANT] +> Copilot Free 不包含针对拉取请求的 Copilot 代码审查。使用 Copilot Student 或包含代码审查的付费 Copilot 计划。组织也可以为没有 Copilot 许可证的成员启用 GitHub.com 上的付费代码审查，但这不会授予 IDE 中的代码审查访问权限。查看 [Copilot 代码审查的可用性说明][code-review]。 +> +> 如果没有访问权限，跳过步骤 4 中的 Copilot 审查请求。自行审查差异或请团队成员审查，然后继续其余步骤，在合并前处理人工审查反馈并重新测试。 + 1. 打开 **Source Control**，在创建任何内容之前先检查已更改的文件和差异。 2. 提交新工作，再次使用 **sparkle** 按钮编写消息。 3. 选择 **Source Control** 中出现的 **Create Pull Request** 按钮。Copilot 会根据提交起草标题和描述，比从零开始请求生成的拉取请求更完善。 @@ -32,4 +37,5 @@ lastUpdated: 2026-09-28 已经在不离开 VS Code 的情况下审查并合并拉取请求。继续学习[第 9 课：将下一个想法交给云会话][next-lesson]。 +[code-review]: https://docs.github.com/copilot/concepts/agents/code-review [next-lesson]: ../9-cloud-session/