AgentSkillsCN

mcpx-release

适用于为 MCPX 项目准备发布版本时使用。只有在所有测试通过且文档更新完成后方可进行。

SKILL.md
--- frontmatter
name: mcpx-release
description: Use when preparing a release for the MCPX project. Only after all tests pass and documentation is updated.

MCPX Release Process

Overview

版本发布遵循语义化版本：MAJOR.MINOR.PATCH

Version Number Format

code
MAJOR.MINOR.PATCH
例：0.1.4
  MAJOR = 0  (开发中)
  MINOR = 1  (新功能)
  PATCH = 4  (bug 修复)

Release Checklist

code
□ 代码检查通过 (make check)
□ 测试全部通过 (make test)
□ 覆盖率 ≥ 70%
□ CLAUDE.md 已更新
□ README.md 已更新
□ docs/roadmap.md 已更新
□ pyproject.toml 版本已更新

Release Steps

bash
# 1. 更新版本号
sed -i.bak 's/^version = "[0-9.]*"/version = "0.2.0"/' pyproject.toml
rm -f pyproject.toml.bak

# 2. 提交变更
git add .
git commit -m "chore: 发布版本 v0.2.0"

# 3. 创建标签
git tag -a v0.2.0 -m "Release v0.2.0"

# 4. 推送标签触发 CI
git push origin main --tags

Auto-Release Flow

推送 tag 后 GitHub Actions 自动执行：

  1. •构建包 (uv build)
  2. •运行测试
  3. •发布到 PyPI
  4. •创建 GitHub Release

Version Bump Rules

变更类型版本变化示例
Bug 修复PATCH+10.1.3 → 0.1.4
新功能MINOR+1, PATCH=00.1.3 → 0.2.0
破坏性变更MAJOR+10.1.3 → 1.0.0

Iron Law

code
测试失败或文档未更新？不要发布。

NO EXCEPTIONS:
- "文档稍后补" → 文档是发布的一部分
- "小 bug 不影响" → bug 就是 bug
- "CI 会修复的" → CI 不会修复，只检查