Dignified Python コーディング規約スキル
クリーンで保守性が高く、モダンなPythonコード(バージョン3.10~3.13)を記述するためのプロダクション品質のPythonコーディング規約。
このスキルを使用するタイミング
以下のようなユーザーの質問に対して自動的に呼び出されます:
- 「これをPython的にして」/「これは良いPythonコード?」
- 「型ヒント」/「型アノテーション」/「typing」
- 「LBYL vs EAFP」/「例外処理」
- 「pathlib vs os.path」/「パス操作」
- 「CLIパターン」/「clickの使い方」
- 「コードレビュー」/「このコードを改善して」
- Pythonのコード品質や標準に関するあらゆる質問
注意: このスキルは汎用的なPython標準であり、Dagster固有ではありません。Dagsterのパターンについては /dagster-expert を使用してください。
このスキルを使用するタイミングと他のスキルとの比較
| ユーザーのニーズ | このスキルを使用する | 代替スキル |
|---|---|---|
| 「これをPython的にして」 | ✅ はい - Python標準 | |
| 「これは良いPythonコード?」 | ✅ はい - コード品質 | |
| 「型ヒント」 | ✅ はい - 型付けガイダンス | |
| 「LBYL vs EAFP」 | ✅ はい - 例外パターン | |
| 「pathlib vs os.path」 | ✅ はい - パス操作 | |
| 「Dagster固有のパターン」 | ❌ いいえ | /dagster-expert |
| 「CLI引数解析」 | ✅ はい - CLIパターン |
コア知識(常に読み込まれる)
バージョン検出
プロジェクトの最小Pythonバージョンを特定するには、以下の順序で確認します:
pyproject.toml-requires-pythonフィールドを探す(例:requires-python = ">=3.12")setup.pyまたはsetup.cfg-python_requiresを探す.python-versionファイル -3.12や3.12.0のようなバージョンを含む- バージョン指定子が見つからない場合は、デフォルトでPython 3.12とする
特定したら、適切なバージョン固有ファイルを読み込みます:
- Python 3.10:
versions/python-3.10.mdを読み込む - Python 3.11:
versions/python-3.11.mdを読み込む - Python 3.12:
versions/python-3.12.mdを読み込む - Python 3.13:
versions/python-3.13.mdを読み込む
条件付き読み込み(タスクパターンに基づいて読み込む)
上記のコアファイルでPythonコードパターンの80%以上をカバーします。以下の追加ファイルは、特定のパターンを検出した場合にのみ読み込んでください:
パターン検出の例:
- タスクに「click」または「CLI」が含まれる場合 ->
cli-patterns.mdを読み込む - タスクに「subprocess」が含まれる場合 ->
subprocess.mdを読み込む
リファレンスドキュメント構成
リファレンスドキュメントは、トップレベルのファイルとサブディレクトリに整理されています:
コアリファレンス(SKILL.md と同階層)
dignified-python-core.md- 必須標準(常に読み込まれる)cli-patterns.md- コマンドラインインターフェースパターン(click, argparse)subprocess.md- サブプロセス操作
バージョン固有リファレンス(versions/)
versions/python-3.10.md- Python 3.10+ で利用可能な機能versions/python-3.11.md- Python 3.11+ で利用可能な機能versions/python-3.12.md- Python 3.12+ で利用可能な機能versions/python-3.13.md- Python 3.13+ で利用可能な機能
高度なトピック(references/advanced/)
exception-handling.md- LBYLパターン、エラーバウンダリinterfaces.md- ABCおよびProtocolパターンtyping-advanced.md- 高度な型付けパターンapi-design.md- API設計原則
各リファレンスドキュメントを読むタイミング
references/advanced/exception-handling.md
読むタイミング:
- try/exceptブロックを書くとき
- 例外を発生させる可能性のあるサードパーティAPIをラップするとき
from eまたはfrom Noneを記述するとき、または見かけたとき- LBYLの代替手段があるかどうか不明なとき
references/advanced/interfaces.md
読むタイミング:
- ABCまたはProtocolクラスを作成するとき
- @abstractmethodデコレータを書くとき
- ゲートウェイ層インターフェースを設計するとき
- ABCとProtocolのどちらを選ぶか判断するとき
references/advanced/typing-advanced.md
読むタイミング:
- typing.cast() を使用するとき
- Literal型エイリアスを作成するとき
- 条件ブロック内で型を絞り込むとき
references/module-design.md
読むタイミング:
- 新しいPythonモジュールを作成するとき
- モジュールレベルのコード(単純な定数を超えるもの)を追加するとき
- モジュールレベルで @cache デコレータを使用するとき
- モジュールレベルで Path() または計算処理が見られるとき
- インラインインポートを検討するとき
references/api-design.md
読むタイミング:
- 関数にデフォルトパラメータ値を追加するとき
- 5つ以上のパラメータを持つ関数を定義するとき
- ThreadPoolExecutor.submit() を使用するとき
- 関数シグネチャをレビューするとき
references/checklists.md
読むタイミング:
- Pythonコードをコミットする前の最終レビュー時
- すべてのルールに従っているかどうか不明なとき
- 要件をすぐに確認する必要があるとき
このスキルの使用方法
- コア知識は自動的に読み込まれます(LBYL、pathlib、基本的なインポート、アンチパターン)
- バージョン検出は1回実行されます - 最小Pythonバージョンを特定し、適切なバージョンファイルを読み込みます
- リファレンスドキュメントは、上記のトリガーに基づいてオンデマンドで読み込まれます
- 追加パターンは追加の読み込みが必要な場合があります(CLIパターン、サブプロセス)
- 各ファイルは自己完結型であり、そのドメインに関する完全なガイダンスを提供します