create-release

Note: If you have mcporter installed locally, you should use mcporter to invoke the MCP tool instead of directly calling the MCP tool. The mcporter CLI provides a more convenient interface and better error handling.

Create Release via Gitee MCP

Auto-generate a changelog from merged PR history and publish a well-structured release on Gitee.

Prerequisites

• Gitee MCP Server configured (tools: list_releases, list_repo_pulls, create_release)
• User must provide: repository owner, repository name, version number
• Optional: previous version number (to determine the changelog range)

Steps

Step 1: Confirm the Version Number

Confirm the version number with the user, following Semantic Versioning:

vMAJOR.MINOR.PATCH

- MAJOR: incompatible API changes
- MINOR: backward-compatible new features
- PATCH: backward-compatible bug fixes

If the user hasn't provided one, suggest an appropriate version based on the nature of the changes.

Step 2: Review Release History

Use list_releases to retrieve existing releases:

• Confirm the previous version number
• Understand the version naming convention (e.g., whether a v prefix is used)
• Avoid version number conflicts

Step 3: Collect PR Changes

Use list_repo_pulls to get PRs merged since the last release:

• state: merged
• Sort by merge time, filtering for PRs after the last release

Classify each PR:

• feat / feature: new feature
• fix / bugfix: bug fix
• refactor: code refactoring
• perf: performance improvement
• docs: documentation update
• chore: dependency / build / toolchain changes
• breaking: breaking change (title contains breaking or !:)

Step 4: Analyze Code Changes

As a supplement to PR titles, use compare_branches_tags to get a more detailed diff analysis:

compare_branches_tags(owner="[owner]", repo="[repo]", target="[current_branch]", base="[previous_version_tag]")

This returns:

• Files changed (added, modified, deleted)
• Commit history between versions
• Code statistics (additions, deletions)

Use this to understand the actual code changes behind each PR, especially useful when PR titles are unclear.

Step 5: Generate Changelog

Generate the changelog using this template:

## [v{version}] - YYYY-MM-DD

### ⚠️ Breaking Changes
- [PR title] (#PR number) @author

### ✨ New Features
- [PR title] (#PR number) @author
- [PR title] (#PR number) @author

### 🐛 Bug Fixes
- [PR title] (#PR number) @author

### ⚡ Performance
- [PR title] (#PR number) @author

### 📖 Documentation
- [PR title] (#PR number) @author

### 🔧 Other
- [PR title] (#PR number) @author

---

**Full changelog**: [link comparing previous version...current version]

Omit sections with no changes.

Step 6: Confirm and Create the Release

Show the generated changelog to the user for confirmation. After confirmation, use create_release with these parameters:

• tag_name: version number (e.g., v1.2.0)
• name: release title (e.g., Release v1.2.0)
• body: changelog generated in Step 4
• prerelease: set to true for pre-release versions (alpha / beta / rc)

After successful creation, output the link to the Release page.

Notes

• Use the v prefix in version numbers (e.g., v1.2.0) to match common project conventions
• Breaking changes must be prominently highlighted to warn users upgrading
• If PR titles are not semantic, lightly rephrase them in the changelog while preserving the original intent
• Pre-release versions (alpha / beta / rc) should be marked prerelease=true so they don't affect the stable release line