mcpField
C
configure-release-please

configure-release-please

github.com/laurigatesクラウド・DevOps5956 回インストール1 日前に更新
リポジトリ

configure-release-please について

release-please のワークフロー、設定、バージョンマニフェストを監査・設定するエージェントスキルです。プロジェクトのファイルからリリースタイプを判定し、準拠状況の確認と自動修正を行えます。

主な機能

  1. 01release-please の設定準拠を監査
  2. 02プロジェクトファイルからリリースタイプを判定
  3. 03ワークフロー、トークン、権限を確認
  4. 04リリース設定ファイルを作成・更新
  5. 05プロジェクト標準の追跡情報を更新

活用シーン

  1. 01新規プロジェクトに release-please を設定
  2. 02既存のリリースワークフローと設定を監査
  3. 03monorepo のリリース設定にパッケージを追加
  4. 04古いアクションバージョンやトークン設定を修正

インストール

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

$npx skills add https://github.com/laurigates/claude-plugins --skill configure-release-please

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

同梱ファイルREFERENCE.md

詳細

/configure:release-please

release-please がプロジェクト標準に準拠しているかを確認し、設定します。

このスキルを使う場合

次の場合にこのスキルを使います…次の場合は別の方法を使います…
新規プロジェクトで release-please を一から設定するCHANGELOG.md やバージョンフィールドを手動で編集する — 代わりに conventional commits を使います
既存の release-please 設定が準拠しているか監査する単発のリリースを作成する — 代わりに gh release create を直接使います
release-please-action を最新バージョンにアップグレードするリリース PR の失敗をデバッグする — GitHub Actions のログを直接確認します
ワークフローで正しいトークン(MY_RELEASE_PLEASE_TOKEN)が使われていることを確認するnpm/PyPI の公開を管理する — 公開用のワークフローを別途設定します
モノレポの release-please 設定に新しいパッケージを追加するconventional commit メッセージを書く — /git:commit スキルを使います

コンテキスト

  • ワークフローファイル: !find .github/workflows -maxdepth 1 -name 'release-please*'
  • 設定ファイル: !find . -maxdepth 1 -name \'release-please-config.json\'
  • マニフェストファイル: !find . -maxdepth 1 -name \'.release-please-manifest.json\'
  • パッケージファイル: !find . -maxdepth 1 \( -name 'package.json' -o -name 'pyproject.toml' -o -name 'Cargo.toml' -o -name 'go.mod' \)
  • ワークフローディレクトリ: !find . -maxdepth 1 -type d -name \'.github/workflows\'

参照するスキル: release-please-standards、release-please-protection

パラメーター

コマンド引数から解析します。

  • --check-only:修正を提案せずにステータスを報告します
  • --fix:すべての修正を自動的に適用します

実行

この release-please 設定チェックを実行します。

ステップ 1:最新のアクションバージョンを取得する

現在の release-please-action バージョンを動的に取得するには、次のコマンドを実行します。

curl -s https://api.github.com/repos/googleapis/release-please-action/releases/latest | jq -r '.tag_name'

参考資料:

ステップ 2:プロジェクトの種類を判定する

検出されたパッケージファイルから、適切な release-type を判定します。

  • node:package.json がある(フロントエンド/バックエンドアプリのデフォルト)
  • python:package.json がなく、pyproject.toml がある
  • helm:Helm チャートを含むインフラストラクチャ
  • simple:汎用プロジェクト
ステップ 3:準拠状況を分析する

ワークファイルのチェック:

  • アクションバージョン:googleapis/release-please-action@v4
  • トークン:MY_RELEASE_PLEASE_TOKEN シークレットを使用している(GITHUB_TOKEN ではない)
  • トリガー:main ブランチへのプッシュ
  • 権限:contents: write、pull-requests: write

設定ファイルのチェック:

  • プロジェクトに適した release-type
  • changelog-sections に feat と fix が含まれている
  • 適切なプラグイン(Node プロジェクトの node-workspace など)

マニフェストファイルのチェック:

  • 有効な JSON 構造
  • パッケージパスが設定と一致している
ステップ 4:準拠レポートを生成する

ファイルの状態と設定チェックの結果を示す、書式付きの準拠レポートを出力します。--check-only が設定されている場合は、ここで終了します。

レポートの形式については、REFERENCE.md を参照してください。

ステップ 5:設定を適用する(--fix が指定された場合、またはユーザーが確認した場合)
  1. ワークフローがない場合:標準テンプレートから作成します
  2. 設定がない場合:検出された release-type を使って作成します
  3. マニフェストがない場合:初期バージョン 0.0.0 を設定して作成します
  4. アクションが古い場合:v4 に更新します
  5. トークンが誤っている場合:MY_RELEASE_PLEASE_TOKEN を使うように更新します

標準テンプレートについては、REFERENCE.md を参照してください。

ステップ 6:標準準拠の追跡情報を更新する

.project-standards.yaml を更新します。

components:
  release-please: "2025.1"

エージェント向け最適化

コンテキストコマンド
コンプライアンスをすばやく確認/configure:release-please --check-only
すべての問題を自動修正/configure:release-please --fix
最新のアクションバージョンを確認curl -s https://api.github.com/repos/googleapis/release-please-action/releases/latest | jq -r '.tag_name'
設定 JSON を検証jq . release-please-config.json
マニフェスト JSON を検証jq . .release-please-manifest.json
ワークフローの存在を確認find .github/workflows -name 'release-please*'

重要な注意事項

  • リポジトリの設定に MY_RELEASE_PLEASE_TOKEN シークレットが必要です
  • CHANGELOG.md は release-please によって管理されるため、手動で編集しないでください
  • package.json/pyproject.toml のバージョンフィールドは自動的に管理されます
  • コミットの検証には conventional-pre-commit フックを使用します

関連項目

  • /configure:pre-commit - conventional commits フックを確実に設定します
  • /configure:all - すべてのコンプライアンスチェックを実行します
  • release-please-protection スキル - 保護対象ファイルのルール

コメント