shuffle-json-data は何をしますか？
JSONデータ内の繰り返しオブジェクトを安全にシャッフルし、シャッフル前にスキーマの一貫性を検証します。
このスキルは、以下のことを行います。
- JSONデータ内のオブジェクト配列を特定します。
- すべてのオブジェクトが同一のスキーマ（キー、値の型）を持っているか検証します。
- 検証が成功した場合、オブジェクトの順序をランダムに並べ替えます。
- シャッフルされた結果のJSONデータを出力します。
使用例
# ファイルをシャッフルする
shuffle-json-data input.json > output.json
# 標準入力からデータを受け取り、シャッフルする
cat data.json | shuffle-json-data -
スキーマ検証
shuffle-json-data は、シャッフルを実行する前にすべてのオブジェクトが以下の点で同一であることを確認します。
- キーのセット: すべてのオブジェクトが同じキーを持っていること。
- 値の型: 対応するキーの値がすべて同じデータ型（文字列、数値、真偽値、配列、オブジェクト、null）であること。
検証に失敗した場合、エラーメッセージが表示され、シャッフルは実行されません。
環境変数
SHUFFLE_SEED: シャッフルのための乱数シードを設定します。同一のシード値を使用することで、再現可能なシャッフル結果を得られます。
注意事項
- このスキルは、JSONオブジェクトの配列を想定しています。トップレベルがオブジェクトやプリミティブ値の場合、シャッフルは実行されません。
- シャッフルは配列内のオブジェクトのみを対象とします。配列内にオブジェクト以外の値が含まれている場合、それらはそのまま保持されます。
- スキーマの検証は、最初のオブジェクトのスキーマを基準として行われます。
プラットフォーム
このスキルは、AIエージェント（例：Claude Code, Cursor, Codex）から利用できるように設計されています。