mcpField
D
database-design

database-design

github.com/vudovnデータ・データベース8.2k255 回インストール9 週間前に更新
リポジトリ

database-design について

スキーマ設計、データベースや ORM の選定、クエリ最適化を支援する開発者向けスキルです。状況とユーザーの希望に基づく判断を重視し、関連資料だけを読む方針です。

主な機能

  1. 01データベースと ORM の選定指針
  2. 02スキーマ設計とリレーションの計画
  3. 03インデックスとクエリ最適化の解説
  4. 04サーバーレスデータベースを含むマイグレーション指針
  5. 05コンテンツマップによる選択的な参照

活用シーン

  1. 01アプリの状況に応じたデータベースと ORM の選定
  2. 02スキーマのリレーションとインデックスの計画
  3. 03N+1 クエリやクエリ性能の調査
  4. 04スキーマ変更とマイグレーションの準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/vudovn/ag-kit --skill database-design

インストール後、Claude Code で/database-designを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

database-selection.md
indexing.md
migrations.md
optimization.md
orm-selection.md
schema-design.md
scripts/
schema_validator.py

詳細

データベース設計

SQL のパターンを丸写しするのではなく、考え方を学びましょう。

🎯 選択的読み込みのルール

リクエストに関係するファイルだけを読んでください！ コンテンツマップから必要なものを探してください。

ファイル説明読むタイミング
database-selection.mdPostgreSQL vs Neon vs Turso vs SQLiteデータベースを選ぶとき
orm-selection.mdDrizzle vs Prisma vs KyselyORM を選ぶとき
schema-design.md正規化、主キー、リレーションシップスキーマを設計するとき
indexing.mdインデックスの種類、複合インデックスパフォーマンスチューニング
optimization.mdN+1、EXPLAIN ANALYZEクエリの最適化
migrations.md安全なマイグレーション、サーバーレス DBスキーマを変更するとき

⚠️ 基本原則

  • 要件が不明確な場合は、データベースの希望をユーザーに確認すること
  • データベースや ORM は、コンテキストに基づいて選択すること
  • すべてに対して PostgreSQL をデフォルトにしないこと

決定チェックリスト

スキーマを設計する前に確認してください:

  • ユーザーにデータベースの希望を確認したか？
  • 今回のコンテキストに合ったデータベースを選んだか？
  • デプロイ環境を考慮したか？
  • インデックス戦略を計画したか？
  • リレーションシップの種類を定義したか？

アンチパターン

❌ シンプルなアプリに対して PostgreSQL をデフォルトにする（SQLite で十分な場合がある） ❌ インデックスを省略する ❌ 本番環境で SELECT * を使う ❌ 構造化データが適している場合に JSON を保存する ❌ N+1 クエリを無視する

コメント

Markdown 対応