changeset-validation について
changeset-validation は、changeset がパッケージの変更とリポジトリのルールを反映しているか検証するスキルです。ローカルの Codex レビューと GitHub Actions で共通のプロンプトを使い、JSON 形式の判定を出します。
主な機能
- 01検証プロンプトの生成
- 02変更とバージョン種別の照合
- 03JSON 判定の出力
- 04ローカルと CI のワークフロー対応
- 05既存 changeset の編集指針
活用シーン
- 01提出前の changeset 確認
- 02CI での構造化判定の生成
- 03主な変更に合わせた既存 changeset の書き換え
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ openai/ openai-agents-js --skill changeset-validationインストール後、Claude Code で/changeset-validationを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/validation-prompt.mdscripts/changeset-assign-milestone.mjschangeset-prompt.mjschangeset-prompt.test.mjschangeset-validation-result.mjsrun-fixtures.sh詳細
Changeset の検証
概要
このスキルは、Changeset がパッケージの変更を正しく反映し、リポジトリのルールに従っているかを検証します。references/validation-prompt.md の共有プロンプトを利用するため、ローカルの Codex レビューと GitHub Actions で同じロジックを使用できます。
差分で実験的機能またはプレビュー専用機能として明示されている機能追加は、既存の動作を変更しない場合、パッチバンプのままでもかまいません。
メジャーバンプが許可されるのは、最初のメジャーリリース後のみです。それまでは、機能レベルの変更にメジャーバンプを使用しないでください。
クイックスタート
ローカル(Codex による実行):
- 次を実行します:
pnpm changeset:validate-prompt - 生成されたプロンプトに
references/validation-prompt.mdのルールを適用します。 - ok/errors/warnings/required_bump を含む JSON 判定を返します(文字列は英語のみ)。
CI(Codex Action):
- 次を実行します:
pnpm changeset:validate-prompt -- --ci --output .github/codex/prompts/changeset-validation.generated.md - 生成されたプロンプトと JSON スキーマを使用して
openai/codex-actionを実行し、構造化された判定を取得します。
ワークフロー
pnpm changeset:validate-promptでプロンプトのコンテキストを生成します。references/validation-prompt.mdのルールを適用して、妥当性を判断します。- 明確な判定と必須バンプ(patch/minor/major/none)を提示します。
- Changeset の修正が必要な場合は、修正して検証を再実行します。
ブランチ単位の Changeset ルール(省略しないでください)
- 現在のブランチの差分に
.changeset/*.mdファイルがすでに含まれている場合、それを有効な Changeset として扱います。新しい Changeset ファイルを追加しないでください。 - 代わりに、既存の Changeset ファイルを更新し、要約を
mainからの主な変更を反映する内容に書き換えます。増分更新をすべて含めようとしないでください。 - 要約は1 行にします。必要に応じて行を追加するのではなく、既存の行を書き換えてください。複数の要点を含める必要がある場合は、1 行にまとめてください。
共通の信頼できる情報源
- プロンプトファイルを検証ルールの唯一の情報源として維持します。
- スクリプトは軽量に保ち、コンテキストを収集してプロンプトを出力するだけにします。
リソース
references/validation-prompt.md
コメント
Markdown 対応