# Release Workflow

> リリースワークフロー全体のガイド。CHANGELOG 形式、セマンティックバージョニング、Git フローのベストプラクティス。「release」「リリース」「version」「バージョン」「CHANGELOG」「tag」「GitHub Release」などのキーワードで自動適用。

- Skill: `no-problem-dev/release-workflow` (Agent Skill)
- Install (CLI): `npx skillmds@latest add no-problem-dev/release-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/no-problem-dev/release-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity, DevOps & Infra
- Author: no-problem-dev (https://skillmd.com/u/no-problem-dev)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/no-problem-dev/release-workflow

---


# リリースワークフローガイド（v2.0）

リリースプロセス全体を統合管理するオーケストレーター。

## 重要: 明示的な呼び出しのみ

リリース操作はユーザーの明示的な指示で実行すること。プロアクティブに実行しない。

## スキル

| スキル | 用途 | 使いどころ |
|--------|------|-----------|
| **release-prepare** | リリース準備 | 「リリース準備」「release prepare」 |
| **changelog-manage** | CHANGELOG + バージョン管理 | 「CHANGELOG 追加」「バージョン計算」 |

## 参照ドキュメント

プラグインルートの詳細実装例:
- `../../references/RELEASE_PROCESS.md` — リリースプロセス完全ガイド
- `../../references/auto-release-on-merge.yml` — GitHub Actions ワークフロー

## セマンティックバージョニング

形式: `MAJOR.MINOR.PATCH`（[Semantic Versioning 2.0.0](https://semver.org/)）

| 変更種別 | バージョン | 例 | 説明 |
|---------|-----------|-----|------|
| バグ修正のみ | PATCH | 1.0.0 → 1.0.1 | 後方互換のバグ修正 |
| 新機能追加 | MINOR | 1.0.1 → 1.1.0 | 後方互換の機能追加 |
| 破壊的変更 | MAJOR | 1.1.0 → 2.0.0 | 互換性のない変更 |

プレリリース: `1.0.0-alpha.1`, `1.0.0-beta.1`, `1.0.0-rc.1`

## CHANGELOG 形式

[Keep a Changelog](https://keepachangelog.com/) 準拠:

```markdown
# Changelog

## [未リリース]

### 追加
- 新機能の説明

## [1.0.0] - 2025-01-15

### 追加
- 初回リリース

[未リリース]: https://github.com/owner/repo/compare/v1.0.0...HEAD
[1.0.0]: https://github.com/owner/repo/releases/tag/v1.0.0
```

### カテゴリ

| カテゴリ | 英語 | 説明 |
|---------|------|------|
| 追加 | Added | 新機能 |
| 変更 | Changed | 既存機能の変更 |
| 非推奨 | Deprecated | 将来削除予定の機能 |
| 削除 | Removed | 削除された機能 |
| 修正 | Fixed | バグ修正 |
| セキュリティ | Security | セキュリティ修正 |

## リリースブランチ戦略

```
main (production)
  ├── release/v1.0.0 (リリース準備)
  ├── release/v1.1.0 (次のリリース)
  └── feature/* (開発)
```

## リリースフロー

### 重要: PR の自動作成

**リリース PR は GitHub Actions が自動作成します。** 手動で作成しないこと。

### ワークフロー

1. **リリースブランチ作成**: main から `release/vX.Y.Z`
2. **開発**: フィーチャーをリリースブランチにマージ
3. **CHANGELOG 更新**: 「未リリース」セクションにエントリ追加
4. **リリース準備**: release-prepare スキルを使用
   - CHANGELOG 更新（未リリース → [X.Y.Z]）
   - コミット
   - **リモートに自動プッシュ**
5. **PR 自動作成**: GitHub Actions が PR を作成
6. **PR マージ**: 自動リリースがトリガー

### PR マージ後（自動）

1. タグ作成（vX.Y.Z）
2. CHANGELOG 付き GitHub Release
3. 次のリリースブランチ作成
4. 次のリリース用ドラフト PR

## トラブルシューティング

### CHANGELOG バリデーションエラー

**エラー**: `CHANGELOG.md does not contain version [X.Y.Z] section`

**対処**:
1. 形式を確認: `## [X.Y.Z] - YYYY-MM-DD`
2. バージョンがブランチ名と一致することを確認
3. 再コミット・再プッシュ

### タグが既に存在する

```bash
# リモートタグを削除
git push origin :refs/tags/vX.Y.Z
# ローカルタグを削除
git tag -d vX.Y.Z
# GitHub Release を削除（Web から）
```