skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
youlaitech/youlai-skills81 installs

git-version

用于生成规范化提交信息、管理语义化版本、创建 Git 标签以及生成变更日志与发布说明。适用于提交、打标签或发布流程;提交格式与版本规则以仓库约定为准。

How do I install this agent skill?

npx skills add https://github.com/youlaitech/youlai-skills --skill git-version
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides standard guidelines and command templates for Git version control automation, including conventional commits, semantic versioning, and changelog generation. It uses industry-standard practices and common developer tools without any detected security risks.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Git 版本管理自动化规范

Commit Message 规范

格式

<type>(<scope>): <subject>

<body>

<footer>

Type 类型

Type说明示例
feat新功能feat(user): 添加用户登录功能
fixBug 修复fix(auth): 修复 Token 过期验证问题
docs文档更新docs(readme): 更新安装说明
style代码格式(不影响功能)style: 格式化代码缩进
refactor重构(非新功能、非 Bug 修复)refactor(user): 重构用户服务层
perf性能优化perf(query): 优化分页查询性能
test测试相关test(user): 添加用户服务单元测试
chore构建/工具相关chore: 更新依赖版本
ciCI/CD 相关ci: 添加 GitHub Actions 工作流
build构建系统相关build: 升级 webpack 配置
revert回滚提交revert: 回滚用户登录功能

Scope 范围

Scope说明
auth认证授权
user / role / menu / dept / dict / notice业务模块
log / file / api日志/文件/接口
db / config / deps数据库/配置/依赖

自动生成流程

  1. 分析变更:git diff --cached --stat && git diff --cached --name-status
  2. 识别类型:新增文件 → feat,修改配置 → chore,删除文件 → refactor
  3. 生成 Message 示例:
feat(user): 添加用户头像上传功能

- 支持 JPG/PNG 格式
- 限制文件大小 2MB
- 自动压缩图片

语义化版本规范

版本格式

MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
部分说明更新时机
MAJOR主版本号不兼容的 API 变更
MINOR次版本号向后兼容的功能新增
PATCH修订号向后兼容的问题修复
PRERELEASE预发布标识alpha, beta, rc

版本递增规则

Commit Type版本递增
featMINOR +1, PATCH = 0
fixPATCH +1
feat! 或 BREAKING CHANGEMAJOR +1, MINOR = 0, PATCH = 0
docs / style / refactor / test / chore不递增

预发布版本

阶段版本示例说明
Alpha1.0.0-alpha.1内部测试
Beta1.0.0-beta.1公开测试
Release Candidate1.0.0-rc.1候选发布
Release1.0.0正式发布

版本文件同步

项目类型版本文件更新方式
Node.jspackage.json修改 version 字段
Java Mavenpom.xml修改 <version> 标签
Pythonpyproject.toml修改 version 字段
Go可选或跳过—

Git Tag 规范

命名格式

类型格式示例
正式版本v{VERSION}v1.0.0
预发布版本v{VERSION}-{PRERELEASE}.{N}v1.0.0-beta.1

创建带注释 Tag

git tag -a v1.0.0 -m "Release v1.0.0

Features:
- 用户登录功能
- 角色权限管理

Fixes:
- 修复 Token 过期问题"

常用命令

git tag -l                              # 列出所有 Tag
git tag -l "v1.*"                       # 匹配 Tag
git show v1.0.0                         # 查看 Tag 详情
git tag -d v1.0.0                       # 删除本地 Tag
git push origin --delete v1.0.0        # 删除远程 Tag
git push origin v1.0.0                  # 推送单个 Tag
git push origin --tags                  # 推送所有 Tag

Changelog 规范

格式模板

基于 Keep a Changelog:

# Changelog

## [Unreleased]
### Added / Changed / Deprecated / Removed / Fixed / Security

## [1.0.0] - 2024-01-15
### Added
- 用户登录功能
- 角色权限管理

### Fixed
- 修复 Token 过期验证问题 (#123)

### Security
- 升级 JWT 库修复安全漏洞

变更分类

分类说明
Added新增功能
Changed功能变更
Deprecated即将废弃
Removed已移除
FixedBug 修复
Security安全相关

自动生成

git log v0.9.0..v1.0.0 --pretty=format:"%s" | grep "^feat" | sed 's/feat/### Added/'
git log v0.9.0..v1.0.0 --pretty=format:"%s" | grep "^fix" | sed 's/fix/### Fixed/'

Release Notes 规范

# Release v1.0.0

## 🎉 新功能
### 用户管理
- **用户登录** - 支持 JWT 和 Redis Token 两种认证模式
- **角色权限** - 基于 RBAC 的细粒度权限控制

## 🐛 Bug 修复
- 修复 Token 过期后前端未正确跳转登录页的问题 (#123)

## 💥 重大变更
- API 路径统一调整为 `/api/v1/` 前缀

## 📦 依赖更新
- 升级 Spring Boot 至 3.2.0

## 完整变更日志
完整变更记录见 CHANGELOG.md。

自动化工作流

标准发布流程

1. git status                  — 检查工作区状态
2. git checkout main && git pull — 确保在主分支
3. git add . && git commit -m "..." — 提交变更
4. git push origin main        — 推送
5. 确定版本号 → 更新版本文件    — version bump
6. git add . && git commit -m "chore: release vX.X.X"
7. git tag -a vX.X.X -m "Release vX.X.X"
8. git push origin vX.X.X      — 推送 Tag
9. git push origin main         — 推送版本更新提交

⚠️ 注意顺序:先提交代码 → 创建 Tag → 更新版本文件 → 提交版本更新 → 推送

版本发布检查清单

  • 所有测试通过
  • 代码已 Review
  • CHANGELOG.md 已更新
  • 版本号已更新
  • Tag 已创建并推送

Windows PowerShell 兼容性

BashPowerShell说明
cmd1 && cmd2cmd1; cmd2 或分开执行PowerShell 不支持 &&
head -5Select-Object -First 5无 head
grepSelect-String 或 findstr无 grep
sed-replace无 sed
# Windows 示例
git add .
git commit -m "feat: 新功能"
git push

# 查看最近 5 个 Tag
git tag -l "v*" --sort=-v:refname | Select-Object -First 5

常见问题

推送被拒绝

# Rebase(推荐,保持历史线性)
git pull --rebase origin master
git push origin master

Rebase 后提交丢失

git reflog -10                      # 查找丢失的提交
git cherry-pick <commit-hash>       # 恢复
git push origin master

Tag 创建在错误提交上

git tag -d v1.0.0                   # 删本地
git push origin --delete v1.0.0    # 删远程
git tag -a v1.0.0 <correct-hash> -m "Release v1.0.0"
git push origin v1.0.0

常见反模式

反模式正确做法
git add -A && git commit -m "update"分步暂存,写有意义 Message
git push --force 到 main/master用 --force-with-lease 或禁止
Tag 无 -a 无 messagegit tag -a v1.0.0 -m "Release v1.0.0"
commit message fix bug 无 scope/详情fix(auth): 修复 Token 过期后无限循环刷新
版本号跳跃不递增feat → MINOR+1, fix → PATCH+1
不更新 CHANGELOG 就发版Changelog 与 Tag 同步更新

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/youlaitech/youlai-skills/git-version">View git-version on skillZs</a>