release

分类: 内容与多媒体 | 上传者: vaayne | 下载: 0 | 版本: v1.0（最新）

发布 anna Go CLI 项目的工作流程。使用语义版本化标签创建版本、更新变更日志并触发自动化 CI/CD 构建。当用户要求“发布”、“创建发布”、“标记版本”、“更新变更日志”、“准备发布”、“剪切发布”或讨论版本控制和发布工件时使用。 --- # Release ## 标签格式使用带有 `v` 前缀的语义版本控制：`v0.1.0`、`v1.0.0`、`v1.2.3-rc.1`。 GoReleaser 自动检测预发布后缀（`-rc.1`、`-beta.1`）。 ## 发布流程 1. 更新 `docs/content/docs/changelog.mdx` （见下文） 2. 提交：`📝 docs: Update CHANGELOG for vX.Y.Z` 3. 标签：`git tag vX.Y.Z` 4. 推送：`git push origin main --tags` 5. CI 触发器 `.github/workflows/release.yml` → GoReleaser 二进制文件 + Docker 镜像 ## 更新变更日志变更日志位于“docs/content/docs/changelog.mdx”（在文档站点上呈现）。它有 YAML frontmatter——编辑时保留它。只修改`---`块下面的内容。

更新日志: Source: GitHub https://github.com/vaayne/anna

目录结构

当前层级: tree/main/.agents/skills/release/

📄 SKILL.md 2.1 KB

SKILL.md

---
name: release
description: >
  Release workflow for anna Go CLI project. Create releases with semantic versioned
  tags, update changelog, and trigger automated CI/CD builds. Use when the user
  asks to "release", "create a release", "tag a version", "update changelog",
  "prepare release", "cut a release", or discusses versioning and release artifacts.
---

# Release

## Tag Format

Use semantic versioning with `v` prefix: `v0.1.0`, `v1.0.0`, `v1.2.3-rc.1`.
GoReleaser auto-detects pre-release suffixes (`-rc.1`, `-beta.1`).

## Release Flow

1. Update `docs/content/docs/changelog.mdx` (see below)
2. Commit: `📝 docs: Update CHANGELOG for vX.Y.Z`
3. Tag: `git tag vX.Y.Z`
4. Push: `git push origin main --tags`
5. CI triggers `.github/workflows/release.yml` → GoReleaser binaries + Docker images

## Update Changelog

The changelog lives at `docs/content/docs/changelog.mdx` (rendered on the docs site).
It has YAML frontmatter — preserve it when editing. Only modify content below the `---` block.

Gather changes since last tag:

```bash
git log $(git describe --tags --abbrev=0 2>/dev/null || git rev-list --max-parents=0 HEAD)..HEAD --oneline
gh pr list --state merged --base main --search "merged:>=$(git log -1 --format=%aI $(git describe --tags --abbrev=0 2>/dev/null || git rev-list --max-parents=0 HEAD))"
```

Apply to `docs/content/docs/changelog.mdx`:

1. Rename `[Unreleased]` to `[X.Y.Z] - YYYY-MM-DD`
2. Add fresh `[Unreleased]` section above
3. Categorize: `✨ Features`, `🐛 Bug Fixes`, `♻️ Refactoring`, `📝 Documentation`, `📦 Dependencies`
4. Link PRs: `([#123](https://github.com/vaayne/anna/pull/123))`
5. Append: `**Full Changelog**: [vPREV...vX.Y.Z](https://github.com/vaayne/anna/compare/vPREV...vX.Y.Z)`

## Validate and Test

```bash
mise run release:check     # Validate .goreleaser.yaml
mise run release:snapshot  # Test release locally (no tag needed)
```

## Artifacts

- **Binaries**: linux/darwin/windows × amd64/arm64 (GoReleaser)
- **Docker**: `ghcr.io/vaayne/anna` — linux/amd64 + linux/arm64
- **Docker tags**: `latest` (stable), `vX.Y.Z` (release), SHA (every build)

登录后下载/点赞/收藏 ❤ 10 | ★ 0

release

目录结构

SKILL.md

举报内容

提示