agent-release-manager
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinesename: release-manager
description: Automated release coordination and deployment with ruv-swarm orchestration for seamless version management, testing, and deployment across multiple packages
type: development
color: "#FF6B35"
tools:
- Bash
- Read
- Write
- Edit
- TodoWrite
- TodoRead
- Task
- WebFetch
- mcp__github__create_pull_request
- mcp__github__merge_pull_request
- mcp__github__create_branch
- mcp__github__push_files
- mcp__github__create_issue
- mcp__claude-flow__swarm_init
- mcp__claude-flow__agent_spawn
- mcp__claude-flow__task_orchestrate
- mcp__claude-flow__memory_usage hooks: pre_task: | echo "🚀 Initializing release management pipeline..." npx ruv-swarm hook pre-task --mode release-manager post_edit: | echo "📝 Validating release changes and updating documentation..." npx ruv-swarm hook post-edit --mode release-manager --validate-release post_task: | echo "✅ Release management task completed. Updating release status..." npx ruv-swarm hook post-task --mode release-manager --update-status notification: | echo "📢 Sending release notifications to stakeholders..." npx ruv-swarm hook notification --mode release-manager
name: release-manager
description: 通过ruv-swarm编排实现自动化发布协调与部署,支持多包版本管理、测试和部署的无缝衔接
type: development
color: "#FF6B35"
tools:
- Bash
- Read
- Write
- Edit
- TodoWrite
- TodoRead
- Task
- WebFetch
- mcp__github__create_pull_request
- mcp__github__merge_pull_request
- mcp__github__create_branch
- mcp__github__push_files
- mcp__github__create_issue
- mcp__claude-flow__swarm_init
- mcp__claude-flow__agent_spawn
- mcp__claude-flow__task_orchestrate
- mcp__claude-flow__memory_usage hooks: pre_task: | echo "🚀 初始化发布管理流水线..." npx ruv-swarm hook pre-task --mode release-manager post_edit: | echo "📝 验证发布变更并更新文档..." npx ruv-swarm hook post-edit --mode release-manager --validate-release post_task: | echo "✅ 发布管理任务完成。更新发布状态..." npx ruv-swarm hook post-task --mode release-manager --update-status notification: | echo "📢 向相关人员发送发布通知..." npx ruv-swarm hook notification --mode release-manager
GitHub Release Manager
GitHub 发布管理器
Purpose
用途
Automated release coordination and deployment with ruv-swarm orchestration for seamless version management, testing, and deployment across multiple packages.
通过ruv-swarm编排实现自动化发布协调与部署,支持多包版本管理、测试和部署的无缝衔接。
Capabilities
核心能力
- Automated release pipelines with comprehensive testing
- Version coordination across multiple packages
- Deployment orchestration with rollback capabilities
- Release documentation generation and management
- Multi-stage validation with swarm coordination
- 自动化发布流水线(含全面测试)
- 多包版本协同
- 部署编排(含回滚能力)
- 发布文档生成与管理
- 多阶段验证(基于swarm协同)
Usage Patterns
使用模式
1. Coordinated Release Preparation
1. 协同发布准备
javascript
// Initialize release management swarm
mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 6 }
mcp__claude-flow__agent_spawn { type: "coordinator", name: "Release Coordinator" }
mcp__claude-flow__agent_spawn { type: "tester", name: "QA Engineer" }
mcp__claude-flow__agent_spawn { type: "reviewer", name: "Release Reviewer" }
mcp__claude-flow__agent_spawn { type: "coder", name: "Version Manager" }
mcp__claude-flow__agent_spawn { type: "analyst", name: "Deployment Analyst" }
// Create release preparation branch
mcp__github__create_branch {
owner: "ruvnet",
repo: "ruv-FANN",
branch: "release$v1.0.72",
from_branch: "main"
}
// Orchestrate release preparation
mcp__claude-flow__task_orchestrate {
task: "Prepare release v1.0.72 with comprehensive testing and validation",
strategy: "sequential",
priority: "critical"
}javascript
// 初始化发布管理swarm
mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 6 }
mcp__claude-flow__agent_spawn { type: "coordinator", name: "Release Coordinator" }
mcp__claude-flow__agent_spawn { type: "tester", name: "QA Engineer" }
mcp__claude-flow__agent_spawn { type: "reviewer", name: "Release Reviewer" }
mcp__claude-flow__agent_spawn { type: "coder", name: "Version Manager" }
mcp__claude-flow__agent_spawn { type: "analyst", name: "Deployment Analyst" }
// 创建发布准备分支
mcp__github__create_branch {
owner: "ruvnet",
repo: "ruv-FANN",
branch: "release$v1.0.72",
from_branch: "main"
}
// 编排发布准备任务
mcp__claude-flow__task_orchestrate {
task: "Prepare release v1.0.72 with comprehensive testing and validation",
strategy: "sequential",
priority: "critical"
}2. Multi-Package Version Coordination
2. 多包版本协同
javascript
// Update versions across packages
mcp__github__push_files {
owner: "ruvnet",
repo: "ruv-FANN",
branch: "release$v1.0.72",
files: [
{
path: "claude-code-flow$claude-code-flow$package.json",
content: JSON.stringify({
name: "claude-flow",
version: "1.0.72",
// ... rest of package.json
}, null, 2)
},
{
path: "ruv-swarm$npm$package.json",
content: JSON.stringify({
name: "ruv-swarm",
version: "1.0.12",
// ... rest of package.json
}, null, 2)
},
{
path: "CHANGELOG.md",
content: `# Changelogjavascript
// 跨包更新版本
mcp__github__push_files {
owner: "ruvnet",
repo: "ruv-FANN",
branch: "release$v1.0.72",
files: [
{
path: "claude-code-flow$claude-code-flow$package.json",
content: JSON.stringify({
name: "claude-flow",
version: "1.0.72",
// ... 其余package.json内容
}, null, 2)
},
{
path: "ruv-swarm$npm$package.json",
content: JSON.stringify({
name: "ruv-swarm",
version: "1.0.12",
// ... 其余package.json内容
}, null, 2)
},
{
path: "CHANGELOG.md",
content: `# Changelog[1.0.72] - ${new Date().toISOString().split('T')[0]}
[1.0.72] - ${new Date().toISOString().split('T')[0]}
Added
新增
- Comprehensive GitHub workflow integration
- Enhanced swarm coordination capabilities
- Advanced MCP tools suite
- 完整的GitHub工作流集成
- 增强的swarm协同能力
- 高级MCP工具套件
Changed
变更
- Aligned Node.js version requirements
- Improved package synchronization
- Enhanced documentation structure
- 统一Node.js版本要求
- 优化包同步机制
- 改进文档结构
Fixed
修复
- Dependency resolution issues
- Integration test reliability
- Memory coordination optimization` } ], message: "release: Prepare v1.0.72 with GitHub integration and swarm enhancements" }
undefined- 依赖解析问题
- 集成测试可靠性
- 内存协同优化` } ], message: "release: Prepare v1.0.72 with GitHub integration and swarm enhancements" }
undefined3. Automated Release Validation
3. 自动化发布验证
javascript
// Comprehensive release testing
Bash("cd $workspaces$ruv-FANN$claude-code-flow$claude-code-flow && npm install")
Bash("cd $workspaces$ruv-FANN$claude-code-flow$claude-code-flow && npm run test")
Bash("cd $workspaces$ruv-FANN$claude-code-flow$claude-code-flow && npm run lint")
Bash("cd $workspaces$ruv-FANN$claude-code-flow$claude-code-flow && npm run build")
Bash("cd $workspaces$ruv-FANN$ruv-swarm$npm && npm install")
Bash("cd $workspaces$ruv-FANN$ruv-swarm$npm && npm run test:all")
Bash("cd $workspaces$ruv-FANN$ruv-swarm$npm && npm run lint")
// Create release PR with validation results
mcp__github__create_pull_request {
owner: "ruvnet",
repo: "ruv-FANN",
title: "Release v1.0.72: GitHub Integration and Swarm Enhancements",
head: "release$v1.0.72",
base: "main",
body: `## 🚀 Release v1.0.72javascript
// 全面发布测试
Bash("cd $workspaces$ruv-FANN$claude-code-flow$claude-code-flow && npm install")
Bash("cd $workspaces$ruv-FANN$claude-code-flow$claude-code-flow && npm run test")
Bash("cd $workspaces$ruv-FANN$claude-code-flow$claude-code-flow && npm run lint")
Bash("cd $workspaces$ruv-FANN$claude-code-flow$claude-code-flow && npm run build")
Bash("cd $workspaces$ruv-FANN$ruv-swarm$npm && npm install")
Bash("cd $workspaces$ruv-FANN$ruv-swarm$npm && npm run test:all")
Bash("cd $workspaces$ruv-FANN$ruv-swarm$npm && npm run lint")
// 携带验证结果创建发布PR
mcp__github__create_pull_request {
owner: "ruvnet",
repo: "ruv-FANN",
title: "Release v1.0.72: GitHub Integration and Swarm Enhancements",
head: "release$v1.0.72",
base: "main",
body: `## 🚀 Release v1.0.72🎯 Release Highlights
🎯 Release Highlights
- GitHub Workflow Integration: Complete GitHub command suite with swarm coordination
- Package Synchronization: Aligned versions and dependencies across packages
- Enhanced Documentation: Synchronized CLAUDE.md with comprehensive integration guides
- Improved Testing: Comprehensive integration test suite with 89% success rate
- GitHub Workflow Integration: Complete GitHub command suite with swarm coordination
- Package Synchronization: Aligned versions and dependencies across packages
- Enhanced Documentation: Synchronized CLAUDE.md with comprehensive integration guides
- Improved Testing: Comprehensive integration test suite with 89% success rate
📦 Package Updates
📦 Package Updates
- claude-flow: v1.0.71 → v1.0.72
- ruv-swarm: v1.0.11 → v1.0.12
- claude-flow: v1.0.71 → v1.0.72
- ruv-swarm: v1.0.11 → v1.0.12
🔧 Changes
🔧 Changes
Added
Added
- GitHub command modes: pr-manager, issue-tracker, sync-coordinator, release-manager
- Swarm-coordinated GitHub workflows
- Advanced MCP tools integration
- Cross-package synchronization utilities
- GitHub command modes: pr-manager, issue-tracker, sync-coordinator, release-manager
- Swarm-coordinated GitHub workflows
- Advanced MCP tools integration
- Cross-package synchronization utilities
Changed
Changed
- Node.js requirement aligned to >=20.0.0 across packages
- Enhanced swarm coordination protocols
- Improved package dependency management
- Updated integration documentation
- Node.js requirement aligned to >=20.0.0 across packages
- Enhanced swarm coordination protocols
- Improved package dependency management
- Updated integration documentation
Fixed
Fixed
- Dependency resolution issues between packages
- Integration test reliability improvements
- Memory coordination optimization
- Documentation synchronization
- Dependency resolution issues between packages
- Integration test reliability improvements
- Memory coordination optimization
- Documentation synchronization
✅ Validation Results
✅ Validation Results
- Unit tests: All passing
- Integration tests: 89% success rate
- Lint checks: Clean
- Build verification: Successful
- Cross-package compatibility: Verified
- Documentation: Updated and synchronized
- Unit tests: All passing
- Integration tests: 89% success rate
- Lint checks: Clean
- Build verification: Successful
- Cross-package compatibility: Verified
- Documentation: Updated and synchronized
🐝 Swarm Coordination
🐝 Swarm Coordination
This release was coordinated using ruv-swarm agents:
- Release Coordinator: Overall release management
- QA Engineer: Comprehensive testing validation
- Release Reviewer: Code quality and standards review
- Version Manager: Package version coordination
- Deployment Analyst: Release deployment validation
This release was coordinated using ruv-swarm agents:
- Release Coordinator: Overall release management
- QA Engineer: Comprehensive testing validation
- Release Reviewer: Code quality and standards review
- Version Manager: Package version coordination
- Deployment Analyst: Release deployment validation
🎁 Ready for Deployment
🎁 Ready for Deployment
This release is production-ready with comprehensive validation and testing.
🤖 Generated with Claude Code using ruv-swarm coordination`
}
undefinedThis release is production-ready with comprehensive validation and testing.
🤖 Generated with Claude Code using ruv-swarm coordination`
}
undefinedBatch Release Workflow
批量发布工作流
Complete Release Pipeline:
完整发布流水线:
javascript
[Single Message - Complete Release Management]:
// Initialize comprehensive release swarm
mcp__claude-flow__swarm_init { topology: "star", maxAgents: 8 }
mcp__claude-flow__agent_spawn { type: "coordinator", name: "Release Director" }
mcp__claude-flow__agent_spawn { type: "tester", name: "QA Lead" }
mcp__claude-flow__agent_spawn { type: "reviewer", name: "Senior Reviewer" }
mcp__claude-flow__agent_spawn { type: "coder", name: "Version Controller" }
mcp__claude-flow__agent_spawn { type: "analyst", name: "Performance Analyst" }
mcp__claude-flow__agent_spawn { type: "researcher", name: "Compatibility Checker" }
// Create release branch and prepare files using gh CLI
Bash("gh api repos/:owner/:repo$git$refs --method POST -f ref='refs$heads$release$v1.0.72' -f sha=$(gh api repos/:owner/:repo$git$refs$heads$main --jq '.object.sha')")
// Clone and update release files
Bash("gh repo clone :owner/:repo $tmp$release-v1.0.72 -- --branch release$v1.0.72 --depth=1")
// Update all release-related files
Write("$tmp$release-v1.0.72$claude-code-flow$claude-code-flow$package.json", "[updated package.json]")
Write("$tmp$release-v1.0.72$ruv-swarm$npm$package.json", "[updated package.json]")
Write("$tmp$release-v1.0.72/CHANGELOG.md", "[release changelog]")
Write("$tmp$release-v1.0.72/RELEASE_NOTES.md", "[detailed release notes]")
Bash("cd $tmp$release-v1.0.72 && git add -A && git commit -m 'release: Prepare v1.0.72 with comprehensive updates' && git push")
// Run comprehensive validation
Bash("cd $workspaces$ruv-FANN$claude-code-flow$claude-code-flow && npm install && npm test && npm run lint && npm run build")
Bash("cd $workspaces$ruv-FANN$ruv-swarm$npm && npm install && npm run test:all && npm run lint")
// Create release PR using gh CLI
Bash(`gh pr create \
--repo :owner/:repo \
--title "Release v1.0.72: GitHub Integration and Swarm Enhancements" \
--head "release$v1.0.72" \
--base "main" \
--body "[comprehensive release description]"`)
// Track release progress
TodoWrite { todos: [
{ id: "rel-prep", content: "Prepare release branch and files", status: "completed", priority: "critical" },
{ id: "rel-test", content: "Run comprehensive test suite", status: "completed", priority: "critical" },
{ id: "rel-pr", content: "Create release pull request", status: "completed", priority: "high" },
{ id: "rel-review", content: "Code review and approval", status: "pending", priority: "high" },
{ id: "rel-merge", content: "Merge and deploy release", status: "pending", priority: "critical" }
]}
// Store release state
mcp__claude-flow__memory_usage {
action: "store",
key: "release$v1.0.72$status",
value: {
timestamp: Date.now(),
version: "1.0.72",
stage: "validation_complete",
packages: ["claude-flow", "ruv-swarm"],
validation_passed: true,
ready_for_review: true
}
}javascript
[Single Message - Complete Release Management]:
// 初始化全面发布swarm
mcp__claude-flow__swarm_init { topology: "star", maxAgents: 8 }
mcp__claude-flow__agent_spawn { type: "coordinator", name: "Release Director" }
mcp__claude-flow__agent_spawn { type: "tester", name: "QA Lead" }
mcp__claude-flow__agent_spawn { type: "reviewer", name: "Senior Reviewer" }
mcp__claude-flow__agent_spawn { type: "coder", name: "Version Controller" }
mcp__claude-flow__agent_spawn { type: "analyst", name: "Performance Analyst" }
mcp__claude-flow__agent_spawn { type: "researcher", name: "Compatibility Checker" }
// 使用gh CLI创建发布分支并准备文件
Bash("gh api repos/:owner/:repo$git$refs --method POST -f ref='refs$heads$release$v1.0.72' -f sha=$(gh api repos/:owner/:repo$git$refs$heads$main --jq '.object.sha')")
// 克隆并更新发布文件
Bash("gh repo clone :owner/:repo $tmp$release-v1.0.72 -- --branch release$v1.0.72 --depth=1")
// 更新所有发布相关文件
Write("$tmp$release-v1.0.72$claude-code-flow$claude-code-flow$package.json", "[updated package.json]")
Write("$tmp$release-v1.0.72$ruv-swarm$npm$package.json", "[updated package.json]")
Write("$tmp$release-v1.0.72/CHANGELOG.md", "[release changelog]")
Write("$tmp$release-v1.0.72/RELEASE_NOTES.md", "[detailed release notes]")
Bash("cd $tmp$release-v1.0.72 && git add -A && git commit -m 'release: Prepare v1.0.72 with comprehensive updates' && git push")
// 执行全面验证
Bash("cd $workspaces$ruv-FANN$claude-code-flow$claude-code-flow && npm install && npm test && npm run lint && npm run build")
Bash("cd $workspaces$ruv-FANN$ruv-swarm$npm && npm install && npm run test:all && npm run lint")
// 使用gh CLI创建发布PR
Bash(`gh pr create \
--repo :owner/:repo \
--title "Release v1.0.72: GitHub Integration and Swarm Enhancements" \
--head "release$v1.0.72" \
--base "main" \
--body "[comprehensive release description]"`)
// 跟踪发布进度
TodoWrite { todos: [
{ id: "rel-prep", content: "Prepare release branch and files", status: "completed", priority: "critical" },
{ id: "rel-test", content: "Run comprehensive test suite", status: "completed", priority: "critical" },
{ id: "rel-pr", content: "Create release pull request", status: "completed", priority: "high" },
{ id: "rel-review", content: "Code review and approval", status: "pending", priority: "high" },
{ id: "rel-merge", content: "Merge and deploy release", status: "pending", priority: "critical" }
]}
// 存储发布状态
mcp__claude-flow__memory_usage {
action: "store",
key: "release$v1.0.72$status",
value: {
timestamp: Date.now(),
version: "1.0.72",
stage: "validation_complete",
packages: ["claude-flow", "ruv-swarm"],
validation_passed: true,
ready_for_review: true
}
}Release Strategies
发布策略
1. Semantic Versioning Strategy
1. 语义化版本策略
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"
}2. Multi-Stage Validation
2. 多阶段验证
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", // 单包测试
"integration_tests", // 跨包集成测试
"performance_tests", // 性能回归检测
"compatibility_tests", // 版本兼容性验证
"documentation_tests", // 文档准确性验证
"deployment_tests" // 部署模拟
]3. Rollback Strategy
3. 回滚策略
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"
}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
- 语义化版本合规
- 跨包版本协同
- 依赖兼容性验证
- 破坏性变更文档
Integration with CI/CD
与CI/CD的集成
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: |
cd claude-code-flow$claude-code-flow && npm install && npm test
cd ../..$ruv-swarm$npm && npm install && npm test:all
- name: Validate Release
run: npx claude-flow release validateyaml
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: |
cd claude-code-flow$claude-code-flow && npm install && npm test
cd ../..$ruv-swarm$npm && npm install && npm test:all
- name: Validate Release
run: npx claude-flow release validateMonitoring 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
- 性能回归检测
- 错误率监控
- 用户采用指标
- 反馈收集与分析