Skip to content

Commit 46edeb4

Browse files
authored
Merge pull request #1 from copilot-dev-days/incorporate-upstream-pr75
Incorporate upstream PR #75: Custom Tasks → Custom Skills, updated UI…
2 parents 1891c93 + 36f7667 commit 46edeb4

11 files changed

+52
-49
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -140,7 +140,7 @@ The workshop covers:
140140
- Installing GitHub Copilot app modernization
141141
- Assessing your Java application
142142
- Upgrading runtime & frameworks (Java 8 → 21, Spring Boot 2.x → 3.x)
143-
- Exposing health endpoints using custom tasks
143+
- Exposing health endpoints using custom skills
144144
- Containerizing applications
145145

146146

WORKSHOP.md

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ The following sections guide you through the process of modernizing the sample J
88
- [Install GitHub Copilot app modernization](#install-github-copilot-app-modernization)
99
- [Assess Your Java Application](#assess-your-java-application)
1010
- [Upgrade Runtime & Frameworks](#upgrade-runtime--frameworks)
11-
- [Expose health endpoints using Custom Tasks](#expose-health-endpoints-using-custom-tasks)
11+
- [Expose health endpoints using Custom Skills](#expose-health-endpoints-using-custom-skills)
1212
- [Containerize Applications](#containerize-applications)
1313

1414
## Prerequisites
@@ -51,13 +51,13 @@ Alternatively, you can use IntelliJ IDEA. Open **File** > **Settings** (or **Int
5151
The first step is to assess the sample Java application `asset-manager`. The assessment provides insights into the application's readiness for migration to Azure.
5252

5353
1. Open VS Code with all the prerequisites installed for the asset manager by changing the directory to the `asset-manager` directory and running `code .` in that directory.
54-
1. Open the `GitHub Copilot app modernization` extension.
55-
1. In the **QUICKSTART** view, click the **Migrate to Azure** button to trigger app assessment.
54+
1. In the Activity sidebar, open the **GitHub Copilot app modernization** extension pane.
55+
1. In the **QUICKSTART** section, click **Start Assessment** to trigger the app assessment.
5656

5757
![Trigger Assessment](doc-media/trigger-assessment.png)
5858

59-
1. Wait for the assessment to be completed and the report to be generated.
60-
1. Review the **Assessment Report**. Select the **Issues** tab to view the proposed solutions for the issues identified in the report.
59+
1. Wait for the assessment to be completed. This step could take several minutes.
60+
1. Upon completion, an **Assessment Report** tab opens. This report provides a categorized view of cloud readiness issues and recommended solutions. Select the **Issues** tab to view proposed solutions and proceed with migration steps.
6161

6262
## Upgrade Runtime & Frameworks
6363

@@ -68,31 +68,33 @@ The first step is to assess the sample Java application `asset-manager`. The ass
6868

6969
> Note: The upgrading tool also supports upgrading to JDK 25 (the latest LTS version). To do this, click on the generated chat message, edit the target Java version to 25, and then click **Send** to apply the change.
7070
71-
## Expose health endpoints using Custom Tasks
71+
## Expose health endpoints using Custom Skills
7272

73-
In this section, you will use custom tasks to expose health endpoints for your applications instead of writing code yourself. The following steps demonstrate how to generate custom tasks based on external web links and proper prompts.
73+
In this section, you will use custom skills to expose health endpoints for your applications instead of writing code yourself. The following steps demonstrate how to create a custom skill with references and proper prompts.
7474

75-
> Note: Custom tasks are not supported for the IntelliJ IDEA plugin. If you are using IntelliJ IDEA, you can skip this section.
75+
> Note: Custom skills (My Skills) are not supported for the IntelliJ IDEA plugin. If you are using IntelliJ IDEA, you can skip this section.
7676
77-
1. Open the sidebar of `GITHUB COPILOT APP MODERNIZATION`. Click the `+` button in the **Tasks** view to create a custom task.
77+
1. In the Activity sidebar, open the **GitHub Copilot app modernization** extension pane. Hover over the **TASKS** section, and then select **Create a Custom Skill**.
7878

79-
![Create Formula From Source Control](doc-media/create-formula-from-source-control.png)
80-
1. In the opened tab, enter the **Task Name** and **Task Prompt** as shown below:
81-
- **Task Name**: Expose health endpoint via Spring Boot Actuator
82-
- **Task Prompt**: You are a Spring Boot developer assistant, follow the Spring Boot Actuator documentation to add basic health endpoints for Azure Container Apps deployment.
83-
1. Click the **Add References** button to add the Spring Boot Actuator official documentation as references.
79+
![Create Custom Skill](doc-media/create-formula-from-source-control.png)
80+
1. A **Create a Skill** form opens with the following fields. Fill them in as shown below:
81+
- **Skill Name**: `expose-health-endpoint`
82+
- **Skill Description**: `This skill helps add Spring Boot Actuator health endpoints for Azure Container Apps deployment readiness.`
83+
- **Skill Content**: `You are a Spring Boot developer assistant, follow the Spring Boot Actuator documentation to add basic health endpoints for Azure Container Apps deployment.`
8484

85-
![Health endpoint task](doc-media/health-endpoint-task.png)
86-
1. In the popped-up quick-pick window, select **External links**. Then paste the following link: `https://docs.spring.io/spring-boot/reference/actuator/endpoints.html`. Click **Save** to create the task.
87-
1. Click the **Run** button to trigger the custom task.
88-
1. Follow the same steps as the predefined task to review and apply the changes.
85+
1. Click **Add Resources** to add the Spring Boot Actuator official documentation as a resource. Paste the following link: `https://docs.spring.io/spring-boot/reference/actuator/endpoints.html`.
86+
87+
![Create a Skill form](doc-media/health-endpoint-task.png)
88+
1. Click **Save** to create the skill. Your custom skill now appears in the **TASKS** > **My Skills** section.
89+
1. Click **Run** to execute it.
90+
1. The Copilot chat window opens in Agent Mode and automatically generates the migration plan, checks out a new branch, performs code changes, and runs the validation and fix iteration loop. Click **Allow** for any tool call requests from the agent.
8991
1. Review the proposed code changes and click **Keep** to apply them.
9092

9193
## Containerize Applications
9294

9395
Now that you have completed the upgrade and health endpoint steps, the next step is to prepare your application for cloud deployment by containerizing both the web and worker modules. In this section, you will use **Containerization Tasks** to containerize your applications.
9496

95-
1. Open the sidebar of `GITHUB COPILOT APP MODERNIZATION`. In **Tasks** view, click the **Run Task** button of **Java** -> **Containerization Tasks** -> **Containerize Application**.
97+
1. In the Activity sidebar, open the **GitHub Copilot app modernization** extension pane. In the **TASKS** section, expand **Common Tasks** > **Containerize Tasks** and click the run button for **Containerize Application**.
9698

9799
![Run Containerize Application task](doc-media/containerization-run-task.png)
98100

17.1 KB
Loading
-4.62 KB
Loading

doc-media/deployment-run-task.png

39.3 KB
Loading

doc-media/health-endpoint-task.png

16.9 KB
Loading

doc-media/trigger-assessment.png

4.91 KB
Loading

workshop/00-overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,12 +31,12 @@ The complete workshop takes approximately **35 minutes** to complete:
3131
| 01 | [Prerequisites & Setup](01-prerequisites.md) | Install tools and clone the repository |
3232
| 02 | [Assess Your Application](02-assess.md) | Run the assessment to analyze your app |
3333
| 03 | [Upgrade Runtime & Frameworks](03-upgrade.md) | Upgrade Java and Spring Boot versions |
34-
| 04 | [Health Endpoints](04-health-endpoints.md) | Expose health endpoints using custom tasks |
34+
| 04 | [Health Endpoints](04-health-endpoints.md) | Expose health endpoints using custom skills |
3535
| 05 | [Containerize Applications](05-containerize.md) | Prepare your app for cloud deployment |
3636

3737
## What You'll Learn
3838

3939
- How to use **GitHub Copilot app modernization** to assess legacy Java applications
4040
- How to upgrade Java versions and Spring Boot frameworks with AI assistance
41-
- How to create **custom tasks** for specialized modernization needs
41+
- How to create **custom skills** for specialized modernization needs
4242
- How to containerize Java applications for cloud deployment

workshop/02-assess.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,13 @@ Run the GitHub Copilot app modernization assessment on the `asset-manager` appli
77
## Run the Assessment
88

99
1. Open VS Code with all the prerequisites installed for the asset manager by changing the directory to the `asset-manager` directory and running `code .` in that directory.
10-
1. Open the `GitHub Copilot app modernization` extension.
11-
1. In the **QUICKSTART** view, click the **Migrate to Azure** button to trigger app assessment.
10+
1. In the Activity sidebar, open the **GitHub Copilot app modernization** extension pane.
11+
1. In the **QUICKSTART** section, click **Start Assessment** to trigger the app assessment.
1212

1313
![Trigger Assessment](../doc-media/trigger-assessment.png)
1414

15-
1. Wait for the assessment to be completed and the report to be generated.
16-
1. Review the **Assessment Report**. Select the **Issues** tab to view the proposed solutions for the issues identified in the report.
15+
1. Wait for the assessment to be completed. This step could take several minutes.
16+
1. Upon completion, an **Assessment Report** tab opens. This report provides a categorized view of cloud readiness issues and recommended solutions. Select the **Issues** tab to view proposed solutions and proceed with migration steps.
1717

1818
## Understanding the Assessment Report
1919

@@ -28,6 +28,6 @@ The assessment report provides:
2828
2929
## ✅ Checkpoint
3030

31-
- [ ] Assessment triggered from the QUICKSTART view
31+
- [ ] Assessment triggered from the QUICKSTART section
3232
- [ ] Assessment report generated successfully
3333
- [ ] Issues tab reviewed with proposed solutions

workshop/04-health-endpoints.md

Lines changed: 21 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,50 @@
1-
# Step 4: Expose Health Endpoints using Custom Tasks
1+
# Step 4: Expose Health Endpoints using Custom Skills
22

33
## 🎯 Goal
44

5-
Use custom tasks to expose health endpoints for your applications using Spring Boot Actuator, without writing code yourself.
5+
Use custom skills to expose health endpoints for your applications using Spring Boot Actuator, without writing code yourself.
66

77
> [!NOTE]
8-
> Custom tasks are not supported for the IntelliJ IDEA plugin. If you are using IntelliJ IDEA, you can skip this section.
8+
> Custom skills (My Skills) are not supported for the IntelliJ IDEA plugin. If you are using IntelliJ IDEA, you can skip this section.
99
10-
## Create a Custom Task
10+
## Create a Custom Skill
1111

12-
1. Open the sidebar of `GITHUB COPILOT APP MODERNIZATION`. Click the `+` button in the **Tasks** view to create a custom task.
12+
1. In the Activity sidebar, open the **GitHub Copilot app modernization** extension pane. Hover over the **TASKS** section, and then select **Create a Custom Skill**.
1313

14-
![Create Formula From Source Control](../doc-media/create-formula-from-source-control.png)
14+
![Create Custom Skill](../doc-media/create-formula-from-source-control.png)
1515

16-
1. In the opened tab, enter the **Task Name** and **Task Prompt** as shown below:
17-
- **Task Name**: Expose health endpoint via Spring Boot Actuator
18-
- **Task Prompt**: You are a Spring Boot developer assistant, follow the Spring Boot Actuator documentation to add basic health endpoints for Azure Container Apps deployment.
16+
1. A **Create a Skill** form opens with the following fields. Fill them in as shown below:
17+
- **Skill Name**: `expose-health-endpoint`
18+
- **Skill Description**: `This skill helps add Spring Boot Actuator health endpoints for Azure Container Apps deployment readiness.`
19+
- **Skill Content**: `You are a Spring Boot developer assistant, follow the Spring Boot Actuator documentation to add basic health endpoints for Azure Container Apps deployment.`
1920

20-
1. Click the **Add References** button to add the Spring Boot Actuator official documentation as references.
21+
1. Click **Add Resources** to add the Spring Boot Actuator official documentation as a resource. Paste the following link: `https://docs.spring.io/spring-boot/reference/actuator/endpoints.html`.
2122

22-
![Health endpoint task](../doc-media/health-endpoint-task.png)
23+
![Create a Skill form](../doc-media/health-endpoint-task.png)
2324

24-
1. In the popped-up quick-pick window, select **External links**. Then paste the following link: `https://docs.spring.io/spring-boot/reference/actuator/endpoints.html`. Click **Save** to create the task.
25+
1. Click **Save** to create the skill. Your custom skill now appears in the **TASKS** > **My Skills** section.
2526

26-
## Run the Custom Task
27+
## Run the Custom Skill
2728

28-
1. Click the **Run** button to trigger the custom task.
29-
1. Follow the same steps as the predefined task to review and apply the changes.
29+
1. Click **Run** to execute it.
30+
1. The Copilot chat window opens in Agent Mode and automatically generates the migration plan, checks out a new branch, performs code changes, and runs the validation and fix iteration loop. Click **Allow** for any tool call requests from the agent.
3031
1. Review the proposed code changes and click **Keep** to apply them.
3132

3233
## What This Does
3334

34-
The custom task will:
35+
The custom skill will:
3536
- Add the Spring Boot Actuator dependency to `pom.xml`
3637
- Configure health endpoints in `application.properties` or `application.yml`
3738
- Expose `/actuator/health` endpoint for Azure Container Apps health probes
3839
- This is essential for cloud deployment where the platform needs to check if your app is healthy
3940

4041
> [!TIP]
41-
> Custom tasks are a powerful feature of GitHub Copilot app modernization. You can create tasks for any modernization need by providing a descriptive prompt and relevant documentation references.
42+
> Custom skills are a powerful feature of GitHub Copilot app modernization. You can create skills for any modernization need by providing a descriptive prompt and relevant documentation references.
4243
4344
## ✅ Checkpoint
4445

45-
- [ ] Custom task created with the correct name and prompt
46-
- [ ] Spring Boot Actuator documentation added as reference
47-
- [ ] Task executed successfully
46+
- [ ] Custom skill created with the correct name and prompt
47+
- [ ] Spring Boot Actuator documentation added as resource
48+
- [ ] Skill executed successfully
4849
- [ ] Health endpoint code changes reviewed and applied
4950
- [ ] `/actuator/health` endpoint will be available when the app runs

0 commit comments

Comments
 (0)