github-release-manager

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

GitHub Release Manager Skill

Overview

概述

Automated release coordination with swarm orchestration. This skill handles release pipelines, multi-package version coordination, deployment orchestration with rollback capabilities, release documentation generation, and multi-stage validation.

借助swarm编排实现自动化发布协调。该Skill可处理发布流水线、多包版本协调、具备回滚能力的部署编排、发布文档生成以及多阶段验证。

Quick Start

快速开始

bash

undefined

bash

undefined

List releases

gh release list

Create a release

gh release create v1.0.0 --title "Release v1.0.0" --notes "Release notes..."

View release

gh release view v1.0.0

Download release assets

gh release download v1.0.0

Delete release

gh release delete v1.0.0 --yes

undefined

gh release delete v1.0.0 --yes

undefined

When to Use

适用场景

Creating and managing software releases
Coordinating versions across multiple packages
Automating deployment with validation
Generating release documentation
Multi-stage release validation
Rollback and recovery procedures

创建和管理软件版本发布
协调多包项目的版本统一
自动化部署并附带验证流程
生成发布文档
多阶段发布验证
回滚与恢复流程

Core Capabilities

核心功能

Capability	Description
Automated pipelines	Comprehensive testing and validation
Version coordination	Multi-package version sync
Deployment orchestration	Staged deployment with rollback
Release documentation	Changelog and notes generation
Multi-stage validation	Swarm-coordinated testing

功能	说明
自动化流水线	全面的测试与验证
版本协调	多包版本同步
部署编排	带回滚功能的分阶段部署
发布文档	变更日志与发布说明生成
多阶段验证	Swarm协同测试

Usage Examples

使用示例

1. Coordinated Release Preparation

1. 协同发布准备

javascript

// Initialize release management swarm

// Orchestrate release preparation
    task: "Prepare release v1.0.72 with comprehensive testing and validation",
    strategy: "sequential",
    priority: "critical"
})

javascript

// Initialize release management swarm

// Orchestrate release preparation
    task: "Prepare release v1.0.72 with comprehensive testing and validation",
    strategy: "sequential",
    priority: "critical"
})

2. Create Release with gh CLI

2. 使用gh CLI创建发布

bash

undefined

bash

undefined

Create release branch

git checkout -b release/v1.0.72 main

Get commits since last release

LAST_TAG=$(gh release list --limit 1 --json tagName -q '.[0].tagName') COMMITS=$(gh api repos/owner/repo/compare/${LAST_TAG}...HEAD --jq '.commits[].commit.message')

Generate changelog

echo "$COMMITS" > CHANGELOG_DRAFT.md

Create draft release

gh release create v1.0.72
--draft
--title "Release v1.0.72"
--notes-file CHANGELOG_DRAFT.md
--target release/v1.0.72

Upload assets

gh release upload v1.0.72 dist/.tar.gz dist/.zip

Publish release

gh release edit v1.0.72 --draft=false

undefined

gh release edit v1.0.72 --draft=false

undefined

3. Multi-Package Version Coordination

3. 多包版本协调

bash

undefined

bash

undefined

Update package versions

cd ../ruv-swarm && npm version 1.0.12 --no-git-tag-version

Run tests for all packages

npm test --workspaces

Create coordinated release PR

gh pr create
--title "Release v1.0.72: GitHub Integration and Swarm Enhancements"
--head release/v1.0.72
--base main
--body "## Release v1.0.72

Package Updates

ruv-swarm: v1.0.11 -> v1.0.12

ruv-swarm: v1.0.11 -> v1.0.12

Changes

GitHub workflow integration
Enhanced swarm coordination
Advanced MCP tools integration

GitHub workflow integration
Enhanced swarm coordination
Advanced MCP tools integration

Validation

Unit tests passing
Integration tests: 89% success
Build verification successful"

undefined

Unit tests passing
Integration tests: 89% success
Build verification successful"

undefined

4. Automated Release Validation

4. 自动化发布验证

bash

undefined

bash

undefined

Run comprehensive validation

npm install && npm test && npm run lint && npm run build

Security audit

npm audit

Create validation report

gh issue create
--title "Release Validation: v1.0.72"
--body "## Validation Results

Unit tests: PASS
Integration tests: 89% success
Lint: PASS
Build: PASS
Security: No vulnerabilities"
--label "release,validation"

undefined

gh issue create
--title "Release Validation: v1.0.72"
--body "## Validation Results

Unit tests: PASS
Integration tests: 89% success
Lint: PASS
Build: PASS
Security: No vulnerabilities"
--label "release,validation"

undefined

5. Batch Release Workflow

5. 批量发布工作流

javascript

[Single Message - Complete Release Management]:
    // Initialize comprehensive release swarm

    // Create release branch
    Bash("git checkout -b release/v1.0.72 main")

    // Run comprehensive validation
    Bash("npm install && npm test && npm run lint && npm run build")

    // Create release PR
    Bash(`gh pr create \
      --title "Release v1.0.72" \
      --head "release/v1.0.72" \
      --base "main" \
      --body "[release description]"`)

    // Track release progress
    TodoWrite({ todos: [
      { id: "rel-prep", content: "Prepare release branch", status: "completed" },
      { id: "rel-test", content: "Run comprehensive tests", status: "completed" },
      { id: "rel-pr", content: "Create release PR", status: "completed" },
      { id: "rel-review", content: "Code review and approval", status: "pending" },
      { id: "rel-merge", content: "Merge and deploy", status: "pending" }
    ]})

    // Store release state
        action: "store",
        key: "release/v1.0.72/status",
        value: JSON.stringify({
            version: "1.0.72",
            stage: "validation_complete",
            validation_passed: true
        })
    })

javascript

[Single Message - Complete Release Management]:
    // Initialize comprehensive release swarm

    // Create release branch
    Bash("git checkout -b release/v1.0.72 main")

    // Run comprehensive validation
    Bash("npm install && npm test && npm run lint && npm run build")

    // Create release PR
    Bash(`gh pr create \
      --title "Release v1.0.72" \
      --head "release/v1.0.72" \
      --base "main" \
      --body "[release description]"`)

    // Track release progress
    TodoWrite({ todos: [
      { id: "rel-prep", content: "Prepare release branch", status: "completed" },
      { id: "rel-test", content: "Run comprehensive tests", status: "completed" },
      { id: "rel-pr", content: "Create release PR", status: "completed" },
      { id: "rel-review", content: "Code review and approval", status: "pending" },
      { id: "rel-merge", content: "Merge and deploy", status: "pending" }
    ]})

    // Store release state
        action: "store",
        key: "release/v1.0.72/status",
        value: JSON.stringify({
            version: "1.0.72",
            stage: "validation_complete",
            validation_passed: true
        })
    })

Release Strategies

发布策略

Semantic Versioning

语义化版本控制

javascript

const versionStrategy = {
    major: "Breaking changes or architecture overhauls",
    minor: "New features, GitHub integration, swarm enhancements",
    patch: "Bug fixes, documentation updates, dependency updates",
    coordination: "Cross-package version alignment"
}

javascript

const versionStrategy = {
    major: "Breaking changes or architecture overhauls",
    minor: "New features, GitHub integration, swarm enhancements",
    patch: "Bug fixes, documentation updates, dependency updates",
    coordination: "Cross-package version alignment"
}

Multi-Stage Validation

多阶段验证

javascript

const validationStages = [
    "unit_tests",           // Individual package testing
    "integration_tests",    // Cross-package integration
    "performance_tests",    // Performance regression detection
    "compatibility_tests",  // Version compatibility validation
    "documentation_tests",  // Documentation accuracy verification
    "deployment_tests"      // Deployment simulation
]

javascript

const validationStages = [
    "unit_tests",           // Individual package testing
    "integration_tests",    // Cross-package integration
    "performance_tests",    // Performance regression detection
    "compatibility_tests",  // Version compatibility validation
    "documentation_tests",  // Documentation accuracy verification
    "deployment_tests"      // Deployment simulation
]

Rollback Strategy

回滚策略

javascript

const rollbackPlan = {
    triggers: ["test_failures", "deployment_issues", "critical_bugs"],
    automatic: ["failed_tests", "build_failures"],
    manual: ["user_reported_issues", "performance_degradation"],
    recovery: "Previous stable version restoration"
}

javascript

const rollbackPlan = {
    triggers: ["test_failures", "deployment_issues", "critical_bugs"],
    automatic: ["failed_tests", "build_failures"],
    manual: ["user_reported_issues", "performance_degradation"],
    recovery: "Previous stable version restoration"
}

MCP Tool Integration

MCP工具集成

Swarm Coordination

Swarm协同编排

javascript

    topology: "hierarchical",
    maxAgents: 6,
    strategy: "sequential"  // Release stages run in order
})

javascript

    topology: "hierarchical",
    maxAgents: 6,
    strategy: "sequential"  // Release stages run in order
})

Memory for Release State

发布状态存储

javascript

// Store release state
    action: "store",
    key: "release/v1.0.72/state",
    namespace: "releases",
    value: JSON.stringify({
        version: "1.0.72",
        stage: "testing",
        timestamp: Date.now()
    })
})

javascript

// Store release state
    action: "store",
    key: "release/v1.0.72/state",
    namespace: "releases",
    value: JSON.stringify({
        version: "1.0.72",
        stage: "testing",
        timestamp: Date.now()
    })
})

GitHub Actions Integration

GitHub Actions集成

yaml

name: Release Management
on:
  pull_request:
    branches: [main]
    paths: ['**/package.json', 'CHANGELOG.md']

jobs:
  release-validation:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '20'
      - name: Install and Test
        run: |
          npm install
          npm test
          npm run lint
          npm run build
      - name: Validate Release

yaml

name: Release Management
on:
  pull_request:
    branches: [main]
    paths: ['**/package.json', 'CHANGELOG.md']

jobs:
  release-validation:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '20'
      - name: Install and Test
        run: |
          npm install
          npm test
          npm run lint
          npm run build
      - name: Validate Release

Best Practices

最佳实践

1. Comprehensive Testing

1. 全面测试

Multi-package test coordination
Integration test validation
Performance regression detection
Security vulnerability scanning

多包测试协同
集成测试验证
性能退化检测
安全漏洞扫描

2. Documentation Management

2. 文档管理

Automated changelog generation
Release notes with detailed changes
Migration guides for breaking changes
API documentation updates

自动化变更日志生成
包含详细变更的发布说明
破坏性变更迁移指南
API文档更新

3. Deployment Coordination

3. 部署协调

Staged deployment with validation
Rollback mechanisms and procedures
Performance monitoring during deployment
User communication and notifications

带验证的分阶段部署
回滚机制与流程
部署期间性能监控
用户沟通与通知

4. Version Management

4. 版本管理

Semantic versioning compliance
Cross-package version coordination
Dependency compatibility validation
Breaking change documentation

遵循语义化版本规范
跨包版本协调
依赖兼容性验证
破坏性变更文档记录

Monitoring and Metrics

监控与指标

Release Quality Metrics

发布质量指标

Test coverage percentage
Integration success rate
Deployment time metrics
Rollback frequency

测试覆盖率百分比
集成测试成功率
部署时间指标
回滚频率

Automated Monitoring

自动化监控

Performance regression detection
Error rate monitoring
User adoption metrics
Feedback collection and analysis

性能退化检测
错误率监控
用户采用率指标
反馈收集与分析

Version History

版本历史

1.0.0 (2025-01-02): Initial release - converted from release-manager agent

1.0.0 (2025-01-02)：初始版本 - 由release-manager agent迁移而来