python-idioms

name	python-idioms
description	Pythonを書く/レビューする時に「よりPythonらしい書き方」を素早く参照するための定石集（開発用の手引き・チートシート）。
license	Apache-2.0

目的

• Pythonコードを「動く」から「読みやすい・壊れにくい・直しやすい」へ寄せるための参照メモ。
• 実装中/レビュー中に、迷いがちな書き方の判断基準を短時間で引けるようにする。

使い方

• 実装中: references/TECHNIQUES.md から該当トピック（例: f-string / pathlib / 例外）を引いて適用する。
• レビュー時: references/CHECKLIST.md を上から順に当てて、改善点を列挙する。

収録（参照ファイル）

• references/TECHNIQUES.md
  • テクニック（イディオム）別の「なぜ/いつ/例/注意点」
• references/CHECKLIST.md
  • 実務レビュー用チェックリスト
• references/SOURCES.md
  • 参考リンク（外部記事など）

このスキルの方針

• 外部記事の内容を丸写しせず、要点・判断基準・自分の実務観点に再整理して書く。
• 「必ずこうする」ではなく、トレードオフ（可読性/安全性/性能/依存）も併記する。