002 / RELEASE / IGUANA LAB ORIGINAL
Preflight Regression
Gitの差分から影響範囲を選び、静的チェックと承認済みのnpmチェックを走らせて、PASS・WARN・BLOCKで返します。
FREELAB ORIGINAL
何をするものか
変更を「終わりました」と言う前に、その変更に関係するところだけを見てリスクを洗い出す道具です。コードへの意見を網羅的に並べるためのものではありません。
既定の比較は HEAD から現在の作業ツリーまで。コミット済みの変更を見るときは --base <信頼できるローカルのコミット> を渡します。ブランチを推測したり、fetch・stash・reset をして利用者の作業を捨てたりはしません。
使い方の流れ
node <skill-folder>/scripts/run-preflight.mjs --repo <repository> --json承認済みのチェックを走らせるときは、欲しいものを明示的に挙げます。
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 ライフサイクルフックを無効にして実行する
