releasing

BoxLogのリリース作業をガイド。バージョン決定、重複チェック、リリースノート作成、タグ付けまでの全プロセスを支援。

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

The Releasing Skill is a specialized automation agent designed to manage the end-to-end release lifecycle of the BoxLog project. It ensures deployment safety by enforcing a structured workflow that includes versioning logic, duplicate tag prevention, automated quality checks, and comprehensive release note generation, significantly reducing the risk of human error during software delivery.

Use Cases

  • Version Management: Automatically determining patch, minor, or major version updates and performing mandatory checks against existing GitHub releases to prevent version conflicts.
  • Automated Release Documentation: Fetching all merged pull requests since the last release to generate structured release notes based on predefined templates.
  • Pre-release Quality Gates: Executing a full suite of linting, type-checking, and unit tests to verify code integrity before any release PR is merged.
  • Git Operations & Tagging: Guiding the user through the complete Git workflow, including branch updates, creating GitHub tags, and verifying successful deployment.
namereleasing
descriptionBoxLogのリリース作業をガイド。バージョン決定、重複チェック、リリースノート作成、タグ付けまでの全プロセスを支援。

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

よくある失敗

失敗 対策
バージョン重複 Phase 0.1で必ず gh release view
package.json更新忘れ Phase 0.3でPRマージ前に更新
Full Changelog抜け template.mdをコピーして使用
一部PRのみ記載 gh pr list --state merged で全件取得

スクリプト

バージョン重複チェック

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

マージ済みPR取得

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