release - SKILL.md Agent Skill

name: release description: abbrsのバージョン更新、GitHubリリース、crates.io publishを実行する。 user_invocable: true disable-model-invocation: true allowed-tools: Bash(git status ), Bash(git branch ), Bash(git tag ), Bash(git add ), Bash(git commit ), Bash(git push ), Bash(git rev-parse ), Bash(cargo test ), Bash(gh workflow run ), Bash(gh run list ), Bash(gh run watch *), Edit, Read, Grep, Glob

abbrsのリリース手順を実行するスキル。

引数	必須	説明
version	Yes	リリースするバージョン（例: 0.3.0）

/release 0.3.0

引数検証
- バージョン引数が指定されていることを確認
- semver形式（X.Y.Z）であることを確認
現在のバージョン確認
```
grep '^version' Cargo.toml | head -1
```
git状態確認
```
git status --porcelain
git branch --show-current
```
- mainブランチにいることを確認
- ワーキングディレクトリがクリーンでない場合は警告して中断
既存タグ確認
```
git tag --list 'v*' --sort=-version:refname | head -10
```
- 同じバージョンのタグが既に存在する場合は中断

Cargo.tomlのバージョン更新
- version = "X.Y.Z" を新しいバージョンに更新
ビルド確認（Cargo.lockは使用していないためcheck不要）
```
cargo test
```
- 失敗した場合は中断
- cargo test により Cargo.lock が更新される

変更をコミット
```
git add Cargo.toml Cargo.lock
git commit -m "chore: bump version to {version}"
```
- 重要: Cargo.lock も必ずコミットすること。CIの cargo publish --dry-run が未コミットファイルを検出して失敗する。
mainブランチにプッシュ
```
git push origin main
```

バンプコミットのフルSHA取得
```
BUMP_SHA=$(git rev-parse HEAD)
```
- 重要: ワークフローは bump_sha がフルハッシュ（40文字）であることを前提とする。短縮SHAは使用不可。
- ワークフローはこのSHAが origin/main のHEADであることを検証する。

ワークフロー起動

gh workflow run release.yml -f version={version} -f bump_sha=$BUMP_SHA

進捗確認
```
gh run list --workflow=release.yml --limit 1
gh run watch <run-id>
```
- ワークフローが validate → test → build → release → publish を自動実行
- validate/test/build/release の失敗時はバンプコミットが自動revertされる

リリースワークフロー (.github/workflows/release.yml) は以下を実行する:

ジョブ	内容
validate	semver検証、bump_sha == origin/main HEAD検証、Cargo.tomlバージョン一致確認、タグ重複チェック、actions SHA pinチェック
test	`cargo test` + `cargo publish --dry-run`
build	4プラットフォーム向けリリースビルド（x86_64-linux, aarch64-linux, x86_64-macos, aarch64-macos）
release	タグ作成・プッシュ、アーティファクトダウンロード、GitHub Release作成
publish	OIDC経由でcrates.ioトークン取得、`cargo publish`
rollback	test/build/release失敗時に自動実行（コミットrevert、タグ・リリース削除）