JSON Optimization

JSON最適化（SQLite）

概要

SQLiteのJSON1拡張を活用した柔軟なデータ構造設計とパフォーマンス最適化に特化したスキル。半構造化データの効率的な格納、式インデックスによる高速検索、Zodスキーマ統合による検証を提供します。

詳細は references/Level1_basics.md と references/Level2_intermediate.md を参照してください。

ワークフロー

Phase 1: 目的と前提の整理

目的: JSON最適化タスクの要件と制約条件を明確にする

Task: agents/analyze-requirements.md

アクション:

1. references/Level1_basics.md でJSON1拡張の基礎を確認
2. ペイロードサイズ、クエリパターン、スキーマの動的性を分析
3. 最適化対象（検索速度 vs. ストレージ）を特定

Phase 2: スキル適用

目的: 公式テンプレートと参考資料を使用して実装を進める

Task: agents/design-json-structure.md

アクション:

1. assets/json-schema-design.md でJSON構造を設計
2. references/json-functions-reference.md でJSON関数を選択
3. 式インデックスとCHECK制約を検討
4. scripts/analyze-json-usage.mjs でリレーショナル分離の判定

Phase 3: 検証と記録

目的: 成果物の検証と実行結果の記録

Task: agents/validate-optimization.md

アクション:

1. scripts/validate-skill.mjs でスキル適用を検証
2. scripts/log_usage.mjs で実行結果を記録
3. references/Level3_advanced.md でパフォーマンス最適化の確認

Task仕様ナビ

ベストプラクティス

すべきこと

• 動的に変化するスキーマ属性の格納時
• ペイロードサイズを削減する必要がある時
• 複数の検索パターンに対応する時
• スキーマ検証を厳密に管理する時
• json_extract() でインデックス対象の列を明確にする
• CHECK制約でJSON構造を検証する
• Level2以上のドキュメントで設計パターンを確認する

避けるべきこと

• スキーマレスだからと検証なしで進める
• 式インデックスなしで大規模JSON検索を実装する
• リレーショナル設計とJSON設計を混在させる
• json_extract() で常に完全なオブジェクトを取得する
• アンチパターンを確認せずに設計を進める
• パフォーマンス測定なしで最適化を判定する

リソース参照

段階的学習（Progressive Disclosure）

リソース詳細

• references/json-functions-reference.md: JSON関数（json_extract, json_type, json_valid）とインデックス活用
• references/legacy-skill.md: 旧スキル実装（参考情報）

コマンドリファレンス

リソース読み取り

# 段階的学習
cat references/Level1_basics.md
cat references/Level2_intermediate.md
cat references/Level3_advanced.md
cat references/Level4_expert.md

# 詳細参考
cat references/json-functions-reference.md
cat references/legacy-skill.md

スクリプト実行

# JSON使用状況の分析とリレーショナル分離推奨
node scripts/analyze-json-usage.mjs --help

# 実行結果の記録
node scripts/log_usage.mjs --result success --phase "Phase 2"

# スキル構造の検証
node scripts/validate-skill.mjs

テンプレート参照

# JSON構造設計（式インデックス/CHECK制約/Zodスキーマ統合）
cat assets/json-schema-design.md

変更履歴