feat: Add CLAUDE.md template and changelog skill

Add reusable CLAUDE.md.template with placeholder-based structure for new projects, and add /changelog skill for automated release workflow. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-26 14:10:17 +08:00
parent 709aa55b97
commit 398d0348f8
2 changed files with 215 additions and 0 deletions
@@ -0,0 +1,109 @@
+---
+name: changelog
+description: 一键发版：生成更新日志 → commit → 打 tag，全流程自动化。
+---
+
+# Changelog - 一键发版
+
+> **定位**：发版全流程。`/changelog 0.2.0` 一个命令搞定日志生成 + commit + tag。
+
+## 用法
+
+```
+/changelog <version>        # 例: /changelog 0.2.0
+/changelog                  # 不传版本号则自动推断
+```
+
+## 执行流程
+
+### 1. 确定版本号
+
+**有参数**：直接使用用户传入的版本号。
+
+**无参数**：自动推断。读取最新 tag，按 semver 规则 bump patch 版本 +1。例如当前最新 `v0.1.2` → 推断为 `0.1.3`。若无 tag 则默认 `0.1.0`。
+
+版本格式：`{major}.{minor}.{patch}`（标准 semver）
+
+### 2. 获取 Commits
+
+```bash
+# 找到上一个 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` 标题
+- 将新条目插入已有内容**头部**（标题行之后，最新版本在前），保持现有条目不变
+- 条目格式：
+
+```markdown
+## v{version} ({YYYY-MM-DD})
+
+{summary}
+
+- ✨ xxx
+- 🐛 xxx
+- ♻️ xxx
+```
+
+### 6. Commit + Tag
+
+```bash
+# 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)
+```