Git 提交与变更日志
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_b348691b/git-commit-changelog。
技能介绍
你实际卡在什么地方
个人仓库或小团队里,常见两块碎片活:git add 之后不知道改动该怎么归类成一条像样的提交说明;发版前要从 git log 里人肉筛 feat/fix,再排版成 CHANGELOG。手写时类型词乱用、subject 带句号、长度失控,团队更惨——有人 push 了「update」类含糊信息,后面 bisect 和 release note 都对不上。
技能怎么处理
技能先把暂存区当作唯一事实来源:用 git diff --cached 统计文件数、增删行、目录分布,再推断更接近 feat/fix/docs/refactor 等哪一类,并按 Conventional Commits(type(scope): subject)给出候选 subject(长度与句号等会做校验)。你确认后只执行 git commit,默认不 push,避免误推到远端。
另一条线是 CHANGELOG:在指定 tag 或提交区间(如 v1.2.0..HEAD)上读 git log,按 Added/Changed/Fixed 等分组,输出符合 Keep a Changelog 习惯的 CHANGELOG.md,并带上版本号与日期。还能把 commit_msg_hook 写入 .git/hooks/commit-msg,让不规范的提交信息在本地就被拦住;若暂存区为空、不在 git 仓库、pre-commit 失败、或 diff 含冲突标记/过大,会明确提示而不是硬生成。
适用边界
依赖本机 Git 2.20+ 与 Python 3.8+(脚本侧主要是标准库)。它理解的是已暂存改动;没 git add 会先提醒你。允许的 type 列表可与仓库里的 .commitlintrc 对齐——团队若自定义类型,需要保持配置一致,否则校验会报「类型不在允许列表」。
使用场景
- 功能开发完已 `git add`,需要按 auth 等 scope 写一条 feat 提交说明再本地 commit
- 发版前要从 `v1.2.0` 到 HEAD 的提交整理成 Keep a Changelog 结构的 CHANGELOG.md
- 新成员总用含糊的 commit message,想在仓库里装好 commit-msg 钩子统一拦截
- merge 后暂存区 diff 很大,希望先判断类型与 scope 再确认是否执行 `git commit`
适合人员
- 维护个人开源库、每次发版都要手写 CHANGELOG 的独立维护者
- 两三人的产品组,希望 commit 类型统一、又不想让 CI 里才第一次发现信息不规范
- 带 pre-commit 的 Python/前端仓库负责人,想在本地提交阶段就卡死不合规的 subject
- 偶尔帮同事 review 提交历史、需要把区间内 fix/feat 摘成发布说明的 release 志愿者