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

62 lines
2.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 示例Release 版本管理(真实数据)
> 本示例基于 `chroe/gitlink-cli` 项目于 2026-06-09 在 Claude Code 中实际执行。
---
## 执行命令序列
```bash
# 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 → 确认发布成功
```