用途:该技能用于通过 GitHub CLI(gh)管理 GitHub Releases,覆盖发布创建、查询、修改、删除,以及发布附件与 Git 标签的管理,方便分发软件版本。
主要能力:
- 创建发布:支持指定 tag、标题、说明;可用 --generate-notes 自动生成说明,用 --notes-file 读取说明文件,用 --prerelease 创建预发布,用 --draft 创建草稿,用 --target 指定分支或提交,用 --latest 标记最新,并可在命令末尾附带附件文件。
- 列出与查看发布:gh release list 可限制数量、排除草稿或预发布、输出 JSON;gh release view 可查看最新或指定发布、在浏览器打开、输出 JSON 并筛选附件信息。
- 编辑发布:gh release edit 可更新标题与说明、标记 latest 或 prerelease、发布草稿(--draft=false)、切回草稿、更新讨论分类。
- 删除发布:gh release delete 默认保留标签,可配合 git push --delete origin <tag> 删除远程标签。
- 附件管理:gh release upload 可上传单个、多个或通配符匹配的文件,--clobber 覆盖同名附件;gh release download 可按 tag、模式、目录下载;删除附件需通过 gh api 获取 asset ID 后 DELETE。
- 标签管理:使用 git tag、git push origin、git tag -d、git push --delete 等命令创建、查看、删除本地与远程标签,也可基于指定提交创建标签。
使用方式:命令以 gh release 与 git tag 为主,需在已配置权限的仓库环境中运行。示例:gh release create v1.0.0 --repo owner/repo-name --title "Version 1.0.0" --notes "Initial release with core features";自动生成说明:--generate-notes;创建预发布:--prerelease;创建草稿:--draft;上传附件:gh release upload v1.0.0 dist/app.tar.gz --repo owner/repo-name;下载附件:gh release download v1.0.0 --repo owner/repo-name --pattern "*.tar.gz"。组合流程常为先提交并推送 tag,再构建产物,最后创建带附件的发布。
适用场景:软件版本发布与分发、预发布测试、草稿评审后发布、多平台二进制附件发布、从提交生成发布说明、回滚发布、批量清理旧预发布,以及通过 GitHub Actions 触发与监控发布工作流。
限制:资料未提供该技能自身的安装方式、收费或价格信息,也未说明除 GitHub CLI 与 git 之外的额外依赖;附件大小限制资料提及为每个附件 2GB,需注意。具体命令行为以 GitHub CLI 与 GitHub Releases API 实际支持为准。