本文へスキップ

002 / RELEASE / IGUANA LAB ORIGINAL

Preflight Regression

Gitの差分から影響範囲を選び、静的チェックと承認済みのnpmチェックを走らせて、PASS・WARN・BLOCKで返します。

FREELAB ORIGINAL

何をするものか

変更を「終わりました」と言う前に、その変更に関係するところだけを見てリスクを洗い出す道具です。コードへの意見を網羅的に並べるためのものではありません。

既定の比較は HEAD から現在の作業ツリーまで。コミット済みの変更を見るときは --base <信頼できるローカルのコミット> を渡します。ブランチを推測したり、fetch・stash・reset をして利用者の作業を捨てたりはしません。

使い方の流れ

BASH
node <skill-folder>/scripts/run-preflight.mjs --repo <repository> --json

承認済みのチェックを走らせるときは、欲しいものを明示的に挙げます。

BASH
node <skill-folder>/scripts/run-preflight.mjs --repo <repository> --run test,build --json

結果の読み方

落ちたチェックは、この時点のスナップショットの BLOCK であって、その差分が原因である証明ではありません。 因果関係を確かめたいなら、別に承認されたワークスペースでベースラインと比較する必要があります。

飛ばしたチェックを PASS に読み替えてはいけません。依存やツールが無い、時間切れ、カバー範囲が不明——これらはすべて WARN です。変更が無いスキャンの結果も「リリースしてよい」ではなく、範囲の確認にすぎません。

導入

配布元の掲載内容と照合したコマンドです。実行すると配布元のリポジトリから取得されます。コピーできたことと、導入できたことは別です。実行後に結果を確かめてください。

npx skills add https://github.com/iguanagonzaresu-lab/-skill- --skill preflight-regression

必要なもの

  • Node.js 22 以上
  • Git と、対象のリポジトリ

できること

  • HEAD から作業ツリーまでの差分(ステージ済みと未追跡の非無視ファイルを含む)を取り、変更されたパスと状態を返す
  • 変更の内容から Deploy / Design / Content のチェックパックを選ぶ
  • 競合マーカー、プレースホルダ、壊れたローカル文書リンク、JSONの妥当性、パスの安全性を静的に調べる
  • 承認された root の npm チェック(test / build / lint / typecheck)だけを実行する
  • PASS / WARN / BLOCK と、Evidence・Risk・Fix・Verify の形で報告する

できないこと

配布元の SKILL.md に明記されている範囲外です。

  • 自動デプロイをしない。リリースの安全を保証しない
  • 見つけた問題を自動で直さない。対象リポジトリと利用者の作業を書き換えない
  • 受け付ける npm チェックは test / build / lint / typecheck の4つだけ。依存のインストールはしない
  • v0.1 のスキャナはマイグレーションの変更に印を付けるだけで、マイグレーションの安全性・データベース・エージェントの自動処理を踏み込んで解析しない
  • ファイル名による分類は目安であり、依存関係のグラフではない
  • 作業ツリーがきれいでも、直前のコミットやPRの内容を説明したことにはならない

安全性について

以下は配布元の記述にある設計方針です。当方で実行して確かめた結果ではありません。導入前にご自身でコードを確認してください。

  • ソースの抜粋、環境変数の値、package のスクリプト、コマンド出力を報告に出さない設計になっている
  • 対象リポジトリのコマンドはファイルの書き込み・秘密情報へのアクセス・通信を行いうるため、実行前に範囲の承認を求める前提になっている
  • npm の pre/post ライフサイクルフックを無効にして実行する

関連する解説