1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | github-release-github-awesome-copilot(技能目录名 github-release) |
| 作者/维护者 | 贡献者 amorguettinogueira,由 GitHub 官方社区合集 github/awesome-copilot 维护者审核合并 |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/github-release |
| 许可证 | MIT(合集仓库,GitHub API) |
| GitHub Stars / Forks | 合集仓库整体 39,919 / 5,097(GitHub API);该数字属整个合集,不代表本技能自身热度 |
| 技能自身热度 | skills.sh 记录安装量 678 |
| 最新版本 | 无独立版本号;2026-04-30 加入合集,2026-08-07 最近一次修订(修复引用与围栏嵌套) |
| 安装方式 | 复制 skills/github-release/ 目录到 agent 的 skills 目录 |
2. 功能介绍与亮点
面向单包 GitHub 仓库的端到端发版流程,只依赖 gh 与 git,共 9 步:
- 步骤 1–4 为只读侦察:更新 main、读取最新 SemVer 标签(直接读 git 标签,而非
gh release list,因为很多仓库只打标签不建 Release)、分析上次发版以来的变更、计算下一个版本号。 - 版本号以代码差异为主证据、提交信息为辅助证据,按 MAJOR > MINOR > PATCH 的优先级取最高档,并要求向用户说明依据后等待确认,再创建
release/vX.Y.Z分支。 - 按 Keep a Changelog 格式写
CHANGELOG.md(Added/Changed/Deprecated/Removed/Fixed/Security),用面向使用者的语言,并更新底部对比链接。 - 随附
references/semver-rules.md与commit-classification.md两份判定规则;每段命令同时给出 Bash 与 PowerShell 版本。 - 支持让用户指定“公开源码目录”,把 tests、docs、锁文件、生成文件排除出差异分析。
3. 适用场景
所属分类:工程效率与代码质量。适合维护开源库或内部库的开发者,在“该升哪一档版本、changelog 怎么写、发版 PR 怎么开”上想要一套固定流程的人,尤其是不熟悉 SemVer 边界判断的初中级维护者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md(name/description),另带 compatibility 字段声明需要 gh 与 git |
| Codex | 需适配 | 格式同为 Agent Skills 规范,但 Codex 不自动发现 ~/.codex/skills,需手动引用 |
| OpenClaw | 未验证 | 未做实机核验 |
| Hermes Agent | 原生支持 | Hermes 按路径扫描子目录探测 SKILL.md;运行依赖本机 gh/git |
5. 推荐理由
发版是“低频但出错代价高”的操作:版本号升错档、changelog 漏记破坏性变更,都会直接影响下游使用者。本技能把判断依据固定成“看代码差异而不只看提交信息”,并在写入仓库前(步骤 5 之前)全部为只读,版本号必须经用户确认才动手,对初中级维护者是一道稳妥的护栏。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 出自 GitHub 官方社区合集(合集 39,919 stars);技能自身 skills.sh 安装量 678,未见具名第三方评价 |
| 可用性 | 8 | 步骤清晰、带两份参考规则、中途设有确认点;需要已登录的 gh CLI;2026-08 仍有修订 |
| 安全性 | 8 | 纯提示词,无外联;会执行 git push 与 gh pr create,但范围明确、命令可见、版本号需确认 |
综合 = 三项均值 = 7.67。
安全检查清单:① 执行 shell:仅 git/gh,含 git push 分支与标签、gh pr create,范围明确 ② 联网外发:仅向用户自己的 GitHub 仓库推送,无第三方端点 ③ 凭据:复用用户已有的 gh auth,技能本身不索取或存储密钥 ④ 可疑指令:未发现,指令均围绕发版流程 ⑤ 作者/组织信誉:由 GitHub 官方合集维护者审核合并,持续有人修订 ⑥ License:MIT ⑦ 维护:2026-08-07 仍有修订。扣分点:技能会推送分支与标签,用户应在确认版本号后再放行。
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异 |
|---|---|---|
| 本技能 | 单包仓库、分支加 PR 式发版,只用 gh 与 git | 轻量、无额外依赖;版本号以代码差异为主证据;写入前全程只读 |
| ruvnet/ruflo 的 github-release-management | 面向 AI swarm 协调的发版编排,覆盖版本、测试、部署与回滚 | 范围更大,但依赖其自有的多 agent 编排体系,上手门槛更高 |
手工 gh release create 加自写 changelog |
无流程约束 | 灵活,但版本档位与 changelog 质量完全依赖个人经验 |
核心差异:本技能不做部署与回滚,只把“判版本、写日志、开 PR”这段做稳。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。合集 PR 记录显示其由外部贡献者提交、经维护者审核通过后合并。
9. 其他补充
- 命令提供 Bash 与 PowerShell 双版本,Windows 用户可直接用 PowerShell 块。
- 仅针对单包仓库;monorepo 多包独立版本不在覆盖范围。
10. 安装使用方式
git clone https://github.com/github/awesome-copilot.git
cp -r awesome-copilot/skills/github-release ~/.claude/skills/
前置:gh auth status 已登录、工作区干净、位于 GitHub 仓库内。复制后新开会话,用“帮我发一个新版本”之类的话即可触发。Codex 需手动引用该目录。
11. 注意事项
- 技能会创建并推送
release/vX.Y.Z分支,并可能推送标签;请在确认版本号后再放行推送。 - 仅适用于单包 GitHub 仓库;未打过任何标签的仓库默认从
1.0.0起算。 - 依赖
gh与git,未登录 gh 时技能会中止并提示。