postgres について
postgres は、PostgreSQL の作業向けに専門的なスキルをまとめたものです。データベースの調査、テーブル設計、検索、TimescaleDB、マイグレーションの資料をタスクに応じて参照できます。
主な機能
- 01既存データベース構造の読み取り調査
- 02標準テーブルと PostGIS テーブルの設計
- 03pgvector とハイブリッド検索の構成
- 04TimescaleDB ハイパーテーブルの設定と評価
- 05本番データベースのマイグレーション計画
活用シーン
- 01既存データベースのテーブルやルーチンの調査
- 02空間検索またはベクトル検索向けのテーブル設計
- 03既存テーブルのハイパーテーブル化の評価
- 04本番環境のスキーマ変更の計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ timescale/ pg-aiguide --skill postgresインストール後、Claude Code で/postgresを入力して読み込まれたか確認します。
詳細
PostgreSQL エキスパートスキル
このスキルでは、専門的なリファレンスを通じて PostgreSQL に関する包括的な知識を提供します。タスクに応じて適切なリファレンスを読み込んでください。
利用可能なリファレンス
既存のデータベース
- schema-exploration —
pg_catalogを使用して、スキーマ、テーブル、ビュー、ルーチン、トリガー、RLS、拡張機能を、読み取り専用で質問に沿って調査します。変更の設計やクエリの作成に先立って、既存のデータベースを理解するために使用します。
テーブル設計
- design-postgres-tables — データ型、制約、インデックス、JSONB のパターン、パーティショニング、PostgreSQL のベストプラクティスを扱います。一般的なテーブル/スキーマの設計タスクで使用します。
- design-postgis-tables — PostGIS の空間テーブル設計:geometry と geography の型、SRID、空間インデックス、位置情報に基づくクエリのパターンを扱います。タスクに地理データまたは空間データが含まれる場合に使用します。
検索
- pgvector-semantic-search — pgvector によるベクトル類似検索:HNSW/IVFFlat インデックス、halfvec ストレージ、量子化、フィルタリング検索、チューニングを扱います。埋め込み、RAG、セマンティック検索で使用します。
- postgres-hybrid-text-search — RRF を使用して BM25 キーワード検索と pgvector セマンティック検索を組み合わせるハイブリッド検索です。キーワード検索と意味に基づく検索を組み合わせる場合に使用します。
TimescaleDB
- setup-timescaledb-hypertables — ハイパーテーブルの作成、圧縮、保持ポリシー、継続的集計、インデックスを扱います。TimescaleDB を一からセットアップする場合に使用します。
- find-hypertable-candidates — 既存のテーブルを分析し、ハイパーテーブルへの変換候補を評価する SQL クエリです。移行するテーブルを評価する場合に使用します。
- migrate-postgres-tables-to-hypertables — パーティション列の選択、インプレース方式とブルーグリーン方式、検証を含む段階的な移行手順です。移行を実行する場合に使用します。
移行
- postgres-database-migration — DDL のロックに関するリファレンス、安全な移行パターン、タイムアウト戦略、ロールバック計画、フォークベースのテストを扱います。本番データベースのスキーマ変更を計画または実行する場合に使用します。
使用方法
- 上記の説明から、ユーザーのタスクに合うリファレンスを特定します。
- リファレンスファイルを読み込み、詳しい手順と SQL のパターンを確認します。
- 複数の分野にまたがるタスク(例:「ベクトル検索に対応したテーブルを設計する」)では、必要に応じて複数のリファレンスを読み込みます。
コメント
Markdown 対応