json-optimization
JSON最適化の専門スキル。シリアライゼーション、ペイロードサイズ削減、スキーマ設計を提供します。Anchors:• 『High Performance Browser Networking』（Ilya Grigorik） / 適用: データ最適化 / 目的: 転送効率向上Trigger:JSON最適化時、ペイロード削減時、APIレスポンス最適化時に使用
When & Why to Use This Skill
This Claude skill specializes in JSON optimization and SQLite JSON1 extension management. It empowers developers to design efficient semi-structured data schemas, minimize API payload sizes, and maximize query performance through advanced techniques like expression indexing and Zod-based schema validation. By following a structured workflow from requirement analysis to implementation, it ensures data transfer efficiency and robust database architecture.
Use Cases
- Optimizing API response times by reducing JSON payload size and improving serialization efficiency.
- Designing high-performance SQLite databases that store semi-structured data using the JSON1 extension without sacrificing search speed.
- Implementing robust data integrity for JSON fields using CHECK constraints and Zod schema integration for dynamic validation.
- Accelerating complex search queries on nested JSON data through the strategic use of expression indexes.
- Analyzing and refactoring legacy relational database schemas into optimized JSON-based structures for increased flexibility.
| name | json-optimization |
|---|---|
| description | | |
| • 『High Performance Browser Networking』（Ilya Grigorik） / 適用 | データ最適化 / 目的: 転送効率向上 |
JSON最適化（SQLite）
概要
SQLiteのJSON1拡張を活用した柔軟なデータ構造設計とパフォーマンス最適化に特化したスキル。半構造化データの効率的な格納、式インデックスによる高速検索、Zodスキーマ統合による検証を提供します。
詳細は references/Level1_basics.md と references/Level2_intermediate.md を参照してください。
ワークフロー
Phase 1: 目的と前提の整理
目的: JSON最適化タスクの要件と制約条件を明確にする
Task: agents/analyze-requirements.md
アクション:
references/Level1_basics.mdでJSON1拡張の基礎を確認- ペイロードサイズ、クエリパターン、スキーマの動的性を分析
- 最適化対象（検索速度 vs. ストレージ）を特定
Phase 2: スキル適用
目的: 公式テンプレートと参考資料を使用して実装を進める
Task: agents/design-json-structure.md
アクション:
assets/json-schema-design.mdでJSON構造を設計references/json-functions-reference.mdでJSON関数を選択- 式インデックスとCHECK制約を検討
scripts/analyze-json-usage.mjsでリレーショナル分離の判定
Phase 3: 検証と記録
目的: 成果物の検証と実行結果の記録
Task: agents/validate-optimization.md
アクション:
scripts/validate-skill.mjsでスキル適用を検証scripts/log_usage.mjsで実行結果を記録references/Level3_advanced.mdでパフォーマンス最適化の確認
Task仕様ナビ
| Task | 対応リソース | スクリプト | 説明 |
|---|---|---|---|
| JSON構造の基本設計 | Level1_basics.md, assets/json-schema-design.md | - | 半構造化データのスキーマ設計 |
| 検索パフォーマンス最適化 | json-functions-reference.md, Level2_intermediate.md | analyze-json-usage.mjs | json_extract, 式インデックス活用 |
| 動的スキーマ検証 | Level3_advanced.md | - | CHECK制約, Zodスキーマ統合 |
| リレーショナル vs. JSON分析 | legacy-skill.md, Level4_expert.md | analyze-json-usage.mjs | データベース設計の選択判定 |
| 実装の検証 | - | validate-skill.mjs | スキル構造とアーティファクト確認 |
ベストプラクティス
すべきこと
- 動的に変化するスキーマ属性の格納時
- ペイロードサイズを削減する必要がある時
- 複数の検索パターンに対応する時
- スキーマ検証を厳密に管理する時
json_extract()でインデックス対象の列を明確にする- CHECK制約でJSON構造を検証する
- Level2以上のドキュメントで設計パターンを確認する
避けるべきこと
- スキーマレスだからと検証なしで進める
- 式インデックスなしで大規模JSON検索を実装する
- リレーショナル設計とJSON設計を混在させる
json_extract()で常に完全なオブジェクトを取得する- アンチパターンを確認せずに設計を進める
- パフォーマンス測定なしで最適化を判定する
リソース参照
段階的学習（Progressive Disclosure）
| レベル | リソース | 対象タスク | 読了目安 |
|---|---|---|---|
| 基礎 | references/Level1_basics.md | JSON1拡張の概要 | 5分 |
| 実務 | references/Level2_intermediate.md | 実装パターン | 15分 |
| 応用 | references/Level3_advanced.md | パフォーマンス最適化 | 20分 |
| 専門 | references/Level4_expert.md | 複雑な設計 | 30分 |
リソース詳細
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
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.0.0 | 2025-12-31 | 18-skills.md仕様への完全準拠。Task仕様ナビ、リソース参照の改善 |
| 1.0.0 | 2025-12-24 | 初版 |