release

name	release
description	gitfilmのバージョン更新、GitHubリリースを実行する。
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(moon test *), Bash(gh workflow run *), Bash(gh run list *), Bash(gh run watch *), Edit, Read, Grep, Glob

Release Workflow

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

引数

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

使用例

/release 0.2.0

実行フロー

Phase 1: 事前確認

1. 引数検証

   • バージョン引数が指定されていることを確認
   • semver形式（X.Y.Z）であることを確認

2. 現在のバージョン確認

   grep '"version"' moon.mod.json
   

3. git状態確認

   git status --porcelain
   git branch --show-current
   

   • mainブランチにいることを確認
   • ワーキングディレクトリがクリーンでない場合は警告して中断

4. 既存タグ確認

   git tag --list 'v*' --sort=-version:refname | head -10
   

   • 同じバージョンのタグが既に存在する場合は中断

Phase 2: バージョン更新

1. moon.mod.jsonのバージョン更新

   • "version": "X.Y.Z" を新しいバージョンに更新

2. テスト実行

   moon test
   

   • 失敗した場合は中断

Phase 3: コミット & プッシュ

1. 変更をコミット

   git add moon.mod.json
   git commit -m "chore: bump version to {version}"
   

2. mainブランチにプッシュ

   git push origin main
   

Phase 4: リリースワークフロー起動

1. バンプコミットのフルSHA取得

   BUMP_SHA=$(git rev-parse HEAD)
   

   • 重要: ワークフローは bump_sha がフルハッシュ（40文字）であることを前提とする。

2. ワークフロー起動

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

3. 進捗確認

   gh run list --workflow=release.yml --limit 1
   gh run watch <run-id>
   

   • ワークフローが validate → test → build → release を自動実行
   • validate/test/build/release の失敗時はバンプコミットが自動revertされる

前提条件

• gh CLIがインストール・認証済み
• mainブランチにいること
• ワーキングディレクトリがクリーンであること

ワークフローの処理内容

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

ジョブ	内容
validate	semver検証、bump_sha == origin/main HEAD検証、moon.mod.jsonバージョン一致確認、タグ重複チェック
test	moon test
build	4プラットフォーム向けビルド（x86_64-linux, aarch64-macos はネイティブ、x86_64-macos, aarch64-linux はクロスコンパイル）
release	タグ作成・プッシュ、アーティファクトダウンロード、GitHub Release作成
rollback	test/build/release失敗時に自動実行（コミットrevert、タグ・リリース削除）

エラー時のリカバリ

validate/test/build/release の失敗

• 自動rollback（バンプコミットrevert + タグ/リリース削除）が実行される
• 原因を修正後、Phase 2 からやり直す

ネットワークエラー（ワークフロー起動自体の失敗）

• gh workflow run release.yml -f version={version} -f bump_sha=$BUMP_SHA で再試行