Simplifies Go binary releases, Docker image publishing, and version tagging via GoReleaser automation.
Install
mkdir -p .claude/skills/qcc-release && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12232" && unzip -o skill.zip -d .claude/skills/qcc-release && rm skill.zipInstalls to .claude/skills/qcc-release
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Use for version release, GoReleaser automation, and publishing workflows in qcc_plus projectKey capabilities
- →Apply semantic versioning for releases
- →Automate release process using GoReleaser
- →Build multi-platform Go binaries
- →Build and push Docker images
- →Generate categorized CHANGELOGs
- →Create GitHub Releases and upload build artifacts
How it works
The skill uses GoReleaser to automate the release process, triggered by a git tag, which includes building binaries, pushing Docker images, generating changelogs, and creating GitHub releases.
Inputs & outputs
When to use qcc-release
- →Releasing new versions
- →Publishing Docker images
- →Generating binary releases
About this skill
QCC Plus 版本发布
语义化版本
格式:vX.Y.Z
| 版本号 | 说明 | 示例 |
|---|---|---|
| X (主版本) | 不兼容的 API 变更 | v2.0.0 |
| Y (次版本) | 向后兼容的功能新增 | v1.1.0 |
| Z (修订号) | 向后兼容的问题修正 | v1.1.1 |
GoReleaser 自动化发布(推荐)
发布新版本只需:
git tag v1.2.0
git push origin v1.2.0
GitHub Actions 自动完成:
- 构建多平台 Go 二进制(Linux/macOS/Windows,amd64/arm64)
- 注入版本信息(version、git commit、build date)
- 构建并推送 Docker 镜像(amd64 + arm64 multi-arch)
- 生成分类 CHANGELOG
- 创建 GitHub Release 并上传构建产物
- 更新 Docker Hub 仓库信息
发布流程
阶段 1: 测试环境验证
git checkout test
# 开发 → 提交 → 推送
git push origin test # 自动部署到测试环境
阶段 2: Pre-release(可选)
git tag v1.3.0-beta.1
git push origin v1.3.0-beta.1 # 发布到 Docker Hub (Pre-release)
阶段 3: 正式发布
git tag v1.x.x
git push origin v1.x.x # 发布到 Docker Hub + GitHub Release
发布后更新
- 更新 CLAUDE.md 中的"当前版本"字段
- 更新 CHANGELOG.md
- 验证 Docker 镜像:
docker pull yxhpy520/qcc_plus:vX.Y.Z - 验证版本信息:
curl http://localhost:8000/version
重要提醒
- Docker Hub 用户名是
yxhpy520(不是 yxhpy) latest标签始终指向最新稳定版本- 发布前必须确保代码已通过所有测试
- 版本信息通过构建时 ldflags 注入,无需手动修改代码
本地测试
# 检查配置
goreleaser check
# 构建测试(快照模式)
goreleaser build --snapshot --clean
# 完整发布测试(不推送)
goreleaser release --snapshot --clean --skip=publish
GitHub Secrets 配置
| Secret | 说明 |
|---|---|
DOCKER_USERNAME | Docker Hub 用户名(yxhpy520) |
DOCKER_TOKEN | Docker Hub Personal Access Token |
Pre-release 版本号规范
v1.3.0-alpha.1- 内部测试,功能不完整v1.3.0-beta.1- 公开测试,功能基本完整v1.3.0-rc.1- Release Candidate,准备发布的候选版本
When not to use it
- →When the user does not want to use GoReleaser for automation
- →When the user wants to manually modify version information in code
- →When the user wants to publish without ensuring code has passed all tests
Prerequisites
Limitations
- →Docker Hub username is `yxhpy520`
- →`latest` tag always points to the latest stable version
- →Release must ensure code has passed all tests
How it compares
This skill automates the entire release workflow for the `qcc_plus` project using GoReleaser, including multi-platform builds and Docker image publishing, which is more complete than manual release steps.
Compared to similar skills
qcc-release side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| qcc-release (this skill) | 0 | 8mo | Review | Intermediate |
| update-go-version | 1 | 6mo | Review | Beginner |
| upgrade-deps | 0 | 2mo | No flags | Advanced |
| github-release-management | 4 | 6mo | Review | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
update-go-version
grafana
Update Go version across the Tempo codebase (go.mod, tools/go.mod, Dockerfile, CI workflows, tools image tag)
upgrade-deps
obot-platform
Upgrade dependencies and runtimes safely, run CI, and report higher-risk options.
github-release-management
ruvnet
Comprehensive GitHub release orchestration with AI swarm coordination for automated versioning, testing, deployment, and rollback management
windsurf-cicd-github-actions
jeremylongshore
Generate and maintain GitHub Actions with Cascade assistance. Activate when users mention "github actions", "ci/cd pipeline", "workflow automation", "continuous integration", or "deployment pipeline". Handles CI/CD configuration with AI assistance. Use when working with windsurf cicd github actions functionality. Trigger with phrases like "windsurf cicd github actions", "windsurf actions", "windsurf".
gcp-cloud-run
aj-geddes
Deploy containerized applications on Google Cloud Run with automatic scaling, traffic management, and service mesh integration. Use for container-based serverless computing.
deployment-pipeline-design
wshobson
Design multi-stage CI/CD pipelines with approval gates, security checks, and deployment orchestration. Use when architecting deployment workflows, setting up continuous delivery, or implementing GitOps practices.