Releasing

Releasing Skill

BoxLogプロジェクトのリリース作業を安全かつ確実に実行するためのスキルです。

このスキルを使用するタイミング

以下のキーワードが含まれる場合に自動的に起動：

• 「リリース」「release」
• 「バージョンアップ」「version」
• 「タグを作成」「タグ付け」
• 「v0.X.0をリリース」

リリースワークフロー概要

Phase 0: 準備（PRマージ前）
  ├── 0.1 バージョン番号決定・重複チェック ← 最重要
  ├── 0.2 コード品質確認（lint, typecheck, test, build）
  ├── 0.3 package.json更新
  └── 0.4 リリースノート作成

Phase 1: PRマージ
  ├── 1.1 PR作成
  ├── 1.2 CI/CD確認
  └── 1.3 マージ

Phase 2: タグ作成
  ├── 2.1 mainブランチ更新
  ├── 2.2 Gitタグ作成・プッシュ
  └── 2.3 GitHub Release確認

Phase 3: デプロイ確認
Phase 4: リリース後作業

必須チェック項目

Phase 0.1: バージョン重複チェック（スキップ厳禁）

# 1. 既存リリースを確認
gh release list

# 2. 重複チェック
VERSION="0.X.0"  # リリースするバージョン
gh release view v${VERSION} 2>/dev/null && echo "❌ Already exists!" || echo "✅ OK"

重複が見つかった場合: 必ず「v0.X.0ではなくv0.Y.0じゃないですか？」と確認する

Phase 0.2: コード品質

npm run lint && npm run typecheck && npm run test:run && npm run build

Phase 0.3: バージョン更新

# PATCH: バグ修正 (0.3.0 → 0.3.1)
npm version patch --no-git-tag-version

# MINOR: 新機能 (0.3.0 → 0.4.0)
npm version minor --no-git-tag-version

# MAJOR: 破壊的変更 (0.3.0 → 1.0.0)
npm version major --no-git-tag-version

Phase 0.4: リリースノート

# 前回リリース以降の全PRを取得
gh pr list --state merged --base main --limit 100 --json number,title,mergedAt

# テンプレートをコピー
cp docs/releases/template.md docs/releases/RELEASE_NOTES_v${VERSION}.md

必須項目:

• 全PRが含まれている
• Full Changelogリンクがある
• カテゴリ別に整理（Added, Changed, Fixed等）

詳細ドキュメント

完全なチェックリスト: docs/releases/RELEASE_CHECKLIST.md

よくある失敗

スクリプト

バージョン重複チェック

.claude/skills/releasing/scripts/check-version.sh 0.X.0

マージ済みPR取得

.claude/skills/releasing/scripts/get-merged-prs.sh