Name: qcc-release
Author: yxhpy

Imported from yxhpy/qcc_plus (.claude/skills/qcc-release/SKILL.md). Install upstream with npx skills add yxhpy/qcc_plus --skill qcc-release. Copyright stays with the author.

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，准备发布的候选版本

Install qcc-release and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "yxhpy-qcc-plus-qcc-release", "kind": "skill", "name": "qcc-release", "description": "Use for version release, GoReleaser automation, and publishing workflows in qcc_plus project", "publisher": "yxhpy", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Use for version release, GoReleaser automation, and publishing workflows in qcc_plus project" ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/yxhpy/qcc_plus", "path": ".claude/skills/qcc-release/SKILL.md", "ref": "c98700a2738f0b5e6ecd33b858130f1f5fd70a73", "url": "https://github.com/yxhpy/qcc_plus/blob/c98700a2738f0b5e6ecd33b858130f1f5fd70a73/.claude/skills/qcc-release/SKILL.md", "key": "yxhpy/qcc_plus/.claude/skills/qcc-release/SKILL.md" } }, "instructions": "# QCC Plus 版本发布\n\n## 语义化版本\n\n格式：`vX.Y.Z`\n\n| 版本号 | 说明 | 示例 |\n|--------|------|------|\n| X (主版本) | 不兼容的 API 变更 | v2.0.0 |\n| Y (次版本) | 向后兼容的功能新增 | v1.1.0 |\n| Z (修订号) | 向后兼容的问题修正 | v1.1.1 |\n\n## GoReleaser 自动化发布（推荐）\n\n发布新版本只需：\n\n```bash\ngit tag v1.2.0\ngit push origin v1.2.0\n```\n\nGitHub Actions 自动完成：\n- 构建多平台 Go 二进制（Linux/macOS/Windows，amd64/arm64）\n- 注入版本信息（version、git commit、build date）\n- 构建并推送 Docker 镜像（amd64 + arm64 multi-arch）\n- 生成分类 CHANGELOG\n- 创建 GitHub Release 并上传构建产物\n- 更新 Docker Hub 仓库信息\n\n## 发布流程\n\n### 阶段 1: 测试环境验证\n```bash\ngit checkout test\n# 开发 → 提交 → 推送\ngit push origin test # 自动部署到测试环境\n```\n\n###", "cost": { "context_tokens": 389 } }

qcc-release

About