configure-release-please について
release-please のワークフロー、設定、バージョンマニフェストを監査・設定するエージェントスキルです。プロジェクトのファイルからリリースタイプを判定し、準拠状況の確認と自動修正を行えます。
主な機能
- 01release-please の設定準拠を監査
- 02プロジェクトファイルからリリースタイプを判定
- 03ワークフロー、トークン、権限を確認
- 04リリース設定ファイルを作成・更新
- 05プロジェクト標準の追跡情報を更新
活用シーン
- 01新規プロジェクトに release-please を設定
- 02既存のリリースワークフローと設定を監査
- 03monorepo のリリース設定にパッケージを追加
- 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 が指定された場合、またはユーザーが確認した場合)
- ワークフローがない場合:標準テンプレートから作成します
- 設定がない場合:検出された release-type を使って作成します
- マニフェストがない場合:初期バージョン
0.0.0を設定して作成します - アクションが古い場合:v4 に更新します
- トークンが誤っている場合: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スキル - 保護対象ファイルのルール
コメント
Markdown 対応