跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
效率与协作

release-notes

Enhance GitHub release with detailed notes after release PR is merged to main

rlajous · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add rlajous/claude-code-commands --skill release-notes

技能说明


name: release-notes description: Enhance GitHub release with detailed notes after release PR is merged to main disable-model-invocation: false allowed-tools: Read, Grep, Glob, Bash(git branch:), Bash(git pull:), Bash(git tag:), Bash(git rev-list:), Bash(git log:), Bash(gh release view:), Bash(gh release create:), Bash(gh release edit:), Bash(gh pr view:*) user-invocable: true

Cross-runtime: follow runtime compatibility for invocation, delegation, configuration precedence, state paths, and permissions.

You are helping enhance a GitHub release with comprehensive release notes. This command should be run AFTER the release PR has been merged to the production branch.

Step 1: Load Configuration

Check for configuration:

if [ -f ".git-workflow/config.yaml" ]; then CONFIG_PATH=".git-workflow/config.yaml"; elif [ -f ".claude/config.yaml" ]; then CONFIG_PATH=".claude/config.yaml"; else CONFIG_PATH=""; fi

Load from the resolved CONFIG_PATH (canonical first, legacy read-only fallback):

workflow:
  productionBranch: main
versioning:
  file: auto
release:
  generateChangelog: true
  changelogCategories:
    - name: "Bug Fixes"
      prefixes: ["[Fix]", "[FIX]", "fix:"]
      emoji: "bug"
    - name: "Features"
      prefixes: ["[Feature]", "feat:"]
      emoji: "sparkles"

Default Values:

workflow:
  productionBranch: main
versioning:
  file: auto

Step 2: Verify Current State

Check that you're on the production branch and up-to-date:

PROD_BRANCH=$(config.workflow.productionBranch || "main")

# Get current branch
CURRENT=$(git branch --show-current)

# Pull latest
git pull origin ${PROD_BRANCH}

Validation:

  • If not on production branch:
    You should be on {PROD_BRANCH} branch after the release PR is merged.
    Run: git checkout {PROD_BRANCH} && git pull
    

Step 3: Get Current Version

Detect version file and read current version:

# Auto-detect version file
if [ -f "package.json" ]; then
  VERSION=$(node -p "require('./package.json').version")
elif [ -f "pyproject.toml" ]; then
  VERSION=$(grep -Po '(?<=version = ")[^"]*' pyproject.toml)
elif [ -f "Cargo.toml" ]; then
  VERSION=$(grep -Po '(?<=^version = ")[^"]*' Cargo.toml)
elif [ -f "VERSION" ]; then
  VERSION=$(cat VERSION)
fi

TAG_NAME="v${VERSION}"

Display to user:

Current version: {VERSION}
Release tag: v{VERSION}

Step 4: Check if Release Exists

gh release view v${VERSION} 2>&1

Possible States:

  1. Release exists → Will update with enhanced notes
  2. Release doesn't exist → Will create new release
  3. Tag doesn't exist → Error, release flow not completed

Store this result for Step 8 (create vs edit).

Step 5: Get Previous Release

Find the previous release tag for changelog comparison:

# Get all version tags sorted by version number
PREV_TAG=$(git tag --sort=-v:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | head -n 2 | tail -n 1)

# If no previous tag, use initial commit
if [ -z "$PREV_TAG" ]; then
  PREV_TAG=$(git rev-list --max-parents=0 HEAD)
fi

Step 6: Extract Detailed Changes

Get commits between previous and current release:

git log ${PREV_TAG}..v${VERSION} --pretty=format:"%H|%s|%b" --no-merges

Parse and Categorize

For each commit, extract:

  1. Commit hash - For reference
  2. Title - Main commit message
  3. Body - Additional details
  4. PR Number - From title or body

Categorization Rules

CategoryMatch PatternsEmoji
Bug Fixes[Fix], [FIX], fix:, fix(🐛
Features[Feature], feat:, feat(✨
Improvements[Refactor], [Perf], improve, enhance⚡
Documentation[Docs], docs:📝
Security[Security], security:🔒
OtherEverything else📦

Get PR Details (Optional)

For richer release notes, fetch PR details:

# For each PR number found
gh pr view {PR_NUMBER} --json title,body,labels

Extract:

  • PR title
  • Key points from description
  • Labels (for categorization)

Format Detailed Notes

### 🐛 Bug Fixes

- **[API] Fix trending coins endpoint and date formatting** (#662)
  - Fixed invalid query parameters
  - Improved date format validation
  - Added error handling for edge cases

### ✨ Features

- **Add cross-chain risk tag aggregation** (#648)
  - Supports EVM address risk analysis
  - Aggregates tags from multiple chains

Step 7: Get Previous Releases Context

List recent releases for context:

# Get last 3-5 releases
git tag --sort=-v:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | head -n 5

For each, get a brief summary:

gh release view v{VERSION} --json tagName,name,body 2>/dev/null | jq -r '.name'

Format as:

### 📊 Recent Releases

- **v2.76.0** - EIP-7702 support, holder analysis improvements
- **v2.75.0** - OFAC enrichment, cross-chain risk tags
- **v2.74.8** - Token metadata improvements

Step 8: Generate Enhanced Release Notes

Use this template:

## Release v{VERSION}

{Brief summary of release - 1-2 sentences}

### 🐛 Bug Fixes

{DETAILED_BUG_FIXES}

### ✨ Features

{DETAILED_FEATURES}

### ⚡ Improvements

{DETAILED_IMPROVEMENTS}

### 📝 Documentation

{DOCUMENTATION_CHANGES - if any}

### 📊 Recent Releases

{PREVIOUS_RELEASES_SUMMARY}

---

**Full Changelog**: https://github.com/{owner}/{repo}/compare/{PREV_TAG}...v{VERSION}

Step 9: Create or Update GitHub Release

Based on Step 4 result:

If Release Does NOT Exist (Common)

gh release create v${VERSION} \
  --title "v${VERSION}" \
  --notes "$(cat <<'EOF'
{ENHANCED_NOTES}
EOF
)
阅读完整来源 ↗