mcpField
R
release-orchestrator

release-orchestrator

github.com/borgheiクラウド・DevOps1.0k80 回インストール5 日前に更新
リポジトリ

release-orchestrator について

release-orchestratorは、conventional commitsを使うgitプロジェクト向けのリリース管理スキルです。リリース準備の検証、変更履歴の生成、セマンティックバージョンの判定を行い、GO、CONDITIONAL、NO-GOでリリースを判定します。

主な機能

  1. 01リリース前の7項目検証
  2. 02セマンティックバージョンの判定
  3. 03コミットから変更履歴を生成
  4. 04重み付けによるデプロイ準備度評価
  5. 05リリースパイプラインとCI/CDゲート

活用シーン

  1. 01リリース前のリポジトリ確認
  2. 02変更履歴とバージョン更新の準備
  3. 03検証失敗時のリリース停止
  4. 04CI/CDへのリリースゲート追加

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/borghei/claude-skills --skill release-orchestrator

インストール後、Claude Code で/release-orchestratorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

assets/
release_checklist_template.md
sample_release_data.json
references/
ci_cd_best_practices.md
release_engineering_guide.md
release-workflows-and-operations.md
rollback_strategies.md
scripts/
changelog_generator.py
preflight_checker.py
release_readiness_scorer.py
version_bumper.py

詳細

リリースオーケストレーター

エージェントはリリース前の検証を実行し、Conventional Commits から変更履歴を生成して、セマンティックバージョンを自動で更新し、GO／CONDITIONAL／NO-GO の判定によってデプロイ準備状況を評価します。

主な機能

  • リリース前の検証 — 7 つの自動チェック：ブランチの同期、マージコンフリクト、作業ツリーの変更、シークレットのスキャン（AWS/GCP/GitHub/Stripe/JWT）、gitignore の適用範囲、Conventional Commits、依存関係ロックの整合性。
  • バージョン管理 — package.json、pyproject.toml、Cargo.toml などを対象に、コミット履歴から semver の更新幅（PATCH/MINOR/MAJOR）を自動検出します。プレリリースタグ（--pre alpha|beta|rc）にも対応します。
  • 変更履歴の生成 — Keep a Changelog 形式の Markdown を種別（Added/Changed/Fixed/Security/Breaking）ごとにまとめ、ハッシュと @author の表記を含めて生成します。
  • デプロイ準備状況の評価 — 7 つのカテゴリ（テスト、コード品質、ドキュメント、セキュリティ、破壊的変更、依存関係、ロールバック）を加重スコアで評価し、GO（80 以上）／CONDITIONAL（60～79）／NO-GO（60 未満）で判定します。単一カテゴリのスコアが 40 未満の場合はブロッカーとします。
  • エンドツーエンドのパイプライン — すべてのツールを非対話形式で連携します。リリース前の検証失敗、テスト失敗、または NO-GO の場合は処理をブロックします。CI/CD の手順と pre-push git フックも用意されています。
  • リリース種別 — hotfix、patch、minor、major、プレリリースの各フローに対応し、ブランチパターンと更新ルールを適用します。

使用する場面

  • リリース前の検証を実行する場合や、シークレットのスキャンと GO／NO-GO チェックによってリリースをゲートする場合。
  • タグ付けの前に、Conventional Commits から変更履歴を生成する場合。
  • コミット履歴からセマンティックバージョンを自動で更新する場合。
  • テスト、品質、セキュリティ、ロールバックの観点からデプロイ準備状況を評価する場合。
  • リリース検証を CI/CD パイプラインや pre-push フックに組み込む場合。

事前に確認すること

リリースをオーケストレーションする前に、次の入力を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。

  • ベースブランチと ref の範囲 — HEAD と比較する対象（リリース前のブランチ同期チェックと、変更履歴の --from／--to に影響します）
  • リリース種別 — hotfix／patch／minor／major／プレリリース（ブランチパターンと更新ルールを決定します）
  • ゲートの厳格さ — CONDITIONAL（60～79）でもブロックするか、NO-GO（60 未満）の場合のみブロックするか（パイプラインを停止するかどうかを決定します）

停止ルール：出力に最も大きく影響する 2～3 項目だけ質問してください。ユーザーが「とりあえずドラフトを作って」と言った場合は、そのまま進め、成果物の冒頭に前提を列挙してください。

ツール

ツール用途コマンド
preflight_checker.pyリリース前の 7 つのチェック（同期、コンフリクト、シークレット、コミット、依存関係）を実行しますpython scripts/preflight_checker.py --repo . --base main --json
changelog_generator.pyref の範囲から Keep a Changelog 形式の Markdown を生成しますpython scripts/changelog_generator.py --repo . --from v1.2.0 --to HEAD --output CHANGELOG.md
version_bumper.pyコミットから次の semver を自動検出し、バージョンファイルを書き込みますpython scripts/version_bumper.py --repo . --dry-run --json
release_readiness_scorer.py準備状況を 0～100 で評価し、GO／CONDITIONAL／NO-GO で判定しますpython scripts/release_readiness_scorer.py --input release_data.json --json

すべてのツールは、機械処理向けの出力に --json をサポートしています。終了コード 0 = 成功、1 = 失敗（CI で使用できます）。

参考資料

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

  • references/release-workflows-and-operations.md — クイックスタートコマンド、3 つのコアワークフロー（リリース前チェック、バージョン／変更履歴、リリース準備状況）とそのチェックポイント表、エンドツーエンドのパイプラインスクリプト、リリースタイプのマトリックス、CI/CD 統合 YAML、アンチパターン、トラブルシューティング表が記載されています。ワークフローを実行または連結する際に読んでください。
  • references/release_engineering_guide.md — リリース戦略（ローリング、ブルーグリーン、カナリア）とリリースエンジニアリングの実践方法が記載されています。デプロイ戦略を選ぶ際に読んでください。
  • references/rollback_strategies.md — データベース移行のロールバック、移行を可逆にするルール、ロールバック手順が記載されています。リリースのロールバック部分を計画する際に読んでください。
  • references/ci_cd_best_practices.md — パイプライン設計パターン（ステージゲート、ファンアウト／ファンイン）と CI/CD のベストプラクティスが記載されています。パイプライン周辺を設計する際に読んでください。

対象範囲と制限事項

このスキルの対象： git と conventional-commits を採用するプロジェクトにおける、リリース前チェック、セマンティックバージョニングによるバージョン更新、変更履歴の生成、デプロイ準備状況のスコアリング、GO／NO-GO 判定によるリリースのゲート制御です。

このスキルの対象外： 実際のデプロイ／オーケストレーションの実行（senior-devops ／ devops-workflow-engineer が担当）、テストの作成（senior-qa が担当）、シークレットのパターンマッチングを超える詳細なセキュリティスキャン（senior-secops が担当）です。

統合ポイント

スキル統合
senior-devopsパイプラインの各ステージで、リリース前チェックと準備状況の JSON をゲートとして使用します
senior-qaテスト結果を「テスト」カテゴリ（25% の重み）に反映します
senior-secopsシークレットスキャンと CVE の件数を「セキュリティ」カテゴリ（15%）に反映します
code-reviewerコード品質のメトリクスを「コード品質」カテゴリ（20%）に反映します
devops-workflow-engineerワークフロー YAML から、パイプラインのステップとしてツールを呼び出します

コメント

Markdown 対応