Introduce an ApiChief skill to streamline updating API baselines#7281
Merged
jeffhandley merged 7 commits intodotnet:mainfrom Feb 21, 2026
Merged
Introduce an ApiChief skill to streamline updating API baselines#7281jeffhandley merged 7 commits intodotnet:mainfrom
jeffhandley merged 7 commits intodotnet:mainfrom
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new GitHub Copilot skill (“run-apichief”) to streamline running the repo’s ApiChief tool and post-processing the generated API baseline files, with documented alias expansion and cleanup/review guidance.
Changes:
- Introduces a
SKILL.mdentrypoint describing the skill’s intent and linking to detailed references. - Adds a shorthand alias/expansion reference for mapping user patterns to
src/Libraries/*. - Adds a step-by-step execution guide for building/running ApiChief and reviewing baseline output.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.
| File | Description |
|---|---|
.github/skills/run-apichief/SKILL.md |
Skill front-matter + high-level instructions and links to references. |
.github/skills/run-apichief/references/apichief-aliases.md |
Defines shorthand aliases and expansion/matching rules for library selection. |
.github/skills/run-apichief/references/apichief-steps.md |
Details the command selection, build/run steps, and baseline cleanup/review workflow. |
Member
|
@jeffhandley could we switch over to using our standard tooling for .NET API backcompat instead of this bespoke mechanism? |
ApiChief baselines are serialized as JSON (System.Text.Json), not YAML. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The build example was Windows-only; include ./build.sh for Linux/macOS. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The *.OpenAI.* pattern won't match names ending with OpenAI (e.g. Microsoft.Extensions.AI.OpenAI). Cover both middle and trailing segments. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Without wildcards, bare expansions like 'Microsoft.Extensions' won't match any folder names via glob. Add trailing .* for consistency. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
MED*/DataIngestion example was misleading since DataIngestion doesn't share a prefix with Diagnostics. Use accurate examples: MEAI*/MEAI.Eval* and MA*/MAD*. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
joperezr
reviewed
Feb 20, 2026
joperezr
reviewed
Feb 20, 2026
joperezr
reviewed
Feb 20, 2026
joperezr
approved these changes
Feb 20, 2026
Member
joperezr
left a comment
joperezr
left a comment
There was a problem hiding this comment.
Minor NITs but this LGTM. Thanks Jeff.
…rrides - Remove the shorthand alias system and subset exclusion rules - Note that users may provide shorthand library references - Auto-select highest net* TFM per library instead of hardcoding net10.0 - Report selected TFM and available targets before running - Allow per-library or blanket TFM overrides Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Each time I've needed to update API baselines using ApiChief, I've needed to do manual massaging of the output, which is part of why this cannot yet be fully automated. This Copilot skill streamlines running it though, and sets us up for delegating the task to Copilot.
Microsoft Reviewers: Open in CodeFlow