005 / AUTOMATION / IGUANA LAB ORIGINAL
Data Diff Regression Verifier
変更前後の JSON / CSV を鍵で突き合わせ、保護・許容・想定内・疑わしい差に分けます。既定では値を出しません。
何をするものか
コード・SQL・API・マイグレーション・ETL を変えたあとに、出てくるデータが前と変わっていないかを確かめる道具です。比べるのはソースではなく出力です。
前提がひとつあります。差があること自体は回帰ではありません。 何を守るべき契約と見なすかは、渡した baseline と、利用者が承認した規則で決まります。この Skill は、その規則の外にある差を勝手に「問題なし」にしません。
使い方の流れ
- baseline と current のファイルを用意する。取得のために SQL を叩いたり本番から吐き出したりはしません。 無ければ、無害化したローカルの出力を求めます
- レコードの鍵、無視する項目、許容値を設定に書く。ここを推測で埋めません
- 比較する
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 を使わない
- 本番データを書き換えない。レポートを公開しない
