AgentSkillsCN

release

当用户提到“发布”“release”“新版本”“版本升级”时,可使用此功能发布新版本。

SKILL.md
--- frontmatter
name: release
description: 新しいバージョンをリリースする。「リリース」「release」「新バージョン」「バージョンアップ」と言われた場合に使用する。
disable-model-invocation: true
argument-hint: [version]

リリースワークフロー

新しいバージョン $ARGUMENTS をリリースします。

前提条件

  • main ブランチにいること
  • 未コミットの変更がないこと
  • CI が通っていること

手順

1. 事前確認

bash
# 現在のブランチとステータス確認
git branch --show-current
git status

未コミットの変更がある場合は、先にコミットまたは stash してください。

2. バージョン決定

引数でバージョンが指定されていない場合、以下を確認:

bash
# 最新のタグを確認
git describe --tags --abbrev=0 2>/dev/null || echo "タグなし"

# 前回リリースからの変更を確認
git log $(git describe --tags --abbrev=0 2>/dev/null)..HEAD --oneline

Semantic Versioning ガイド

変更内容バージョン
破壊的変更(BREAKING CHANGE)メジャーv1.0.0 → v2.0.0
新機能追加(feat:)マイナーv1.0.0 → v1.1.0
バグ修正(fix:)パッチv1.0.0 → v1.0.1

3. CHANGELOG 確認

GoReleaser が自動生成するため、手動での CHANGELOG.md 更新は不要。 リリースノートには以下のコミットが含まれる:

  • feat: - 新機能
  • fix: - バグ修正
  • BREAKING CHANGE: - 破壊的変更

4. タグ作成とプッシュ

bash
# タグを作成(例: v1.2.0)
git tag -a v<VERSION> -m "Release v<VERSION>"

# タグをプッシュ(GitHub Actions が自動でリリース)
git push origin v<VERSION>

5. リリース確認

GitHub Actions でリリースワークフローが実行される:

  1. テスト実行
  2. GoReleaser によるビルド
  3. GitHub Release 作成(バイナリ添付)
bash
# ワークフロー状態確認
gh run list --workflow=release.yml --limit 3

6. リリース完了確認

bash
# GitHub Release を確認
gh release view v<VERSION>

# または Web で確認
gh release view v<VERSION> --web

使用例

bash
/release v1.0.0
/release v1.1.0
/release v2.0.0

トラブルシューティング

タグを削除したい場合

bash
# ローカルタグ削除
git tag -d v<VERSION>

# リモートタグ削除(未リリースの場合のみ)
git push origin :refs/tags/v<VERSION>

リリースをやり直したい場合

  1. GitHub Release を削除
  2. タグを削除(上記参照)
  3. 修正をコミット
  4. 再度タグ作成・プッシュ