release-notes
Installation
SKILL.md
Mole release notes
This skill drives the curated-notes step that runs after release.yml has finished. The workflow creates the GitHub Release with assets but with generate_release_notes: false, so notes must be added in a follow-up gh release edit (never gh release create, the release already exists, and create will conflict).
Inputs to gather
Before drafting, confirm:
- Version. Capital
V, e.g.V1.38.0. Lowercasevdoes not trigger the workflow and may indicate a botched tag. - CodeName + emoji. Ask the user. The title format is
V<version> <CodeName> <emoji>. - Release commit range.
git log <previous-tag>..V<version> --onelinegives the raw material. - User-visible behavior changes. Scan the full commit message bodies (not just subjects) for narrowed detection, removed features, or controlled regressions. These belong in notes even when they are not bug-fix-shaped, because users will encounter the changed boundary in production.
- Issue reporters and PR contributors in this cycle. Derive them from what the release actually contains, never from a date window of closed issues:
git log --format='%an' <prev>..<tag>for contributors, and the issue numbers the range's own commit messages cite for reporters, checking each isstate_reason: completedand was fixed here rather than merely referenced as background. A closing window silently pulls innot_plannedissues and everything the PREVIOUS release fixed, which is how V1.55.0 nearly shipped 30 names where 8 were real. Keep it short, for exampleIssue reporters and PR contributors this cycle: @a · @b.Excludetw93,youxi798and bots. - Verify release exists.
gh release view V<version> --repo tw93/Mole --json id,nameshould return non-empty. If it doesn't, the workflow hasn't finished, wait, don'tgh release create.
Pre-flight (published-tag evidence)
Use the target tag's exact commit and the completed checks and public-asset evidence from release-flow. Reuse that evidence when it still matches the immutable tag; rerun only a missing or failed gate. A build of a newer working tree does not verify the release being described. The full build, test, asset, and script-update gates stay owned by release-flow rather than a second checklist here.