AGENT SKILL

post-release-activities

Systematic activities that need to be performed after a release is done.

License 许可
MIT
所属仓库
microsoft/testfx
最近更新
2026-11-14
Stars
★ 1.1k
Forks
315

01 前言 Front Matter

name
post-release-activities
description
Systematic activities that need to be performed after a release is done.

03 SKILL.md 正文

Post-release Activities Skill

When to Use This Skill

Use this skill when assigned an issue asking you to do the post-release activities. You will be given the branch name for the release. If that information is missing, ask for it and don't proceed with doing anything.

Steps to Follow

Step 1: Find the release version

The branch name only contains the major and minor parts of the version, but not the patch part. To find the full version:

  1. Look for eng/Versions.props file in the given branch.
  2. Find the value of VersionPrefix.

Step 2: Tagging the branch

Create a tag for the branch using the version you found in Step 1. The tag name should be v{version} (replace {version} with the version you found in Step 1). After creating the tag, push it to the remote repository.

Step 3: Create a GitHub draft release

  1. Create a file release-notes.md and add the following content to it: See the release notes [here](https://github.com/microsoft/testfx/blob/main/docs/Changelog.md#{version}) (replace {version} with the version you found in Step 1).
  2. Run gh release create v{version} --draft --title v{version} --notes-file release-notes.md.

Step 4: Open a PR to main updating the change log files

  1. Run the following command to get markdown of the changelog: gh api --method POST -H "Accept: application/vnd.github+json" -H "X-GitHub-Api-Version: 2022-11-28" /repos/microsoft/testfx/releases/generate-notes -f 'tag_name=v{version}' (replace {version} with the version you found in Step 1).
  2. Classify each entry as either an MSTest change or a Microsoft.Testing.Platform change.
  3. MSTest changes go to docs/Changelog.md and Microsoft.Testing.Platform changes go to docs/Changelog-Platform.md.
  4. Classify further the changes of each product into categories like "Added", "Changed", "Fixed", etc.
  5. Update the changelog markdown files using the above instructions and following the existing format of those files.
  6. When not confident about the classification of a specific change, indicate in the PR description that it requires attention and manual review. This PR must target the main branch, not the release branch.

Step 5: Create a PR to release branch to update patch version

Open a PR to the release branch to update the patch version in eng/Versions.props file. The new patch version should be one more than the patch version you found in Step 1.

Note that in this step, both TestingPlatformVersionPrefix and VersionPrefix must be updated.

Step 6: Create a PR to main to update minor version

Open a PR to the main branch to update the minor version in eng/Versions.props file. The new minor version should be one more than the minor version you found in Step 1, and the patch version should be reset to 0.

Note that in this step, both TestingPlatformVersionPrefix and VersionPrefix must be updated.

Step 7: Update public samples

Open a PR to the main branch to update the product versions of public samples to latest. Public samples are present in samples/public directory.

Step 8: Mark APIs and analyzers as shipped

  1. Run eng/mark-shipped.ps1 (requires PowerShell 7.0).
  2. Move the contents of src/Analyzers/MSTest.Analyzers/AnalyzerReleases.Unshipped.md (except the first two lines that start with ;) to src/Analyzers/MSTest.Analyzers/AnalyzerReleases.Shipped.md.
  3. In src/Analyzers/MSTest.Analyzers/SuppressionReleases.md, move the rows for suppressors shipped in the release branch from ## Unshipped to ## Release {version} (using the full MSTest version found in Step 1). Create the release section with the existing table format if it does not exist, preserving each suppression ID, suppressed diagnostic ID, and notes. Leave suppressors not included in this release under ## Unshipped, and remove that section if it becomes empty. If no suppressors were shipped from ## Unshipped, leave the catalog unchanged.

Create a PR to main with these changes.

04 同仓库更多 Skills

microsoft
microsoft/testfx

dotnet-breaking-changes

Use before changing .NET/C# code whose callers you do not control: a NuGet library, or a repo with PublicAPI.Shipped/Unshipped.txt, ApiCompat, multiple TargetFrameworks, InternalsVisibleTo, or generated (.g.cs) partials. Green builds miss silent breaks from optional parameters, parameter names, sealing, const values, nullability, and #if. USE FOR: "without breaking existing callers"; adding a public method, overload, optional parameter, or interface member to a shipped library; renaming a public method or an internal helper a friend assembly uses; consolidating duplicated logic; changing a signature, nullability, default, or attribute; adding a target framework; RS0016/RS0017 or ApiCompat errors; "is this PR breaking?". For a rename, extract, or merge, also invoke csharp-refactoring. DO NOT USE FOR: an executable whose callers all live in one project; renaming a local variable or private member, even in a shipped library; formatting; framework/SDK/NuGet upgrades (use dotnet-upgrade).

★ 1.1k
microsoft
microsoft/testfx

testfx-test-value-evidence

Apply the vendored test-value-evidence skill with TestFx toolchain, assertion, parallel-safety, packed-consumer, and review conventions. Use when implementing or reviewing behavior-changing TestFx PRs or commits, including source-only changes.

测试与质量
★ 1.1k
microsoft
microsoft/testfx

testfx-parallel-safety-preflight

Check concurrency and isolation before implementing or refactoring TestFx tests, lifecycle code, helpers, shared-state declarations, or production paths those tests exercise. Use before narrowing DoNotParallelize or ResourceLock, changing parallelization settings, or introducing asynchronous workers; repeat against the final diff.

★ 1.1k
microsoft
microsoft/testfx

testfx-localization-validation

Validate generated TestFx localization catalogs, resource IDs, placeholders and locked tokens. Use for RESX/XLF changes, OneLoc PRs, localization build failures, duplicate targets or units, and orphaned translation entries.

★ 1.1k
microsoft
microsoft/testfx

testfx-acceptance-validation

Validate TestFx shipping paths and capable CI execution using packed consumers, package/cache provenance, exact exits and artifacts, and selected-versus-executed test evidence. Use for acceptance regressions, package/MSBuild/launcher/protocol changes, or skipped-only CI results; not for unrelated unit-only or documentation changes.

测试与质量
★ 1.1k
microsoft
microsoft/testfx

session-delivery-hygiene

Gate local-session scope, persistent delivery, live PR state, integration provenance, and owned cleanup. Use before implementing guidance changes, changing or pushing PR work, diagnosing package/output mismatches, or handing off implementation.

★ 1.1k