Skip to content

Add a Release-Notes skill#7390

Merged
jeffhandley merged 4 commits intodotnet:mainfrom
jeffhandley:jeffhandley/release-notes
Mar 18, 2026
Merged

Add a Release-Notes skill#7390
jeffhandley merged 4 commits intodotnet:mainfrom
jeffhandley:jeffhandley/release-notes

Conversation

@jeffhandley
Copy link
Member

@jeffhandley jeffhandley commented Mar 12, 2026

This builds on the modelcontextprotocol/csharp-sdk and dotnet/core release notes skills created recently, aligning most closely to the MCP version but updated to reflect the nature of this repo containing many separate features/packages.

It was used to generate the v10.4.0 release notes that were just published and to refresh the v10.3.0 release notes as the v10.4.0 release notes generation led to identifying that some entries were missing from the v10.3.0 release notes.

Microsoft Reviewers: Open in CodeFlow

jeffhandley and others added 2 commits March 11, 2026 19:19
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Objective tone: avoid superlatives, favor factual descriptions
- Preamble is optional with user choice via ask_user
- Release branch-aware dedup: fetch release/ branches, check both tag and branch HEAD
- Dynamic remote detection instead of hardcoded 'origin'
- Attribution must come from stored PR data, never fabricated
- Copilot-authored PR fallback chain: timeline event → assignees → merger
- Co-author trailers collected from all PR commits, not just merge commit
- Experimental audit requires file diff inspection, not title inference
- No attributions in Experimental API Changes section
- PR reviewer acknowledgements via get_reviews (excluding bots/authors)
- Finalization options: draft release, private gist, or cancel
- Diagnostic ID table removed; references docs/list-of-diagnostics.md
- SQL schema adds pr_reviewers table

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@jeffhandley jeffhandley requested a review from joperezr March 12, 2026 06:36
@jeffhandley jeffhandley self-assigned this Mar 12, 2026
@jeffhandley jeffhandley requested a review from a team as a code owner March 12, 2026 06:36
Copilot AI review requested due to automatic review settings March 12, 2026 06:36
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

Adds a new GitHub “skill” for drafting dotnet/extensions release notes, including reference documentation for how to collect PRs, categorize entries by area, track experimental API changes, and store intermediate data in SQL.

Changes:

  • Add the release-notes skill definition and execution flow.
  • Add reference docs for PR collection/deduplication, categorization rules, experimental API tracking, formatting/editorial rules, and SQL schema/query patterns.
  • Define a package-to-area mapping used to group “What’s Changed” entries.

Reviewed changes

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

Show a summary per file
File Description
.github/skills/release-notes/SKILL.md Skill entrypoint and end-to-end process for generating release notes.
.github/skills/release-notes/references/sql-storage.md Proposed SQL schema and common queries for storing/enriching PR and issue data.
.github/skills/release-notes/references/package-areas.md Maps src/Libraries/* packages to area headings used in release notes.
.github/skills/release-notes/references/format-template.md Markdown templates and section rules for full vs patch releases.
.github/skills/release-notes/references/experimental-features.md Guidance for detecting and reporting experimental API lifecycle changes.
.github/skills/release-notes/references/editorial-rules.md Rules for tone, attribution, sorting, and inclusion/exclusion criteria.
.github/skills/release-notes/references/collect-prs.md Instructions for collecting, enriching, deduplicating, and filtering PRs/issues.
.github/skills/release-notes/references/categorize-entries.md Category assignment and grouping/sorting rules for release notes output.

You can also share your feedback on Copilot code review. Take the survey.

jeffhandley and others added 2 commits March 11, 2026 23:44
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
- Add pr_coauthors table to store Co-authored-by trailer data
- Add all-contributors query that unions PR authors and co-authors
  for new-contributor detection in acknowledgements
- Update reviewer acknowledgements query to exclude co-authors
- Add usage note for populating pr_coauthors during enrichment

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@jeffhandley jeffhandley merged commit 99478fd into dotnet:main Mar 18, 2026
2 checks passed
@jeffhandley jeffhandley deleted the jeffhandley/release-notes branch March 18, 2026 07:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants