postgres

Postgres

.skills/postgres/config.toml（レガシー形式：.skills/postgres/postgres.toml）で設定されたアプリケーションデータベースには、<skill-root>/scripts/postgres を使用します。接続する前にプロジェクトとプロファイルを特定し、重要なクエリの実行前と接続先の変更時には、データベースの識別情報を確認してください。設定と会話内容から接続先を特定できない場合に限り、接続先を尋ねてください。

リモートアクセスはデフォルトで読み取り専用にしてください。書き込みや DDL を適用するには、その操作とデータベースについての許可が必要です。明示的な依頼によって許可を得られる場合があります。依頼された SQL の準備と関連する検証には、追加の承認は必要ありません。許可を得ずに適用する前に、具体的な変更についてユーザーが承認できるよう、SQL と検証内容を提示してください。ローカルプロファイルのアクセスガードは、サーバーロール、GRANT、RLS の代わりにはなりません。

SQL ファイルのレイアウト、変更履歴の形式、マイグレーションランナーの選定、リリースの順序は、プロジェクトまたはチームの判断事項です。利用するリポジトリの指示に従ってください。このスキルからプレリリースや変更履歴の規約を推測しないでください。

ルート

• コマンド、接続設定、JSON：実行時の使用方法。
• 設定の選択肢：オプションおよび設定スキーマ。
• 環境変数：環境。
• データベースの検査クエリと識別情報：一般的なワークフロー。
• スキーマ変更：スキーマ変更のガードレール。
• ローカル接続の復旧：復旧。
• スキーマ、クエリ、セキュリティ、並行性、診断の設計： 設計マップ。
• バージョン依存の構文：SQL バージョンルーター。
• 外部テーブル：FDW バージョン。
• 拡張機能：PostGIS、 pgvector、pg_cron、 pgmq、pg_durableのうち、 該当するガイドを参照してください。

デプロイ済みのメジャーバージョンのうち、最も古いバージョンでサポートされる構文を選んでください。不明な場合は、移植性の高い SQL を使用するか、最低バージョンと代替手段を明記してください。完全なバージョンカタログを読み込むのは、アップグレードの比較を行う場合、またはルーターにない機能を使う場合に限ってください。PostgreSQL 19 を前提とする前に、現行のリリース状況を確認してください。

通常のコマンドは設定をメモリ上で正規化します。変更を永続化するのは、意図した設定書き込みコマンド、または文書化されたオプトインを通じてのみ行ってください。実行時の診断には --json doctor を使用してください。ダンプ、リストア、エクスポート、スキーマ差分は、このランチャーの対象外です。オペレーターによるこれらの作業、リポジトリに記載されたコンテナー／スモークテスト、ユーザーによる明示的な選択、またはランチャーの復旧には、生の psql を使用できます。ただし、設定済みのアプリケーションプロファイルを黙って迂回しないでください。