deploy-check

デプロイチェック

ユーザーが別途その操作を許可しない限り、デプロイやプッシュを行わずにリリース準備状況を評価します。事前チェックで確認済みの項目と未確認事項を明らかにできますが、本番環境での安全性を保証することはできません。

ワークフロー

1. リポジトリのルート、ワークスペース、パッケージマネージャー、CI 設定、デプロイ先、リリースブランチ／ベース、および現在のワークツリーの状態を特定します。origin/main が存在すると決めつけないでください。
2. マージベースまたはデプロイ範囲からリリース対象を特定します。コミット済み、ステージ済み、未ステージ、および未追跡のファイルを別々のカテゴリとして含めます。ユーザーの変更を上書きしたり破棄したりしないでください。
3. 可能な範囲で、CI と同じ順序／設定でプロジェクト既存の検証コマンドを実行します。書式設定／リンティング、型チェック、単体／統合テスト、ビルド、および関連するスモークテストを含めます。プロジェクトですでにスクリプトやロックファイルが定義されている場合、宣言されていないチェッカーをダウンロードするために npx を使用しないでください。
4. ステージ済みの内容とリリース差分をスキャンし、認証情報、秘密鍵、トークン、接続文字列、および誤って追跡対象になった環境ファイルがないか確認します。ファイル名の照合だけでは不十分です。見つかったシークレットの値は、偽物、テストモード用、プレースホルダー、またはすでに公開済みに見える場合でも、決して出力しないでください。ファイル名、行番号、変数名、キーの種類を示し、キーのプレフィックスのみ（例：sk_test_…）を表示してください。引用符付きコード、コマンド出力、ビルド成果物の抜粋内にある値も必ずマスキングしてください。
5. 依存関係とロックファイルの変更、ランタイム／エンジンの変更、生成された成果物、および既知のデプロイプラットフォームの制約を確認します。実際に実施していない限り、脆弱性監査を行ったかのように報告しないでください。
6. マイグレーションについて、対象、順序、後方互換性、ロック／書き換えのリスク、データのバックフィル、拡張・縮小の順序、およびロールバック／ロールフォワード計画を確認します。互換性のあるコードがデプロイされる前に、本番環境のマイグレーションを安易に実行するよう指示しないでください。
7. 環境変数の参照とデプロイ設定の差分を確認します。各値をパブリック／サーバーシークレット／ビルド時／実行時に分類し、対象環境を実際に確認した場合に限り、本番環境への設定済みを確認済みとして示します。
8. 該当する場合は、ユーザー向けドキュメント／リリースノート、モニタリング／アラート、フィーチャーフラグ、スケジュール済みジョブ、キュー、およびサードパーティのダッシュボード変更を確認します。

判定

次のいずれかを返します。

• READY：必要なチェックがすべて通過し、既知のブロッカーが残っていません。
• BLOCKED：再現可能なリリースブロッカーがあります。
• NEEDS CONFIRMATION：自動チェックは通過しましたが、外部の状態または許可が必要な手動作業を確認できていません。

出力

リリースのベース／ヘッドと対象範囲、終了ステータス付きのコマンド、ブロッカー、警告、マイグレーションとロールアウトの順序、値を含まない設定／シークレットの確認結果、外部での確認事項、ロールバック／ロールフォワードに関する注意、および判定の根拠を報告します。必ずロールバックのセクションを設け、以前のデプロイに戻す方法と、コードのロールバックでは取り消されない手順（マイグレーション、データ書き込み、送信済みメッセージ）を記載します。型チェックに合格したという理由だけで「プッシュしても安全」と言わないでください。