mcpField
C
changeset-validation

changeset-validation

github.com/openaiテスト・品質4.0k128 回インストール1 週間前に更新
リポジトリ

changeset-validation について

changeset-validation は、changeset がパッケージの変更とリポジトリのルールを反映しているか検証するスキルです。ローカルの Codex レビューと GitHub Actions で共通のプロンプトを使い、JSON 形式の判定を出します。

主な機能

  1. 01検証プロンプトの生成
  2. 02変更とバージョン種別の照合
  3. 03JSON 判定の出力
  4. 04ローカルと CI のワークフロー対応
  5. 05既存 changeset の編集指針

活用シーン

  1. 01提出前の changeset 確認
  2. 02CI での構造化判定の生成
  3. 03主な変更に合わせた既存 changeset の書き換え

インストール

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

$npx skills add https://github.com/openai/openai-agents-js --skill changeset-validation

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

同梱ファイル

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

agents/
openai.yaml
references/
validation-prompt.md
scripts/
changeset-assign-milestone.mjs
changeset-prompt.mjs
changeset-prompt.test.mjs
changeset-validation-result.mjs
run-fixtures.sh

詳細

Changeset の検証

概要

このスキルは、Changeset がパッケージの変更を正しく反映し、リポジトリのルールに従っているかを検証します。references/validation-prompt.md の共有プロンプトを利用するため、ローカルの Codex レビューと GitHub Actions で同じロジックを使用できます。 差分で実験的機能またはプレビュー専用機能として明示されている機能追加は、既存の動作を変更しない場合、パッチバンプのままでもかまいません。 メジャーバンプが許可されるのは、最初のメジャーリリース後のみです。それまでは、機能レベルの変更にメジャーバンプを使用しないでください。

クイックスタート

ローカル(Codex による実行):

  1. 次を実行します:
    pnpm changeset:validate-prompt
    
  2. 生成されたプロンプトに references/validation-prompt.md のルールを適用します。
  3. ok/errors/warnings/required_bump を含む JSON 判定を返します(文字列は英語のみ)。

CI(Codex Action):

  1. 次を実行します:
    pnpm changeset:validate-prompt -- --ci --output .github/codex/prompts/changeset-validation.generated.md
    
  2. 生成されたプロンプトと JSON スキーマを使用して openai/codex-action を実行し、構造化された判定を取得します。

ワークフロー

  1. pnpm changeset:validate-prompt でプロンプトのコンテキストを生成します。
  2. references/validation-prompt.md のルールを適用して、妥当性を判断します。
  3. 明確な判定と必須バンプ(patch/minor/major/none)を提示します。
  4. Changeset の修正が必要な場合は、修正して検証を再実行します。

ブランチ単位の Changeset ルール(省略しないでください)

  • 現在のブランチの差分に .changeset/*.md ファイルがすでに含まれている場合、それを有効な Changeset として扱います。新しい Changeset ファイルを追加しないでください。
  • 代わりに、既存の Changeset ファイルを更新し、要約を main からの主な変更を反映する内容に書き換えます。増分更新をすべて含めようとしないでください。
  • 要約は1 行にします。必要に応じて行を追加するのではなく、既存の行を書き換えてください。複数の要点を含める必要がある場合は、1 行にまとめてください。

共通の信頼できる情報源

  • プロンプトファイルを検証ルールの唯一の情報源として維持します。
  • スクリプトは軽量に保ち、コンテキストを収集してプロンプトを出力するだけにします。

リソース

  • references/validation-prompt.md

コメント