discover-database

データベーススキルの検出

データベースの設計、最適化、実装に関する包括的なスキルを自動的に利用できます。

このスキルが有効になるタイミング

次の作業を行うと、このスキルが自動的に有効になります。

• SQL データベース（PostgreSQL、MySQL）
• NoSQL データベース（MongoDB、Redis）
• データベースのスキーマ設計とモデリング
• クエリの最適化とパフォーマンスのチューニング
• データベースのマイグレーションとスキーマの進化
• コネクションプーリングの設定
• ORM の使用方法とパターン
• データベースの選択とアーキテクチャに関する判断
• キャッシュ
• キャッシュ
• Redis
• CDN
• HTTP キャッシュ
• キャッシュ無効化
• パフォーマンス
• Service Workers

利用可能なスキル

クイックリファレンス

Database カテゴリには、2 つのサブカテゴリにわたって 19 個のスキルがあります。

Database（12 個のスキル）：

1. postgres-schema-design - スキーマ設計、リレーションシップ、データ型、正規化
2. postgres-query-optimization - EXPLAIN プラン、インデックス、低速クエリのデバッグ
3. postgres-migrations - スキーマ変更、ダウンタイムゼロ、ロールバック戦略
4. mongodb-document-design - ドキュメントモデリング、埋め込みと参照の使い分け
5. redis-data-structures - キャッシュ、セッション、レート制限、リーダーボード
6. database-connection-pooling - プールの設定、枯渇のデバッグ
7. orm-patterns - ORM のベストプラクティス、N+1 の防止、先行読み込み
8. database-selection - データベースの選択、SQL と NoSQL の判断

さらに 4 個のスキルについては、../database/INDEX.md を参照してください。

Caching（7 個のスキル）： ../caching/INDEX.md を参照してください。

カテゴリの詳細をすべて読み込む

Read ../database/INDEX.md Read ../caching/INDEX.md

一般的なワークフロー

新しいデータベースプロジェクト

順序：選択 → スキーマ設計 → コネクションプーリング

Read ../database/database-selection.md # データベースを選択 Read ../database/postgres-schema-design.md # または mongodb-document-design.md Read ../database/database-connection-pooling.md

クエリのパフォーマンスのデバッグ

順序：最適化 → コネクションプーリング → ORM パターン

Read ../database/postgres-query-optimization.md # 低速クエリをデバッグ Read ../database/database-connection-pooling.md # プールの設定を確認 Read ../database/orm-patterns.md # N+1 クエリを修正

スキーマの進化

順序：スキーマ設計 → マイグレーション

Read ../database/postgres-schema-design.md # 変更を設計 Read ../database/postgres-migrations.md # 安全に実装

キャッシュレイヤー

順序：Redis のデータ構造 → キャッシュパターン

Read ../database/redis-data-structures.md # Redis のパターン Read ../caching/INDEX.md # キャッシュパターン

スキルの選択ガイド

PostgreSQL スキル（リレーショナル、ACID、複雑なクエリ）：

• postgres-schema-design.md - リレーショナルスキーマを設計
• postgres-query-optimization.md - 複雑なクエリを最適化
• postgres-migrations.md - 時間の経過に応じてスキーマを進化

MongoDB スキル（ドキュメント指向、柔軟なスキーマ）：

• mongodb-document-design.md - ドキュメント構造を設計
• 次の場合に選択：柔軟なスキーマ、ネストされたデータ、迅速な反復

Redis スキル（インメモリ、キーと値、キャッシュ）：

• redis-data-structures.md - キャッシュ、セッション、レート制限
• 次の場合に選択：速度が重要、キャッシュレイヤー、リアルタイム機能

データベース横断スキル：

• database-selection.md - 新しいプロジェクトではここから開始
• database-connection-pooling.md - すべてのデータベースで必要
• orm-patterns.md - ORM（SQLAlchemy、Prisma、Mongoose）を使用する場合

他のスキルとの連携

データベーススキルは、以下のスキルと組み合わせて使用されることがよくあります。

API スキル（discover-api）：

• API エンドポイント → データベースクエリ
• API サーバー向けのコネクションプーリング
• API のパフォーマンスを高めるクエリの最適化
• API のバージョン管理と並行したマイグレーション

バックエンド言語スキル（discover-backend）：

• Python：SQLAlchemy、psycopg2、PyMongo
• Zig：PostgreSQL C バインディング
• Rust：SQLx、Diesel
• Go：database/sql、GORM

テストスキル（discover-testing）：

• テストデータベースを使った統合テスト
• マイグレーションテスト
• クエリパフォーマンステスト
• データフィクスチャ管理

データパイプラインスキル（discover-data）：

• データベースからの ETL
• データソースとしてのデータベース
• 大量データ操作
• データベース変更のストリーミング（CDC）

可観測性スキル（discover-observability）：

• クエリメトリクスとスロークエリログ
• コネクションプールのメトリクス
• データベースパフォーマンスの監視
• アラートの設定

段階的な読み込み

このゲートウェイスキル（約200行、約2Kトークン）により、段階的な読み込みが可能になります。

• レベル1：ゲートウェイが自動的に読み込まれます（現在ここにいます）
• レベル2：カテゴリの INDEX.md（約3Kトークン）を読み込み、全体像を把握します
• レベル3：必要に応じて個別のスキル（各約2～4Kトークン）を読み込みます

合計コンテキスト：2K + 3K + スキル（複数可）＝5～10Kトークン。インデックス全体を読み込む場合の25K以上と比べて少なくて済みます。

クイックスタートの例

「EC アプリの PostgreSQL スキーマを設計する」： Read ../database/postgres-schema-design.md

「クエリが遅いのはなぜですか？」： Read ../database/postgres-query-optimization.md

「データベーススキーマを安全に変更するにはどうすればよいですか？」： Read ../database/postgres-migrations.md

「MongoDB と PostgreSQL のどちらを使うべきですか？」： Read ../database/database-selection.md

「Redis を使ってキャッシュを実装する」： Read ../database/redis-data-structures.md

「ORM の N+1 クエリを修正する」： Read ../database/orm-patterns.md

データベースの種類を選ぶための判断ツリー

Need ACID transactions? YES → PostgreSQL
Need complex queries/joins? YES → PostgreSQL
Need flexible schema? YES → MongoDB
Need real-time caching? YES → Redis
Need full-text search? YES → PostgreSQL (with extensions) or Elasticsearch
Need graph relationships? YES → Neo4j or PostgreSQL (with extensions)
Need analytics? YES → DuckDB or Redpanda + Iceberg

詳しい判断方法については、以下を参照してください。 Read ../database/database-selection.md

PostgreSQL の主な領域

スキーマ設計 → postgres-schema-design.md：

• テーブル、カラム、データ型
• 主キー、外部キー、制約
• 正規化と非正規化
• インデックス戦略

クエリの最適化 → postgres-query-optimization.md：

• EXPLAIN と EXPLAIN ANALYZE
• インデックスの選択と作成
• クエリプランの分析
• パフォーマンスの調整

マイグレーション → postgres-migrations.md：

• スキーマ変更の戦略
• ダウンタイムなしのデプロイ
• ロールバック手順
• マイグレーションツール（Alembic、Flyway、migrate）

NoSQL の主な領域

MongoDB → mongodb-document-design.md：

• ドキュメント構造と埋め込み
• 参照と埋め込みのトレードオフ
• スキーマのバージョン管理
• ドキュメント向けのインデックス設計

Redis → redis-data-structures.md：

• 文字列、ハッシュ、リスト、セット、ソート済みセット
• キャッシュのパターンと TTL
• セッションストレージ
• レート制限の実装
• リーダーボードとカウンター

ORM の考慮事項

ORM を使用する前に、以下を読み込んでください。 Read ../database/orm-patterns.md

よくある ORM の落とし穴：

• N+1 クエリの問題
• 遅延読み込みと即時読み込みの混同
• トランザクション管理
• 必要に応じた生の SQL の使用
• マイグレーションの生成

対応している ORM：

• SQLAlchemy（Python）
• Prisma（TypeScript/Node.js）
• Diesel（Rust）
• GORM（Go）
• ActiveRecord（Ruby）
• Entity Framework（C#）

使用方法

1. 自動有効化：Claude Code がデータベース関連の作業を検出すると、このスキルが自動的に読み込まれます
2. スキルを参照する：Read ../database/INDEX.md を実行して、カテゴリの全体像を確認します
3. 個別のスキルを読み込む：上記の bash コマンドを使用して、個別のスキルを読み込みます
4. ワークフローに従う：一般的なパターンに推奨される手順を使用します
5. 選定を支援する：新しいプロジェクトでは、database-selection.md から始めます

次のステップ：Read ../database/INDEX.md を実行してカテゴリの詳細を確認するか、上記の bash コマンドを使用して個別のスキルを読み込んでください。