# SQL Writing Style

> SQLを書くときに使用する。読み手が一瞥して理解できるSQLを書くためのスタイルルール。

- Skill: `efoo-team/sql-writing-style` (Agent Skill)
- Install (CLI): `npx skillmds@latest add efoo-team/sql-writing-style`
- Raw SKILL.md: https://api.skillmd.com/api/skills/efoo-team/sql-writing-style/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: efoo-team (https://skillmd.com/u/efoo-team)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/efoo-team/sql-writing-style

---


# SQL Writing Style

SQLは実行回数より読まれる回数のほうが多い。読み手の認知負荷を最小にする。

各ルールは「見出し（`### 採番. ルールの要旨`）＋1行の理由＋`bad` / `good` の対比例」で書く。ルールを追加するときはこの節構造を踏襲する。

## ルール

### 1. テーブルエイリアスは全文を使う。無意味な短縮をしない

`FROM stores s` のような1文字エイリアスで読み手に逆引きを強いるのは避ける。ただし自己結合や、極端に長いテーブル名で全文表記がかえって読みにくくなる場合は、意味が伝わる短縮エイリアスを許す。

```sql
-- bad
FROM stores s
JOIN users u ON u.store_id = s.id

-- good
FROM stores
JOIN users ON users.store_id = stores.id
```