Backport Changes
Developmentbackport-changesBackport Changes is an Agent Skill for development published in the dotnet/dotnet-docker repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Analyze and backport changes from nightly to the release branch in dotnet/dotnet-docker.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/dotnet/dotnet-docker/blob/HEAD/.github/skills/backport-changes/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/backport-changes, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Backporting Changes
Workflow
- Get candidates for backport: Run
pwsh scripts/Get-BackportPRs.ps1to find PRs to backport. - Analyze PRs - classify each PR using the backport guidelines below and present the analysis table to the user
- Cherry-pick - confirm the plan with the user, then run
git cherry-pick <commits>(in the order they were merged).- If any templates or manifests changed, regenerate Dockerfiles and READMEs. Confirm that the diff looks correct.
- Resolve conflicts - follow the conflict resolution table below; stop and consult the user for anything not covered
Backport guidelines
- Backport:
- New images - if ready for the main branch
- Removal of EOL images - end-of-life image cleanup
- Dockerfile/template changes - structural changes to how images are built
- Image component updates - MinGit, PowerShell, and other tools
- Infrastructure and tooling changes - build scripts, CI/CD updates
- Automated
eng/commonupdates - standard engineering infrastructure
- Do not backport:
- Version-only updates for daily/preview builds (no Dockerfile changes)
- Changes already on the release branch
- Experimental or incomplete features
- Requires extra consideration:
- Daily builds of .NET or appliance images - only backport if they include Dockerfile changes beyond simple version updates.
Output
After analyzing PRs, present results in a table:
| PR | Title | Backport | Reason | Commit |
| --- | --- | --- | --- | --- |
| #1234 | Update PowerShell to X.Y.Z | ✅ Yes | Component update | 123abc... |
| #1235 | Daily build .NET X.Y.Z-preview.Y | ❌ No | Version-only update, no Dockerfile changes | 123abc... |
| #1236 | Add Ubuntu X.Y images | ✅ Yes | New images ready for release | 123abc... |
Conflict resolution
| Conflicting files | Resolution |
|---|---|
src/* | Regenerate Dockerfiles. |
READMEs | Regenerate READMEs. |
manifest.json | Take changes from nightly, ensure latest tags are on the correct (non-preview) versions, then regenerate Dockerfiles and READMEs. |
manifest.versions.json | Keep the latest/most up-to-date versions. |
| Other files | Stop and consult the user. |