spec-coding-skills/.claude/skills/changelog/SKILL.md

name	description
changelog	一键发版：生成更新日志 → commit → 打 tag，全流程自动化。

Changelog - 一键发版

定位：发版全流程。/changelog 1.0.0227.1 一个命令搞定日志生成 + commit + tag。

用法

/changelog <version>        # 例: /changelog 1.0.0227.1
/changelog                  # 不传版本号则自动推断

执行流程

1. 确定版本号

有参数：直接使用用户传入的版本号。

无参数：自动推断。读取最新 tag，bump build 号 +1。例如当前最新 v1.1.0211.1 → 推断为 1.1.0211.2。若无 tag 则提示用户输入。

版本格式：{major}.{minor}.{MMDD}.{build}

2. 获取 Commits

# 找到上一个 tag
git tag --sort=-creatordate

# 读取 commits（从上一个 tag 到 HEAD）
git log {prev_tag}..HEAD --oneline --no-merges

如果没有上一个 tag，则从初始 commit 开始。

3. AI 总结

将 commit 列表总结为用户友好的中文更新说明：

type	emoji	说明
feat	✨	新功能 / 新 Skill
fix	🐛	Bug 修复
refactor	♻️	代码重构
docs	📝	文档更新
chore	🔧	杂项维护

规则：

• 每条说明 1 句话，简洁明了
• 合并相关的小 commit 为一条
• 面向用户描述（不要出现技术细节如文件名、函数名）
• summary：一句话概括本次更新的核心主题

4. 展示草稿，等待确认

📦 v{version} · {date}
{summary}

✨ 新增 /go 执行按钮 Skill...
📝 更新 README 文档格式...
🐛 修复仓库 URL 配置...

必须等用户确认或修改后才继续。

5. 写入文件

用户确认后，更新 CHANGELOG.md：

• 文件不存在时创建，头部加 # Changelog 标题
• 将新条目插入已有内容头部（标题行之后，最新版本在前），保持现有条目不变
• 条目格式：

## v{version} ({YYYY-MM-DD})

{summary}

- ✨ xxx
- 🐛 xxx
- ♻️ xxx

6. Commit + Tag

# Stage 变更文件
git add CHANGELOG.md

# Commit
git commit -m "release: v{version}"

# 打 tag
git tag v{version}

7. 完成提示

✅ 发版完成！
- 📝 CHANGELOG.md: 新增 v{version} 条目
- 🏷️ git tag: v{version}

需要 push 到远程吗？(git push && git push --tags)