mcpField
C
code-change-verification

code-change-verification

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

code-change-verification について

code-change-verificationは、ランタイム、テスト、ビルド設定の変更を完了とする前に、一連の検証を求めるリポジトリ向けスキルです。ShellとPowerShellの実行スクリプトを備え、失敗を修正して再検証する手順を定めています。

主な機能

  1. 01依存関係のインストールとビルド確認
  2. 02再帰的なビルド確認と宣言チェック
  3. 03Lint、テスト、変更ファイルのフォーマット確認
  4. 04ShellとPowerShellの実行スクリプト
  5. 05失敗時に停止する検証フロー

活用シーン

  1. 01ランタイムコード変更の検証
  2. 02テストやビルド設定変更の確認
  3. 03完了前のリポジトリ最終検証

インストール

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

$npx skills add https://github.com/openai/openai-agents-js --skill code-change-verification

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

同梱ファイル

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

agents/
openai.yaml
scripts/
run.mjs
run.ps1
run.sh

詳細

コード変更の検証

概要

依存関係のインストール、ビルド、リント、型チェック（生成された宣言を含む）、テストがすべて成功してから、作業を完了としてマークしてください。ランタイムコード、テスト、ビルド／テスト設定に変更を加えた場合は、このスキルを使用してください。これはレビュー後の最終ゲートです。$implementation-final-review が適用される場合は、安定したタスク差分に対してクリーンレビューの条件が満たされるまで、広範なスタックを実行しないでください。

クイックスタート

  1. このスキルを ./.agents/skills/code-change-verification に配置すると、リポジトリで自動的に読み込まれます。
  2. ユーザーが選択したチェックアウトでスキルを実行し、ワークツリーやブランチを変更しないでください。
  3. macOS/Linux 上の Codex：/usr/bin/env -u OPENAI_API_KEY bash .agents/skills/code-change-verification/scripts/run.sh。
  4. その他の macOS/Linux 環境：bash .agents/skills/code-change-verification/scripts/run.sh。
  5. Windows：powershell -ExecutionPolicy Bypass -File .agents/skills/code-change-verification/scripts/run.ps1。
  6. コマンドが失敗した場合は、問題を修正してスクリプトを再実行し、失敗した出力を報告してください。
  7. すべてのコマンドが問題なく成功した場合にのみ、完了を確認してください。

開始条件とホストの処理能力

  • レビューを繰り返している間は、対象を絞ったテストと、変更された型境界で必要となる場合に限った狭い範囲の静的チェックのみを使用してください。レビューがクリーンになるまで、リポジトリ全体の pnpm -r build-check と、この完全なスタックの残りの手順は保留してください。
  • 完全なスタックを開始する直前に、読み取り専用のタスクまたはプロセス情報を使い、同じホスト上ですでに別のリポジトリ全体のテスト、型チェック、ビルド、サンプル実行、または統合コマンドが実行中かどうかを確認してください。
  • 具体的な競合が確認できた場合は、レビュー、修正、証拠の準備、対象を絞ったチェックなど、負荷の高くない作業を続け、その後で再確認してください。リポジトリロック、ホスト全体のミューテックス、センチネルファイルを作成したり、これらの完了を待ったりしないでください。
  • レビューがクリーンで、差分が安定し、観測可能なホストの処理能力が確保されている場合は、自動的に開始してください。ユーザーからの finalize メッセージを要求しないでください。ホストのテレメトリーを利用できない場合、処理能力を測定できないことだけを理由に開始を妨げないでください。

Codex の実行ポリシー

リポジトリの検証とすべての子プロセスは、通常の Codex ワークスペースサンドボックス内で実行してください。検証のためにサンドボックス権限の昇格を要求してはならず、失敗後にホストへのアクセス範囲を広げて再試行してはなりません。

macOS/Linux では、リポジトリ管理下のラッパーを起動する前に継承された OPENAI_API_KEY を削除するため、クイックスタートに記載された Codex のコマンドをそのまま使用してください。ワークスペースサンドボックス内で失敗を調査し、サンドボックスでは実施できないカバレッジがあれば、サンドボックスの境界を緩めずに報告してください。

手動ワークフロー

  • リポジトリのルートから、次のフェーズを順に実行してください：pnpm i --frozen-lockfile、pnpm build、続いて pnpm -r build-check、pnpm -r -F "@openai/*" dist:check、pnpm lint、pnpm test、pnpm format:check:changed。
  • スキルでは最終検証フェーズを並列実行できますが、上記のすべての手順を成功させる必要があります。
  • 手順を省略しないでください。いずれかの手順が失敗した場合は、直ちに停止して問題を修正してください。
  • 修正を適用した後は、同じゲートとカバレッジでコマンドが実行されるよう、スタック全体を再実行してください。
  • インストールでは、意図的に CI 設定やプロンプト確認の設定を強制しません。pnpm が互換性のない node_modules を報告した場合は、依存関係を黙って再作成せず、停止して設定の不一致を調査してください。

リソース

scripts/run.sh
  • 宣言チェックを含む検証シーケンス全体を、フェイルファスト方式で実行します。
  • pnpm i --frozen-lockfile と pnpm build をゲートとして維持し、その後、ルートの verify:* スクリプトを pnpm で並列実行します。
  • コマンドが常に想定されるフェイルファスト動作でリポジトリのルートから実行されるよう、このエントリーポイントを優先してください。
scripts/run.ps1
  • Windows 向けのラッパーです。フェイルファストの動作で、同じ検証手順を実行します。
  • 環境によって必要な場合は、実行ポリシーを回避して PowerShell から使用してください。

コメント

Markdown 対応