gitlink-cli/skills/gitlink-changelog/examples/generate-release-notes.md

示例：Release Notes 生成（真实数据）

本示例基于 chroe/gitlink-cli 项目于 2026-06-09 在 Claude Code 中实际执行。 展示从 v0.1.13-freebsd（上一个 Release，2026-06-03 23:51）到当前时间段的变更。

---

执行命令序列

# Step 1: 获取上一个版本（确定时间基线）
gitlink-cli release +list --owner chroe --repo gitlink-cli --format json
# 结果: 1 个版本, tag=v0.1.13-freebsd, created=2026-06-03 23:51

# Step 2: 获取提交历史（AI 按时间戳筛选基线之后的提交）
gitlink-cli commit +list --owner chroe --repo gitlink-cli --format json
# 结果: 本页 20 个提交，基线之后 20 个（含 2 个 merge commit 需跳过）
# 如需更多: gitlink-cli commit +list --owner chroe --repo gitlink-cli --page 2 --format json

# Step 3: 获取 PR（本项目为 Fork，无 PR 记录）
gitlink-cli pr +list --owner chroe --repo gitlink-cli --state merged --format json
# 结果: merged_issues_size=0

# Step 4: 获取已关闭 Issue
gitlink-cli issue +list --owner chroe --repo gitlink-cli --state closed --format json
# 结果: 6 个已关闭 Issue（#1~#6）

Commit 分类过程（20 条提交）

#	commit message（首行）	作者	分类结果
1	fix(skills): gitlink-health 评分算法修复...	chroe	🐛 Bug 修复
2	feat(skills): 新增 3 个 AI Agent Skill...	chroe	✨ 新功能
3	fix(showcase): 移除 rebase 残留...	chroe	🐛 Bug 修复
4	refactor(showcase): 成员管理卡片优化	chroe	🔧 改进优化
5	删除不可用的批量操作...新增批量评论...	yetja	🔧 改进优化
6	refactor(showcase): 批量组织邀请合并...	chroe	🔧 改进优化
7	fix(org): batch-invite 用户名自动解析...	chroe	🐛 Bug 修复
8	chore: batch-delete 默认改用 fork 后的路径	chroe	🏗️ 构建/CI
9	chore: 更新仓库管理默认示例为真实仓库	chroe	🏗️ 构建/CI
10	chore: 恢复 repo 批量管理卡片	chroe	🏗️ 构建/CI
11	fix: 移除 batch-milestone (v1 PATCH不生效)	chroe	🐛 Bug 修复
12	fix: 移除 batch-label (API不支持标签关联)	chroe	🐛 Bug 修复
13	fix: 移除 assign/batch-assign (API不支持)	chroe	🐛 Bug 修复
14	fix: assign 传递数字 ID + 保留 status_id	chroe	🐛 Bug 修复
15	Merge branch 'master' of...	chroe	⏭️ 跳过
16	feat: 添加 reopen/batch-reopen 命令	chroe	✨ 新功能
17	delete test file	chroe	⏭️ 跳过
18	add test file	chroe	⏭️ 跳过
19	fix: watch/star 模块 resolveProjectID...	chroe	🐛 Bug 修复
20	Merge branch 'master' of...	chroe	⏭️ 跳过

生成的 Release Notes

# 🚀 v0.2.0 (2026-06-09)

> 基于 v0.1.13-freebsd (2026-06-03 23:51) 之后的变更生成

## 📝 版本摘要

本版本为 Skills 生态扩展版本，新增 3 个 AI Agent Skill（项目健康度报告、Release Notes 自动生成、Issue 智能分拣），
新增 reopen/batch-reopen 命令，清理了多个 GitLink API 不支持的批量操作命令，并修复了 Showcase 前端和模块兼容性问题。

## ✨ 新功能 (Features)

- **skills**: 新增 `gitlink-health` Skill — 项目健康度报告（Issue/PR/贡献者/活跃度四维评分）(by @chroe)
- **skills**: 新增 `gitlink-changelog` Skill — 从 commit/PR/Issue 历史自动生成 Release Notes (by @chroe)
- **skills**: 新增 `gitlink-triage` Skill — Issue 智能分拣 + 新人引导 (by @chroe)
- **issue**: 新增 reopen/batch-reopen 命令 (by @chroe)

## 🐛 问题修复 (Bug Fixes)

- **skills**: 修复 gitlink-health 评分算法 — fallback 策略和贡献集中度计算 (by @chroe)
- **showcase**: 修复 rebase 残留 commit message 导致 JS 语法错误白屏 (by @chroe)
- **org**: batch-invite 用户名自动解析为数字 ID，修正 Showcase 默认值 (by @chroe)
- **watch/star**: 修复 resolveProjectID 兼容 project_id 字段 (by @chroe)
- **batch**: 移除 batch-milestone（GitLink v1 PATCH 实际不生效）(by @chroe)
- **batch**: 移除 batch-label（GitLink API 不支持 Issue 标签关联）(by @chroe)
- **batch**: 移除 assign/batch-assign（GitLink API 不支持）(by @chroe)
- **assign**: 传递数字 ID + 保留 status_id 防止状态被重置 (by @chroe)

## 🔧 改进优化 (Improvements)

- **showcase**: 成员管理卡片优化 — 组织 ID 查找改为 `org +info`，新增仓库选择器 (by @chroe)
- **showcase**: 批量组织邀请合并到成员管理卡片 (by @chroe)
- **batch**: 移除不可用的批量操作，新增批量评论、批量仓库管理 (by @yetja)

## 🏗️ 构建/CI (Build & CI)

- batch-delete 默认改用 fork 后的仓库路径 (by @chroe)
- 更新仓库管理默认示例为真实仓库 (by @chroe)
- 恢复 repo 批量管理卡片 (by @chroe)

## 🙏 贡献者

感谢以下贡献者参与本版本开发：

@chroe, @yetja, @caoweiqiong (CWQ)

## 📊 变更统计

| 类型 | 数量 |
|------|------|
| 新功能 | 4 |
| Bug 修复 | 8 |
| 改进优化 | 3 |
| 构建/CI | 3 |
| 跳过（merge/test） | 4 |
| 合计 | 18（有效 16）|