sql-writing-style
Installation
SKILL.md
SQL Writing Style
SQLは実行回数より読まれる回数のほうが多い。読み手の認知負荷を最小にする。
各ルールは「見出し(### 採番. ルールの要旨)+1行の理由+bad / good の対比例」で書く。ルールを追加するときはこの節構造を踏襲する。
ルール
1. テーブルエイリアスは全文を使う。無意味な短縮をしない
FROM stores s のような1文字エイリアスで読み手に逆引きを強いるのは避ける。ただし自己結合や、極端に長いテーブル名で全文表記がかえって読みにくくなる場合は、意味が伝わる短縮エイリアスを許す。
-- bad
FROM stores s
JOIN users u ON u.store_id = s.id