From e002c3f239169f253d8fcb8f92091c513eb7539f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Amaury=20Lev=C3=A9?= Date: Fri, 28 Aug 2026 18:46:01 +0200 Subject: [PATCH 1/2] Add testing agent skills guidance Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../testing/microsoft-testing-platform-ai.md | 17 ++++++++++++++++- ...grating-vstest-microsoft-testing-platform.md | 5 ++++- 2 files changed, 20 insertions(+), 2 deletions(-) diff --git a/docs/core/testing/microsoft-testing-platform-ai.md b/docs/core/testing/microsoft-testing-platform-ai.md index 91feccf7581b5..f895035ff8cf0 100644 --- a/docs/core/testing/microsoft-testing-platform-ai.md +++ b/docs/core/testing/microsoft-testing-platform-ai.md @@ -3,7 +3,7 @@ title: Microsoft.Testing.Platform (MTP) AI integrations description: Learn how MTP extensions access AI chat clients and configure the Azure AI Foundry provider. author: Evangelink ms.author: amauryleve -ms.date: 08/26/2026 +ms.date: 08/28/2026 ai-usage: ai-assisted --- @@ -14,6 +14,21 @@ The experimental [Microsoft.Testing.Platform.AI](https://www.nuget.org/packages/ > [!IMPORTANT] > The AI APIs use the `TPEXP` diagnostic ID and can change in a future release. The packages supply infrastructure to extensions; they don't add AI behavior to a test suite by themselves. +## Use AI coding tools for test workflows + +The packages in this article let MTP extensions call AI models at test run time. To use an AI coding assistant to create, analyze, or migrate tests in your repository, use the curated [.NET Agent Skills](https://github.com/dotnet/skills) instead. + +Choose a workflow based on your goal: + +| Goal | Skill or agent | +|---|---| +| Create or extend tests | Use the [`code-testing-agent` skill](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test/skills/code-testing-agent) from the [`dotnet-test` plugin](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test). The skill researches the codebase, plans the work, implements tests, and verifies the changes. | +| Audit test quality | Use the [`test-quality-auditor` agent](https://github.com/dotnet/skills/blob/main/plugins/dotnet-test/agents/test-quality-auditor.agent.md) for a broad assessment, or invoke a focused `dotnet-test` skill for assertions, coverage, test gaps, or test smells. | +| Improve testability | Use the [`testability-migration` agent](https://github.com/dotnet/skills/blob/main/plugins/dotnet-test/agents/testability-migration.agent.md) to find static dependencies and introduce testable abstractions. | +| Migrate a test framework or platform | Use the [`test-migration` agent](https://github.com/dotnet/skills/blob/main/plugins/dotnet-test-migration/agents/test-migration.agent.md) from the [`dotnet-test-migration` plugin](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test-migration). The agent detects the current setup and selects the appropriate migration skill. | + +For installation steps and supported coding agents, see the [.NET Agent Skills repository](https://github.com/dotnet/skills#installation). Install `dotnet-test` alongside `dotnet-test-migration` because migration workflows reuse its platform detection and test verification skills. + ## Choose the packages Add the abstractions package when you author an extension that consumes a chat client. Add a provider package to the test application that hosts the extension: diff --git a/docs/core/testing/migrating-vstest-microsoft-testing-platform.md b/docs/core/testing/migrating-vstest-microsoft-testing-platform.md index 11ec53c1026c5..8d89bf2047561 100644 --- a/docs/core/testing/migrating-vstest-microsoft-testing-platform.md +++ b/docs/core/testing/migrating-vstest-microsoft-testing-platform.md @@ -3,7 +3,7 @@ title: Migration guide from VSTest to Microsoft.Testing.Platform (MTP) description: Step-by-step guide to migrate from VSTest to Microsoft.Testing.Platform (MTP), including argument mapping, project configuration, and CI pipeline updates. author: Youssef1313 ms.author: ygerges -ms.date: 08/26/2026 +ms.date: 08/28/2026 ai-usage: ai-assisted --- @@ -19,6 +19,9 @@ If you need detailed behavior of `dotnet test` modes, see [Testing with `dotnet If you need a single list of platform and extension command-line options, see [MTP CLI options reference](./microsoft-testing-platform-cli-options.md). +> [!TIP] +> To automate a repository-wide migration, install the [`dotnet-test`](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test) and [`dotnet-test-migration`](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test-migration) plugins. Ask the [`test-migration` agent](https://github.com/dotnet/skills/blob/main/plugins/dotnet-test-migration/agents/test-migration.agent.md) to detect and migrate your test setup, or invoke the [`migrate-vstest-to-mtp` skill](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test-migration/skills/migrate-vstest-to-mtp) for this specific migration. Review the generated changes before you merge them. + ## Opt-in to use MTP The first step in the migration is to opt-in to using MTP. From a22229be8bd934bfafa688233f3acb489d271950 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Amaury=20Lev=C3=A9?= Date: Fri, 28 Aug 2026 18:55:06 +0200 Subject: [PATCH 2/2] Address testing skills documentation feedback Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/core/testing/microsoft-testing-platform-ai.md | 5 +++-- docs/core/testing/microsoft-testing-platform-hot-reload.md | 4 +++- .../testing/migrating-vstest-microsoft-testing-platform.md | 2 +- 3 files changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/core/testing/microsoft-testing-platform-ai.md b/docs/core/testing/microsoft-testing-platform-ai.md index f895035ff8cf0..753e9d64b8c19 100644 --- a/docs/core/testing/microsoft-testing-platform-ai.md +++ b/docs/core/testing/microsoft-testing-platform-ai.md @@ -16,14 +16,15 @@ The experimental [Microsoft.Testing.Platform.AI](https://www.nuget.org/packages/ ## Use AI coding tools for test workflows -The packages in this article let MTP extensions call AI models at test run time. To use an AI coding assistant to create, analyze, or migrate tests in your repository, use the curated [.NET Agent Skills](https://github.com/dotnet/skills) instead. +The packages in this article let MTP extensions call AI models during a test run. To use an AI coding assistant to create, analyze, or migrate tests in your repository, use the curated [.NET Agent Skills](https://github.com/dotnet/skills) instead. Choose a workflow based on your goal: | Goal | Skill or agent | |---|---| | Create or extend tests | Use the [`code-testing-agent` skill](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test/skills/code-testing-agent) from the [`dotnet-test` plugin](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test). The skill researches the codebase, plans the work, implements tests, and verifies the changes. | -| Audit test quality | Use the [`test-quality-auditor` agent](https://github.com/dotnet/skills/blob/main/plugins/dotnet-test/agents/test-quality-auditor.agent.md) for a broad assessment, or invoke a focused `dotnet-test` skill for assertions, coverage, test gaps, or test smells. | +| Run or troubleshoot tests | Use the [`run-tests` skill](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test/skills/run-tests) to execute tests or diagnose test execution without changing test code. | +| Audit test quality | Use the [`test-quality-auditor` agent](https://github.com/dotnet/skills/blob/main/plugins/dotnet-test/agents/test-quality-auditor.agent.md) for a broad assessment, or invoke a focused skill from the [`dotnet-test` skills directory](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test/skills) for assertions, coverage, test gaps, or test smells. | | Improve testability | Use the [`testability-migration` agent](https://github.com/dotnet/skills/blob/main/plugins/dotnet-test/agents/testability-migration.agent.md) to find static dependencies and introduce testable abstractions. | | Migrate a test framework or platform | Use the [`test-migration` agent](https://github.com/dotnet/skills/blob/main/plugins/dotnet-test-migration/agents/test-migration.agent.md) from the [`dotnet-test-migration` plugin](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test-migration). The agent detects the current setup and selects the appropriate migration skill. | diff --git a/docs/core/testing/microsoft-testing-platform-hot-reload.md b/docs/core/testing/microsoft-testing-platform-hot-reload.md index 51987d5053468..f961040f1ebc0 100644 --- a/docs/core/testing/microsoft-testing-platform-hot-reload.md +++ b/docs/core/testing/microsoft-testing-platform-hot-reload.md @@ -3,7 +3,7 @@ title: Microsoft.Testing.Platform (MTP) Hot Reload description: Learn about the MTP Hot Reload extension for running tests with hot reload. author: evangelink ms.author: amauryleve -ms.date: 02/25/2026 +ms.date: 08/28/2026 ai-usage: ai-assisted --- @@ -25,6 +25,8 @@ builder.TestHost.AddHotReloadProvider(); Hot reload lets you modify your app's managed source code while the application is running, without the need to manually pause or hit a breakpoint. Simply make a supported change while the app is running and select the **Apply code changes** button in Visual Studio to apply your edits. +If you use an AI coding assistant, the [`mtp-hot-reload` .NET Agent Skill](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test/skills/mtp-hot-reload) guides the assistant through setup and recovery from unsupported edits. This skill isn't an MTP extension or CLI plugin. + > [!NOTE] > The current version is limited to supporting hot reload in "console mode" only. There is currently no support for hot reload in Test Explorer for Visual Studio or Visual Studio Code. diff --git a/docs/core/testing/migrating-vstest-microsoft-testing-platform.md b/docs/core/testing/migrating-vstest-microsoft-testing-platform.md index 8d89bf2047561..a1f327ed29eb6 100644 --- a/docs/core/testing/migrating-vstest-microsoft-testing-platform.md +++ b/docs/core/testing/migrating-vstest-microsoft-testing-platform.md @@ -20,7 +20,7 @@ If you need detailed behavior of `dotnet test` modes, see [Testing with `dotnet If you need a single list of platform and extension command-line options, see [MTP CLI options reference](./microsoft-testing-platform-cli-options.md). > [!TIP] -> To automate a repository-wide migration, install the [`dotnet-test`](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test) and [`dotnet-test-migration`](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test-migration) plugins. Ask the [`test-migration` agent](https://github.com/dotnet/skills/blob/main/plugins/dotnet-test-migration/agents/test-migration.agent.md) to detect and migrate your test setup, or invoke the [`migrate-vstest-to-mtp` skill](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test-migration/skills/migrate-vstest-to-mtp) for this specific migration. Review the generated changes before you merge them. +> To automate a repository-wide migration with an AI coding assistant, install the [`dotnet-test`](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test) and [`dotnet-test-migration`](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test-migration) plugins from [.NET Agent Skills](https://github.com/dotnet/skills). Ask the [`test-migration` agent](https://github.com/dotnet/skills/blob/main/plugins/dotnet-test-migration/agents/test-migration.agent.md) to detect and migrate your test setup, or invoke the [`migrate-vstest-to-mtp` skill](https://github.com/dotnet/skills/tree/main/plugins/dotnet-test-migration/skills/migrate-vstest-to-mtp) for this specific migration. Review the generated changes before you merge them. ## Opt-in to use MTP