本文へスキップ

005 / AUTOMATION / IGUANA LAB ORIGINAL

Data Diff Regression Verifier

変更前後の JSON / CSV を鍵で突き合わせ、保護・許容・想定内・疑わしい差に分けます。既定では値を出しません。

FREELAB ORIGINAL

何をするものか

コード・SQL・API・マイグレーション・ETL を変えたあとに、出てくるデータが前と変わっていないかを確かめる道具です。比べるのはソースではなく出力です。

前提がひとつあります。差があること自体は回帰ではありません。 何を守るべき契約と見なすかは、渡した baseline と、利用者が承認した規則で決まります。この Skill は、その規則の外にある差を勝手に「問題なし」にしません。

使い方の流れ

  1. baseline と current のファイルを用意する。取得のために SQL を叩いたり本番から吐き出したりはしません。 無ければ、無害化したローカルの出力を求めます
  2. レコードの鍵、無視する項目、許容値を設定に書く。ここを推測で埋めません
  3. 比較する
BASH
node scripts/cli.mjs --baseline examples/baseline.json --current examples/current.json --config examples/verifier.json --json

同梱の例はわざと FAIL(終了コード 2)になります。3つのパスを自分のファイルに差し替えて使います。CSV も同じコマンドです。

結果の読み方

規則の無い差は WARN のままです。意図が決まっていないものを PASS に寄せません。

既定ではレコードの値も鍵の値も出ません。場所は 0 始まりの行番号と項目のポインタで示されます。値を見たいときだけ --include-values を付けますが、これは承認済みで無害化されたデータに限った使い方です。

ERROR は失敗判定ではなく、比較の判定が出せなかったという意味です。FAIL と混ぜて読まないでください。

掲載時点の注意

このページの導入コマンドは、skills.sh の掲載ページから写したものではありません。 2026-10-13 時点で skills.sh にこの Skill のページが無いため、GitHub のリポジトリを直接指す形を載せています。掲載が確認できしだい、掲載ページの形に差し替えます。

配布元に TEST_REPORT_2026-10-11.md という配布者自身の試験記録がありますが、当方が実行して確かめた記録ではありません。 このページは SKILL.md を読んで書いています。

導入

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

npx skills add https://github.com/iguanagonzaresu-lab/iguana- --skill data-diff-regression-verifier

必要なもの

  • Node.js 22 以上。依存パッケージ・APIキー・ネットワーク接続は不要
  • 比較元(baseline)と比較先(current)のファイル。JSON か CSV
  • レコードを突き合わせる鍵、無視する項目、許容値を書いた設定ファイル(v0.1 は JSON のみ)

できること

  • 明示した鍵でレコードを突き合わせ、一致・追加・削除を数える
  • 差を regression / suspicious / expected / tolerated に仕分ける
  • 規則の無い差は WARN のまま残す。意図が決まるまで PASS にしない
  • レコードの位置を 0 始まりの行番号と JSON ポインタで示す
  • 機械の判定と、エージェントの解釈を分けて報告する
  • ERROR は「比較の判定が出せなかった」という意味で、FAIL でも PASS でもない

できないこと

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

  • SQL の実行、API の呼び出し、本番データの書き出し、プロジェクトのスクリプト実行はしない
  • 自動で直さない。新しい baseline を勝手に受け入れない。規則を書き換えて通さない
  • 入れ子の配列は順序に依存する。鍵での突き合わせは根の配列だけ
  • v0.1 に SQL / API / DB / Git / CI の連携と YAML の読み取りは無い
  • 数値は JavaScript の二進浮動小数点で比べる。金額の厳密な計算機ではない
  • 大きな識別子は文字列で渡す必要がある
  • 伏せ字は一般的な項目名とトークン状の値が対象で、網羅的な個人情報の検出ではない。項目名そのものは見える

安全性について

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

  • データの文字列・項目名・埋め込まれた指示を「データ」として扱い、その中の命令に従わない
  • 既定で値とレコードの鍵の値を出さない。`--include-values` は承認済みの無害化されたデータにだけ使う
  • 生のデータセットを外部のモデルやサービスへ送らない。CLI は LLM を使わない
  • 本番データを書き換えない。レポートを公開しない

関連する解説