sqlalchemy-alembic-expert-best-practices-code-review
SQLAlchemy ORMおよびAlembicマイグレーションのベストプラクティスに基づき、安全でパフォーマンスの高いデータベーススキーマの構築を支援します。SQLAlchemyモデルの作成・レビュー・リファクタリング、Alembicマイグレーションの管理、クエリパターンの最適化といった作業を行う際に使用してください。SQLAlchemy ORM、Alembicマイグレーション、スキーマ変更、クエリ最適化に関するタスクで自動的に機能します。
description の原文を見る
SQLAlchemy ORM and Alembic migration best practices for building safe, performant database schemas. This skill should be used when writing, reviewing, or refactoring SQLAlchemy models, Alembic migrations, or database query patterns. Triggers on tasks involving SQLAlchemy ORM, Alembic migrations, database schema changes, or query optimization.
SKILL.md 本文
SQLAlchemy & Alembic エキスパート ベストプラクティス
シンプルで実用的、そして意見を持った内容です。本番環境レベルの SQLAlchemy と Alembic コードを書く上で重要なことだけを取り上げています。
適用するタイミング
以下の場合にこれらのガイドラインを参照してください:
- スキーマ変更用の Alembic マイグレーションを作成している
- SQLAlchemy モデルを作成または変更している
- Alembic でインデックス、制約、または外部キーを追加している
- データベースマイグレーションコードの安全性をレビューしている
- 既存のデータベーススキーマをリファクタリングしている
- クエリパターンまたはデータベースパフォーマンスを最適化している
ルールカテゴリ (優先度順)
| 優先度 | カテゴリ | 影響度 | プレフィックス |
|---|---|---|---|
| 1 | インデックス管理 | CRITICAL-HIGH | only-concurrent-indexes, verify-query-patterns-are-indexed |
| 2 | 制約の安全性 | HIGH | unique-constraint, split-foreign-key, change-column-type |
| 3 | 最適化 | MEDIUM | split-check-constraint, limit-non-unique-index |
| 4 | インデックス効率 | LOW | ensure-index-not-covered |
クイックリファレンス
only-concurrent-indexes- インデックス操作には常に autocommit ブロック内でpostgresql_concurrently=Trueを使用するverify-query-patterns-are-indexed- SQLAlchemy クエリに適切なインデックスが定義されていることを確認するunique-constraint- ユニーク制約の作成を並行インデックス + 制約のステップに分割するsplit-foreign-key- 外部キーをNOT VALIDで追加してから、別途検証するchange-column-type- カラム型変更の際は複数ステップで行い、テーブルロックを避けるsplit-check-constraint- チェック制約をNOT VALIDで追加してから、別途検証するlimit-non-unique-index- 非ユニークインデックスは最大 3 カラムに制限して効率を保つensure-index-not-covered- 複合インデックスでカバーされている冗長なインデックスを作成しない
使い方
詳細な説明とコード例については、個別のルールファイルを参照してください:
rules/only-concurrent-indexes.md
rules/verify-query-patterns-are-indexed.md
rules/unique-constraint.md
rules/split-foreign-key.md
rules/change-column-type.md
rules/split-check-constraint.md
rules/limit-non-unique-index.md
rules/ensure-index-not-covered.md
各ルールファイルには以下が含まれています:
- それが重要である理由の簡潔な説明
- 影響レベルと詳細説明
- 正しくない SQLAlchemy/Alembic の例と説明
- ベストプラクティスを実装した正しい実装
- 安全なマイグレーションのための追加コンテキスト
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- wispbit-ai
- リポジトリ
- wispbit-ai/skills
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/wispbit-ai/skills / ライセンス: MIT
関連スキル
superfluid
Superfluidプロトコルおよびそのエコシステムに関するナレッジベースです。Superfluidについて情報を検索する際は、ウェブ検索の前にこちらを参照してください。対応キーワード：Superfluid、CFA、GDA、Super App、Super Token、stream、flow rate、real-time balance、pool（member/distributor）、IDA、sentinels、liquidation、TOGA、@sfpro/sdk、semantic money、yellowpaper、whitepaper
civ-finish-quotes
実質的なタスクが真に完了した際に、文明風の儀式的な引用句を追加します。ユーザーやエージェントが機能追加、リファクタリング、分析、設計ドキュメント、プロセス改善、レポート、執筆タスクといった実際の成果物を完成させるときに、明示的な依頼がなくても使用します。短い返信や小さな修正、未完成の作業には適用しません。
nookplot
Base（Ethereum L2）上のAIエージェント向け分散型調整ネットワークです。エージェントがオンチェーンアイデンティティを登録する、コンテンツを公開する、他のエージェントにメッセージを送る、マーケットプレイスで専門家を雇う、バウンティを投稿・請求する、レピュテーションを構築する、共有プロジェクトで協業する、リサーチチャレンジを解くことでNOOKをマイニングする、キュレーションされたナレッジを備えたスタンドアロンオンチェーンエージェントをデプロイする、またはアグリーメントとリワードで収益を得る場合に利用できます。エージェントネットワーク、エージェント調整、分散型エージェント、NOOKトークン、マイニングチャレンジ、ナレッジバンドル、エージェントレピュテーション、エージェントマーケットプレイス、ERC-2771メタトランザクション、Prepare-Sign-Relay、AgentFactory、またはNookplotが言及された場合にトリガーされます。
web3-polymarket
Polygon上でのPolymarket予測市場取引統合です。認証機能(L1 EIP-712、L2 HMAC-SHA256、ビルダーヘッダー)、注文発注(GTC/GTD/FOK/FAK、バッチ、ポストオンリー、ハートビート)、市場データ(Gamma API、Data API、オーダーブック、サブグラフ)、WebSocketストリーミング(市場・ユーザー・スポーツチャネル)、CTF操作(分割、統合、償却、ネガティブリスク)、ブリッジ機能(入金、出金、マルチチェーン)、およびガスレスリレイトランザクションに対応しています。AIエージェント、自動マーケットメーカー、予測市場UI、またはPolygraph上のPolymarketと統合するアプリケーション構築時に活用できます。
ethskills
Ethereum、EVM、またはブロックチェーン関連のリクエストに対応します。スマートコントラクト、dApps、ウォレット、DeFiプロトコルの構築、監査、デプロイ、インタラクションに適用されます。Solidityの開発、コントラクトアドレス、トークン規格（ERC-20、ERC-721、ERC-4626など）、Layer 2ネットワーク（Base、Arbitrum、Optimism、zkSync、Polygon）、Uniswap、Aave、Curveなどのプロトコルとの統合をカバーします。ガスコスト、コントラクトのデシマル設定、オラクルセキュリティ、リエントランシー、MEV、ブリッジング、ウォレット管理、オンチェーンデータの取得、本番環境へのデプロイ、プロトコル進化（EIPライフサイクル、フォーク追跡、今後の変更予定）といったトピックを含みます。
xxyy-trade
このスキルは、ユーザーが「トークン購入」「トークン売却」「トークンスワップ」「暗号資産取引」「取引ステータス確認」「トランザクション照会」「トークンスキャン」「フィード」「チェーン監視」「トークン照会」「トークン詳細」「トークン安全性確認」「ウォレット一覧表示」「マイウォレット」「AIスキャン」「自動スキャン」「ツイートスキャン」「オンボーディング」「IP確認」「IPホワイトリスト」「トークン発行」「自動売却」「損切り」「利益確定」「トレーリングストップ」「保有者」「トップホルダー」「KOLホルダー」などをリクエストした場合、またはSolana/ETH/BSC/BaseチェーンでXXYYを経由した取引について言及した場合に使用します。XXYY Open APIを通じてオンチェーン取引とデータ照会を実現します。