diff --git a/docs/core/testing/microsoft-testing-platform-ai.md b/docs/core/testing/microsoft-testing-platform-ai.md index 91feccf7581b5..753e9d64b8c19 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,22 @@ 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 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. | +| 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. | + +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/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 11ec53c1026c5..a1f327ed29eb6 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 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 The first step in the migration is to opt-in to using MTP.