← ClaudeAtlas

issue-draft-release-noteslisted

Draft a customer-facing release note for a Jira ticket by gathering the ticket context (summary, description, type, fix version, comments) and any linked GitLab merge requests / code changes, then synthesizing a clear, audience- appropriate release note. Runs a clarity-council quality pass over the draft. Read-only by default; the user may opt in at the end to publish the note as a Jira comment (or into a Release Notes field if one exists). Use when user says "draft release notes", "write a release note", "release note for [TICKET-KEY]", "what changed in this ticket", or invokes /issue-draft-release-notes with a ticket key.
risadams/ink-and-agency · ★ 1 · AI & Automation · score 70
Install: claude install-skill risadams/ink-and-agency
# Issue — Draft Release Notes Read-only drafting of a customer-facing release note for a Jira ticket. Gathers ticket context and related MR code changes, synthesizes a release note matched to the audience, runs a quality pass, and (only on opt-in) posts it back to the ticket. **Read-only by default.** The skill never modifies code, MRs, Confluence, or Jira fields. The single permitted write is in Phase 6 — and only after explicit user opt-in: posting the note as a Jira comment, or setting a Release Notes field. ## Input A Jira ticket key — pattern `[A-Z][A-Z0-9]+-\d+` (e.g. `PRJ-1234`). Extract from the user's message. If no key is present, ask for one. Default project key (if the user gives only a number) is read from memory (`reference_jira_default_project.md`). ## Workflow ```text Release-Notes Progress: - [ ] Phase 1: Gather ticket context - [ ] Phase 2: Find & analyze related MRs / code changes - [ ] Phase 3: Determine audience & note type - [ ] Phase 4: Draft the release note - [ ] Phase 5: Quality pass (clarity-council + writing-humanize) - [ ] Phase 6: Optionally publish back to the ticket (user opt-in) ``` ### Phase 1 — Gather ticket context - `jira_get_issue` — summary, description, issue type, status, priority, components, labels, **fix version(s)**, affected version, resolution. - `jira_get_comments` — capture what was actually implemented vs. originally scoped; watch for "done / shipped in" notes. - `jira_get_remote_links` — capture linked GitLab MR URLs