release-manager

リリースマネージャー

このエージェントは、Conventional Commits を解析して構造化された変更履歴を作成し、セマンティックバージョンの更新内容を決定するとともに、チェックリスト、ロールバック手順書、関係者への連絡計画を使ってリリース準備状況を評価し、リリース管理を自動化します。

主な機能

• 変更履歴の生成 — 最後のタグ以降の Conventional Commits を解析し、種類ごとに分類した Keep-a-Changelog 形式の Markdown／JSON を作成します。破壊的変更を強調表示し、課題へのリンクを追加します。
• セマンティックバージョンの更新 — コミットの種類から MAJOR／MINOR／PATCH を決定し、プレリリースのトラック（alpha → beta → rc）に対応します。npm、Python、Rust、Git、Docker 用の更新コマンドを出力します。
• リリース準備状況の評価 — 機能、品質ゲート、承認、スケジュールに基づいてリリース計画を採点し、阻害要因を明らかにします。
• ロールバックと連絡計画 — トリガーと所要時間の見積もりを含むロールバック手順書に加え、送信時刻付きのメッセージテンプレートを含む関係者への連絡計画を作成します。
• ワークフロー — 変更履歴の作成とバージョン更新、準備状況の評価、迅速なホットフィックスリリースに対応し、それぞれに検証チェックポイントを設けています。

使用する場面

• リリースの準備 — 変更履歴を作成し、次のバージョンを決定します。
• リリース候補の検証 — 準備状況を評価し、阻害要因を明らかにします。
• ホットフィックスのリリース — 迅速な修正、プレリリースのバージョン管理、テスト済みのロールバックを行います。
• コミットの運用状況の監査 — Conventional Commits によって明確な変更履歴が作成されていることを確認します。

最初に確認すること

リリースの準備を始める前に、次の情報を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。

• 最後のリリースタグ／コミット範囲 — 変更履歴の対象範囲とバージョン更新の判断基準を定めます
• リリースの種類 — standard / hotfix / pre-release（alpha→beta→rc）（ワークフローとバージョン管理のトラックを選択します）
• 対象エコシステム — npm / Python / Rust / Git / Docker（出力する更新コマンドを決定します）

確認事項のルール：出力内容に最も影響する2～3項目だけを質問してください。ユーザーが「ひとまず下書きを作って」と言った場合は、そのまま進め、成果物の冒頭に前提を記載してください。

ツール

ツール	目的	コマンド
changelog_generator.py	Conventional Commits から Keep-a-Changelog を生成	git log --oneline v1.0.0..HEAD | python changelog_generator.py --version 1.1.0 --format both
version_bumper.py	SemVer の更新内容を決定し、更新コマンドを出力	git log --oneline v1.0.0..HEAD | python version_bumper.py --current-version 1.0.0 --analysis
release_planner.py	リリース準備状況、チェックリスト、ロールバック、連絡計画を評価	python release_planner.py --input release-plan.json --include-checklist --include-rollback

参考資料

タスクに合った参考資料を読み込んでください。このファイルは簡潔に保ち、必要に応じて詳細を参照してください。

• references/workflows-and-tool-reference.md — クイックスタート、チェックポイント付きの3つの主要ワークフロー、バージョン更新のルール、ロールバックのトリガー、アンチパターン、トラブルシューティング表、成功基準、および3つのスクリプトすべての CLI フラグ一覧が記載されています。リリースを実行するときやフラグを確認するときに読んでください。
• references/conventional-commits-guide.md — Conventional Commits の形式、種類、フッターの規則が記載されています、変更履歴やバージョン管理ツールが機能するようにコミットの運用を改善するときに読んでください。
• references/hotfix-procedures.md — 重要度の分類（P0～P3）、ホットフィックスの手順、各ワークフローにおけるベストプラクティスが記載されています。緊急修正をリリースするときに読んでください。
• references/release-workflow-comparison.md — Git Flow、GitHub Flow、トランクベース開発について、構成、ブランチの種類、トレードオフを比較しています。ブランチモデルの選択や調整を行うときに読んでください。

対象範囲と制限事項

このスキルの対象：

• Conventional Commits を解析し、Markdown および JSON 形式の構造化された変更履歴を生成します
• セマンティックバージョニングの更新幅（メジャー／マイナー／パッチ）を、プレリリース（アルファ、ベータ、rc）に対応して判定します
• 機能、品質ゲート、承認、スケジュールを踏まえてリリース準備状況を評価します
• 構造化された入力から、ロールバック手順書、コミュニケーション計画、リリースチェックリストを生成します

このスキルの対象外：

• CI/CD パイプラインの実際の実行やデプロイの自動化（engineering/ci-cd-pipeline-generator を参照）
• デプロイ中のリアルタイム監視、アラート、インシデント対応（engineering/monitoring-alerting-setup を参照）
• コードレビューのプロセスやプルリクエストの管理（engineering/code-review-automation を参照）
• インフラストラクチャのプロビジョニング、コンテナオーケストレーション、環境管理（engineering/infrastructure-as-code を参照）

統合ポイント

スキル	統合内容	データフロー
engineering/ci-cd-pipeline-generator	変更履歴の生成とバージョン更新をパイプラインのステージとして組み込みます	Git ログの出力が changelog_generator.py に渡され、バージョン更新の出力がパイプラインのタグ付けステップに渡されます
engineering/code-review-automation	マージ前に PR のコミットが Conventional Commits の形式に従っていることを検証します	上流でコミットメッセージを検証することで、変更履歴生成への入力が適切な状態になります
engineering/monitoring-alerting-setup	ロールバック手順書に記載された監視しきい値に基づいて、ロールバックのトリガーを定義します	ロールバックのトリガーしきい値（エラー率が 2 倍超、レイテンシが 50% 超）がアラートルールの設定に反映されます
engineering/api-design-reviewer	レビュアーが検出した API の破壊的変更をメジャーバージョンの更新に対応付けます	API レビューの結果が、リリース計画 JSON の breaking_changes 配列に反映されます
engineering/infrastructure-as-code	ロールバック手順書のデプロイ手順で、インフラストラクチャのロールバックコマンドを参照します	ロールバック手順書の command フィールドには、インフラストラクチャ固有のコマンド（kubectl、DNS、ロードバランサー）が含まれます
project-management/release-planning	リリース計画 JSON の構造を、PM のリリース追跡成果物に合わせます	PM の機能リストと承認状況が、release_planner.py の入力形式に直接渡されます