create-release-note

Create Release Note

This skill provides detailed step-by-step implementation guidance for the /jira:create-release-note command, which automatically generates bug fix release notes by analyzing Jira bug tickets and their linked GitHub pull requests.

When to Use This Skill

This skill is automatically invoked by the /jira:create-release-note command and should not be called directly by users.

Prerequisites

• MCP Jira server configured and accessible
• GitHub CLI (gh) installed and authenticated
• User has read access to the Jira bug
• User has write access to Release Note fields in Jira
• User has read access to linked GitHub repositories

Implementation Steps

Step 1: Fetch and Validate Jira Bug

Objective: Retrieve the bug ticket and validate it's appropriate for release note generation.

Actions:

1. Fetch the bug via getJiraIssue with the issue key and responseContentFormat: "markdown".

2. Parse the response:

   • Extract issuetype.name - verify it's "Bug"
   • Extract description - full bug description text
   • Extract issuelinks - array of linked issues
   • Extract customfield_10785 - current Release Note Type (if already set)
   • Extract customfield_10783 - current Release Note Text (if already set)
   • Extract comment.comments - array of comment objects

3. Validate issue type:

   • If issuetype.name != "Bug", show warning:

     Warning: {issue-key} is not a Bug (it's a {issuetype.name}).
     Release notes are typically for bugs. Continue anyway? (yes/no)
     

   • If user says no, exit without making changes

4. Check if release note already exists:

   • If customfield_10783 is not empty, show warning:

     This bug already has a release note:
     ---
     {existing release note}
     ---
     
     Do you want to regenerate it? (yes/no)
     

   • If user says no, exit without making changes

Step 2: Parse Bug Description for Cause and Consequence

Objective: Extract the required Cause and Consequence sections from the bug description.