Skip to content

Add sprint-check, issue-cleanup, and hotfix-release skills#8217

Open
rajeshkamal5050 wants to merge 4 commits into
mainfrom
feature/engsys-skills-v3
Open

Add sprint-check, issue-cleanup, and hotfix-release skills#8217
rajeshkamal5050 wants to merge 4 commits into
mainfrom
feature/engsys-skills-v3

Conversation

@rajeshkamal5050
Copy link
Copy Markdown
Contributor

Partially addresses #8033

Replaces #8134, #8216 (closed — had overlapping commits from #8099)

What

Three new Copilot skills for engineering automation.

sprint-check

Validates sprint readiness — labels, milestones, project fields (Sprint, Priority, Initiative), assignees. Supports personal/team/single-issue scope. Sprint close rollover with bulk move when sprint is ending.

issue-cleanup

Scans backlog for hygiene gaps — missing labels, missing milestones, stale milestone assignments. Flags customer-reported issues sitting without triage.

hotfix-release

Creates a hotfix branch from a release tag, cherry-picks specified PRs, bumps version files (version.txt, azdext/version.go), updates CHANGELOG.md, pushes branch. Handles cherry-pick conflicts interactively. Includes ADO release pipeline guidance and post-release checklist.

Files

  • .github/skills/sprint-check/ — SKILL.md + 2 reference docs (hygiene-rules, project-mutations)
  • .github/skills/issue-cleanup/ — SKILL.md + 1 reference doc (hygiene-rules, synced with sprint-check)
  • .github/skills/hotfix-release/ — SKILL.md + 1 reference doc (version-files)
  • .vscode/cspell.misc.yaml — spelling overrides for new files

rajeshkamal5050 and others added 2 commits May 15, 2026 12:06
Adds three engineering automation skills:

- sprint-check: validates sprint readiness, checks labels/milestones/project
  fields, supports sprint close rollover
- issue-cleanup: scans backlog for hygiene gaps, flags customer-reported
  issues without triage, stale milestones
- hotfix-release: creates hotfix branch from release tag, cherry-picks PRs,
  bumps version files, generates changelog entry

Partially addresses #8033

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
hotfix-release:
- Add Triggering the Release section with ADO pipeline link and steps
- Add Post-Release section (changelog merge-back, no version file merge)
- Fix tags guidance: pipeline creates tags, not manual
- Add Go as optional prerequisite (build verification)
- Remove changelog from version-files.md (avoid Step 5/6 overlap)
- Fix grep -oP to sed for macOS compatibility

sprint-check:
- Add Step 8: Sprint Close / Rollover with bulk move option
- Fix --paginate to manual cursor pagination (tested, doesn't work)
- Sync hygiene-rules.md with issue-cleanup (was drifting)

issue-cleanup:
- Fix hardcoded assignee example to @me
- Fix --milestone "" to --search "no:milestone"

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings May 15, 2026 19:07
@rajeshkamal5050 rajeshkamal5050 added the skip-governance Skip PR governance checks label May 15, 2026
Copy link
Copy Markdown
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

Note

Copilot was unable to run its full agentic suite in this review.

Adds three new GitHub Copilot “workflow skills” to automate sprint readiness checks, backlog hygiene scanning, and hotfix branch/release preparation.

Changes:

  • Added new skills: sprint-check, issue-cleanup, and hotfix-release with step-by-step workflows and reference docs.
  • Documented shared issue hygiene rules and Project V2 GraphQL mutation patterns.
  • Updated cspell overrides for newly introduced domain-specific terms in skill docs.
Show a summary per file
File Description
.vscode/cspell.misc.yaml Adds cspell allowlist overrides for new skill documentation terms.
.github/skills/sprint-check/SKILL.md Defines sprint readiness workflow, queries, reporting, and interactive fixes.
.github/skills/sprint-check/references/hygiene-rules.md Documents validation rules used by sprint-check (and shared with issue-cleanup).
.github/skills/sprint-check/references/project-mutations.md Provides GraphQL examples for Project V2 field reads/mutations used by sprint-check.
.github/skills/issue-cleanup/SKILL.md Defines backlog hygiene scan workflow, reporting, and interactive fixes.
.github/skills/issue-cleanup/references/hygiene-rules.md Duplicates the shared hygiene rules reference for issue-cleanup consumers.
.github/skills/hotfix-release/SKILL.md Defines hotfix workflow from tag through cherry-picks, version bump, changelog update, and push.
.github/skills/hotfix-release/references/version-files.md Documents which version files to update and how to validate consistency.

Copilot's findings

  • Files reviewed: 8/8 changed files
  • Comments generated: 4

Comment thread .github/skills/sprint-check/SKILL.md
Comment thread .github/skills/hotfix-release/SKILL.md Outdated
Comment thread .github/skills/hotfix-release/SKILL.md Outdated
Comment thread .github/skills/sprint-check/SKILL.md Outdated
…ts, description

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Member

@jongio jongio left a comment

Choose a reason for hiding this comment

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

Three new engineering automation skills -- sprint-check, issue-cleanup, and hotfix-release. Structure follows the existing skill pattern well (frontmatter, references dir, cspell overrides).

Summary of findings (2 medium, 2 low):

  • sprint-check body heading still says "issues and PRs" despite the frontmatter fix (incomplete fix from prior feedback)
  • hygiene-rules.md duplicated verbatim across sprint-check and issue-cleanup references
  • hotfix-release suggests force-push as error recovery on a potentially shared branch
  • hotfix-release validates PRs are merged but not that they were merged into main

Comment thread .github/skills/sprint-check/SKILL.md Outdated
Comment thread .github/skills/issue-cleanup/references/hygiene-rules.md Outdated
Comment thread .github/skills/hotfix-release/SKILL.md Outdated
Comment thread .github/skills/hotfix-release/SKILL.md
- Fix sprint-check heading to say 'issues' not 'issues and PRs'
- Deduplicate hygiene-rules.md into _shared/ with symlinks
- Hotfix-release: prefer git pull --rebase before force-push
- Hotfix-release: validate PRs were merged into main, not feature branches

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip-governance Skip PR governance checks

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants