gitlink-cli/skills/gitlink-release/examples/release-workflow.md

示例：Release 版本管理（真实数据）

本示例基于 chroe/gitlink-cli 项目于 2026-06-09 在 Claude Code 中实际执行。

---

执行命令序列

# Step 1: 查看已有 Release
gitlink-cli release +list --owner chroe --repo gitlink-cli --format json
# 结果: 1 个版本
#   tag=v0.1.13-freebsd, id=1986, created=2026-06-03 23:51, draft=稳定

# Step 2: 查看 Release 详情
gitlink-cli release +view --owner chroe --repo gitlink-cli --id 1986 --format json
# 结果:
#   tag=v0.1.13-freebsd
#   name=v0.1.13-freebsd (测试版 - 含FreeBSD支持)
#   body=测试版本，新增FreeBSD amd64/arm64平台支持。改动：- 修复CI Go版本(1.22->1.26) - 新增FreeBSD amd64/arm64构建目标 - Windows凭据路径改用%AppData% - 删除重复的scripts/install.js 包含8个平台的二进制文件。
#   target=master, user=caoweiqiong (CWQ)

# Step 3: 创建 Release（需要认证，tag 必须已存在）
gitlink-cli release +create --owner chroe --repo gitlink-cli \
  --tag test-skill-example \
  --name "test-skill-example (测试用)" \
  --body "这是一个测试 Release，验证 create 命令。" \
  --format json
# 结果: ok=true, message="发布成功"

# Step 4: 确认创建成功
gitlink-cli release +list --owner chroe --repo gitlink-cli --format json
# 结果: 2 个版本
#   tag=test-skill-example,   id=2022, created=2026-06-13 10:53
#   tag=v0.1.13-freebsd,      id=1986, created=2026-06-03 23:51

# Step 5: 删除测试 Release（使用 version_id，不是 tag_name）
gitlink-cli release +delete --owner chroe --repo gitlink-cli --id 2022 --format json
# 结果: ok=true, message="删除成功"

# Step 6: 确认删除成功
gitlink-cli release +list --owner chroe --repo gitlink-cli --format json
# 结果: 1 个版本，只剩 v0.1.13-freebsd

完整工作流

用户："帮我发布 v0.2.0 版本"

AI 执行流程：
1. release +list → 获取上一个版本 v0.1.13-freebsd 的发布时间
2. commit +list → 筛选之后的提交，按分类生成 Release Notes
3. 展示 Release Notes 给用户确认
4. 用户确认后：
   gitlink-cli release +create \
     --tag v0.2.0 \
     --name "v0.2.0" \
     --body "<Release Notes 内容>"
5. release +view → 确认发布成功