You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/skills/release-notes/SKILL.md
+13-4Lines changed: 13 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -80,15 +80,24 @@ Exclude anyone already listed as a PR author. Format:
80
80
```
81
81
Reviewers go on a single bullet, sorted by number of PRs reviewed (most first), without citing the count.
82
82
83
-
### Step 6: Final Assembly
83
+
### Step 6: Preamble
84
84
85
-
1.**Preamble** — summarize the release theme. If there are breaking changes, mention them and link to the [C# SDK Versioning](https://modelcontextprotocol.github.io/csharp-sdk/versioning.html) docs. Do not repeat preamble text under the Breaking Changes heading. Let the user revise or omit.
85
+
Compose a short preamble summarizing the release theme.
86
+
87
+
-**New release**: Draft a preamble based on the categorized changes. If there are breaking changes, mention them and link to the [C# SDK Versioning](https://modelcontextprotocol.github.io/csharp-sdk/versioning.html) docs.
88
+
-**Editing an existing release**: Extract the current preamble from the release body (text before the first `##` heading) and present it alongside a newly drafted alternative.
89
+
90
+
Present the options and let the user choose one, edit one, or enter their own text or markdown. Do not repeat preamble text under the Breaking Changes heading.
91
+
92
+
### Step 7: Final Assembly
93
+
94
+
1. Combine the confirmed preamble with all sections from previous steps.
86
95
2.**Notable callouts** — only if something is extraordinarily noteworthy.
87
96
3. Present the **complete release notes** for user approval.
88
97
89
98
Follow [references/formatting.md](references/formatting.md) when composing and updating the release body.
90
99
91
-
### Step 7: Create or Update Draft Release
100
+
### Step 8: Create or Update Draft Release
92
101
93
102
Display release metadata for user review:
94
103
-**Title / Tag**: e.g. `v0.9.0-preview.1`
@@ -103,7 +112,7 @@ After confirmation:
103
112
104
113
When the user requests revisions after the initial update, always rewrite the complete body as a file — never perform in-place string replacements. See [references/formatting.md](references/formatting.md).
105
114
106
-
### Step 8: Bump Version
115
+
### Step 9: Bump Version
107
116
108
117
After the draft release is created or updated, inform the user that the draft release is now associated with a known target commit (state the short SHA and commit message) and recommend proceeding with a version bump. Ask if they want to create a pull request to bump the version for the next release. If yes, invoke the **bump-version** skill and let it handle determining or requesting the target version number.
Copy file name to clipboardExpand all lines: .github/skills/release-notes/references/formatting.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@ When the user requests changes to existing release notes:
21
21
22
22
1. Fetch the current release body and save it to a local file
23
23
2. Write the **entire** corrected body to a separate local file (ensuring proper line breaks between all sections, entries, and paragraphs)
24
-
3.**If the release is already published** (not a draft): run `git diff --no-index` between the original and updated files and present the raw diff output to the user. Do not summarize — show the diff and nothing else. Require explicit confirmation before uploading. Before uploading, offer to save the original body to a permanent local file, noting that GitHub does not retain prior versions of release notes.
24
+
3.**If the release is already published** (not a draft): run `git diff --no-index` between the original and updated files and present the raw diff output directly in the response as a fenced code block with `diff` syntax highlighting. Do not summarize or paraphrase the diff. Require explicit confirmation before uploading. Before uploading, offer to save the original body to a permanent local file, noting that GitHub does not retain prior versions of release notes.
25
25
4. Upload the complete file using `gh release edit --notes-file <file>`
26
26
5. Verify the result by fetching the body again and checking that line count and structure are intact
0 commit comments