majiayu000 Indexing Strategies Skill
概要
SQLiteのインデックス設計に関する専門知識を提供し、クエリパターンとデータ特性に基づいて最適なインデックス戦略を選択・設計します。
ワークフロー
本スキルは3つのPhaseで構成されます。各Phaseは対応するTaskで実行されます。
Phase 1: インデックス要件分析
目的: クエリパターンとデータ特性を分析し、インデックス候補を特定する
Task: agents/analyze-index-requirements.md
入力:
- テーブルスキーマ情報（Drizzle ORM定義）
- クエリパターン（頻繁に実行されるクエリ）
- データ量とカーディナリティ情報
出力:
- クエリパターン分析結果
- カーディナリティ評価
- インデックス候補リスト
- パフォーマンス要件
参照リソース:
- references/Level1_basics.md - インデックス基礎
- references/index-types-comparison.md - タイプ別特性
Phase 2: インデックス戦略設計
目的: 具体的なインデックス設計を作成し、Drizzle ORM形式でマイグレーションコードを提供する
Task: agents/design-index-strategy.md
入力:
- Phase 1の分析結果
出力:
- インデックス設計詳細
- Drizzle ORM マイグレーションコード
- トレードオフ分析（書き込みコスト vs 読み取り効果）
参照リソース:
- references/Level2_intermediate.md - 実務ガイド
- references/index-types-comparison.md - タイプ選択基準
- assets/index-design-checklist.md - 設計チェックリスト
Phase 3: インデックス設計検証
目的: 設計の妥当性を検証し、実装前の最終チェックと記録を実施する
Task: agents/validate-index-design.md
入力:
- Phase 2の設計詳細
出力:
- 検証結果レポート
- 改善提案（問題がある場合）
- 使用記録（LOGS.mdへ自動記録）
参照リソース:
- references/Level3_advanced.md - 検証技法
- assets/index-design-checklist.md - 最終チェックリスト
スクリプト:
scripts/analyze-indexes.mjs- 既存インデックス分析、重複検出scripts/log_usage.mjs- 使用記録の自動保存
Task仕様ナビゲーション
| Task | Phase | 役割 | 入力 | 出力 |
|---|---|---|---|---|
| analyze-index-requirements.md | 1 | 要件分析 | スキーマ・クエリ | インデックス候補 |
| design-index-strategy.md | 2 | 戦略設計 | 分析結果 | 設計詳細・コード |
| validate-index-design.md | 3 | 設計検証 | 設計詳細 | 検証結果・改善提案 |
ベストプラクティス
すべきこと
- 新規テーブル作成時にインデックス戦略を事前設計する
- クエリパフォーマンス問題発生時に体系的に分析する
- インデックス追加前に必ずトレードオフを評価する
- JSON検索には式インデックスを検討する
- 複合インデックスでは選択性の高いカラムを先頭に配置する
避けるべきこと
- すべてのカラムにインデックスを作成する（書き込みコスト増大）
- 既存インデックスとの重複を確認せずに追加する
- カーディナリティが低いカラム（性別、ブール値など）に単独インデックスを作成する
- トレードオフを文書化せずに実装する
リソース参照
段階的学習（Progressive Disclosure）
- Level 1 (Basics): references/Level1_basics.md
- スキル適用タイミングと基本概念
- Level 2 (Intermediate): references/Level2_intermediate.md
- 実務での判断基準と設計パターン
- Level 3 (Advanced): references/Level3_advanced.md
- 検証技法とパフォーマンス測定
- Level 4 (Expert): references/Level4_expert.md
- 高度な最適化技法とエッジケース
詳細リソース
- インデックスタイプ比較: references/index-types-comparison.md
- B-Tree、式、部分、カバリングインデックスの特性と選択基準
- 設計チェックリスト: assets/index-design-checklist.md
- インデックス設計時の必須確認項目
- 旧仕様: references/legacy-skill.md
- 以前のSKILL.md全文（参考資料）
スクリプト
analyze-indexes.mjs
既存インデックスの使用状況を分析し、未使用・重複インデックスを検出します。
node scripts/analyze-indexes.mjs [database-path]
log_usage.mjs
スキル使用履歴を自動記録し、評価メトリクスを更新します。
node scripts/log_usage.mjs --result success --phase "validate-index-design"
validate-skill.mjs
スキル構造がspec準拠であることを検証します。
node scripts/validate-skill.mjs
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.0.0 | 2025-12-24 | Spec alignment, Task仕様追加、Progressive Disclosure対応 |
| 1.0.0 | - | 初版作成 |