HomeJimu HarnessCommunityModelsResourcesDocumentationSkillAgentMCPTeamAbout us
Sign up / Sign in

Quick links

Jimu AI

Jimu AI — tools for building intelligent applications

Loading...
← Back to skills

git-publish-release

v1.0.2
Bensz Conan

GitHub Release 发布助手:根据 Git tag、commit 历史和项目上下文生成版本发布说明与发布前检查清单。 默认只做只读分析和 Release Notes 准备;创建 Release、推送 tag 等外部可见操作必须获得用户明确授权。

WorkflowsGitHub ReleaseRelease Notes版本发布Git
↓ 2 downloads

name: git-publish-release description: | GitHub Release 发布助手:根据 Git tag、commit 历史和项目上下文生成版本发布说明与发布前检查清单。 默认只做只读分析和 Release Notes 准备;创建 Release、推送 tag 等外部可见操作必须获得用户明确授权。 author: "Bensz Conan" license: "MIT" category: "workflow" tags: "GitHub Release, Release Notes, 版本发布, Git" source: "https://github.com/huangwb8/skills/tree/main/git-publish-release" allowed-tools: "run_shell_command, ask_user_question, write_file, read_file, search_file_content"

Git Publish Release:安全发布助手

适用场景

适用于以下需求:

  • 生成 Release Notes
  • 准备发布某个版本
  • 对比两个 tag 之间的变化
  • 创建 GitHub Release
  • 判断某个版本是否应标记为 prerelease

安全原则

  • 默认只分析和生成发布说明,不创建外部 Release
  • 创建 Release、推送 tag、编辑已有 Release 都属于外部可见操作,必须用户明确授权
  • 不自动覆盖已有 Release
  • 不自动创建或推送 tag,除非用户明确要求
  • 不在发布说明中包含密钥、内部路径、未公开问题细节或敏感运行日志
  • 不执行项目构建、打包或部署,除非用户单独要求并确认范围

输入要求

必须确认:

参数 说明
target_tag 目标版本 tag,例如 v1.2.0
previous_tag 可选;未指定时读取最近一个 Release 或 tag 作为比较基线
repo 可选;默认当前 Git 仓库
publish 是否创建 GitHub Release,默认否
prerelease 是否预发布;未指定时根据 tag 名称判断

如果目标 tag 不明确,先列出最近 tag 供用户选择。

工作流程

1. 前置检查

只读检查:

git status --short --branch
git tag --sort=-creatordate
git log -n 5 --oneline

如果用户要求创建 GitHub Release,再检查:

gh auth status
gh repo view --json nameWithOwner

如果 gh 不可用或未认证,只生成发布说明并说明发布步骤被阻塞。

2. 确定比较范围

优先级:

  1. 用户指定 previous_tag
  2. 最近一次 GitHub Release 的 tag
  3. 最近一个早于 target_tag 的本地 tag
  4. 若是首次发布,从首个 commit 到 target_tag

读取 commit 历史:

git log <previous_tag>..<target_tag> --pretty=format:"%h|%s|%an|%ad" --date=short

如果是首次发布,使用:

git log <target_tag> --pretty=format:"%h|%s|%an|%ad" --date=short

3. 生成 Release Notes

按用户和项目风格选择中文或英文。默认中文结构:

# <target_tag> 发布说明

## 版本摘要

一句话说明这个版本的核心价值。

## 主要更新

- ...

## 修复与稳定性

- ...

## 文档与维护

- ...

## 兼容性与迁移

- 是否有破坏性变更
- 是否需要用户修改配置、数据或部署方式

## 完整变更

- `<hash>` <subject>

分类依据:

类别 commit 线索
主要更新 feat、新增能力、重要用户价值
修复与稳定性 fix、bug、稳定性、回归修复
性能与体验 perf、优化、交互、延迟
文档与维护 docs、chore、ci、build、test
兼容性与迁移 breaking、schema、配置、API 变化

4. 发布前确认

如果用户要求创建 Release,先展示:

  • 仓库名
  • target tag
  • previous tag
  • 是否 prerelease
  • Release 标题
  • Release Notes 预览
  • 将执行的命令

确认后再执行外部发布。

5. 创建 GitHub Release

用 write_file 写入临时 notes 文件,然后执行:

gh release create <target_tag> --title <title> --notes-file <notes-file>

如果是预发布,追加:

--prerelease

如果 Release 已存在,不覆盖;询问用户是否要改为编辑模式。

6. 完成验证

发布后只读验证:

gh release view <target_tag> --json url,tagName,name,isPrerelease

报告 Release URL、tag、标题和 prerelease 状态。

输出格式

## 发布准备结果

- 仓库:...
- 目标 tag:...
- 比较范围:...
- prerelease:是/否
- 是否已发布:否 / 是,URL:...

## Release Notes

...

## 验证

- 运行命令:...
- 结果:...
- 遗留问题:...

完成标准

  • 已明确目标 tag 和比较范围
  • Release Notes 来源于真实 commit 历史
  • 外部发布操作只在用户明确授权后执行
  • 发布后如实验证结果
  • 未泄露敏感信息,未覆盖已有 Release,未执行无关部署