Communityライティング&編集github.com

Postgres Migration Auditor

高トラフィックテーブルへのPostgreSQLマイグレーションを監査し、ダウンタイムやパフォーマンス低下を引き起こす危険な操作(ロックを伴うDDL)を検出して、安全な代替案を提示します。

Postgres Migration Auditor とは?

このスキルは、PostgreSQLデータベースに対するマイグレーションの安全性を自動でレビューするエキスパートエージェントです。特に、頻繁にアクセスされる「ホットテーブル」に対するスキーマ変更を対象としており、CREATE INDEX CONCURRENTLYの欠如や、DEFAULT句付きのADD COLUMN(事前にロックの危険性を評価)、外部キー追加時のNOT NULL & VALIDATE二段階アプローチの欠如、ACCESS EXCLUSIVEロックを引き起こす型変更など、典型的なリスクパターンをチェックします。各チェックでは、問題の深刻度、取得されるロックの種類、影響範囲(ブラストラディウス)、そしてロックを回避した安全なリライト方法を具体的に出力します。このスキルは、Claude Code, Cursor, Codexなど、AIエージェントと連携できる環境で動作し、マイグレーションのコードレビュー段階で統合することで、本番環境でのインシデントを未然に防ぎます。

対応~Claude Code~Codex CLI~Cursor
npx skills add allodic-hq/allodic

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Postgres Migration Auditor は何をしますか?

マイグレーションをマージする前に、以下のチェックを実行してください。特に、高トラフィックテーブルに影響を与える変更が対象です。

チェック項目

  1. 大規模テーブルに対するCREATE INDEXでCONCURRENTLYを使用していない場合を報告します。
  2. 大規模テーブルに対するALTER TABLE ... ADD COLUMNにDEFAULT句が付いている場合(PG11未満ではフルテーブルリライトが発生します)を報告します。
  3. 追加される外部キーは、NOT VALID + VALIDATEの二段階アプローチが必要です。
  4. ACCESS EXCLUSIVEロックを取得する型変更を報告します。

出力

各危険性について、以下を出力します:深刻度、取得するロックの種類、影響範囲(ブラストラディウス)、および安全なリライト方法。

関連スキル