Skip to content

Convert breaking-change-doc workflow to GitHub agentic workflow#126009

Open
ericstj wants to merge 3 commits intodotnet:mainfrom
ericstj:breakingChangeAgentic
Open

Convert breaking-change-doc workflow to GitHub agentic workflow#126009
ericstj wants to merge 3 commits intodotnet:mainfrom
ericstj:breakingChangeAgentic

Conversation

@ericstj
Copy link
Member

@ericstj ericstj commented Mar 24, 2026

Tested skill locally in CLI. We'll add token auth later.

@ericstj ericstj requested a review from jeffhandley March 24, 2026 02:55
@ericstj ericstj requested a review from a team as a code owner March 24, 2026 02:55
Copilot AI review requested due to automatic review settings March 24, 2026 02:55
@github-actions github-actions bot added the area-skills Agent Skills label Mar 24, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR migrates the breaking-change documentation automation from a custom PowerShell script + classic GitHub Actions workflow to a GitHub Agentic Workflow (gh-aw) backed by a dedicated breaking-change-doc skill and helper scripts.

Changes:

  • Removed the legacy eng/breakingChanges/ PowerShell tooling and the previous .github/workflows/breaking-change-doc.yml workflow.
  • Added an agentic workflow source (.md) and its compiled workflow (.lock.yml) to run the breaking-change-doc skill.
  • Added a new skill definition plus helper scripts for version detection and PR-comment/issue-link generation.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
eng/breakingChanges/config.ps1 Removes legacy breaking-change-doc configuration (deleted).
eng/breakingChanges/breaking-change-doc.ps1 Removes legacy all-in-one implementation (deleted).
eng/breakingChanges/README.md Removes documentation for the legacy script-based workflow (deleted).
.github/workflows/breaking-change-doc.yml Removes the previous GitHub Actions workflow (deleted).
.github/workflows/breaking-change-doc.md Adds gh-aw workflow source that instructs the agent to run the breaking-change-doc skill.
.github/workflows/breaking-change-doc.lock.yml Adds the compiled gh-aw workflow that GitHub Actions will execute.
.github/skills/breaking-change-doc/SKILL.md Adds the skill definition and step-by-step process for generating docs issues/comments.
.github/skills/breaking-change-doc/Get-VersionInfo.ps1 Adds git/tag-based version detection used by the skill.
.github/skills/breaking-change-doc/Build-IssueComment.ps1 Adds helper to generate a PR comment containing a pre-filled docs issue link.
.github/aw/actions-lock.json Adds action SHA locking metadata for gh-aw-related actions.
.gitattributes Marks compiled *.lock.yml workflows as generated and uses merge=ours.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 5 comments.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-skills Agent Skills

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants