Dignified Python

クリーンで保守性の高い、モダンなPythonコード（バージョン3.10-3.13）を書くための意見的なPythonガイダンス。

このスキルを使用する場合

ユーザーが以下について質問した場合に自動実行します：

• 「pythonらしくしてほしい」/「これは良いpythonか」
• 「型ヒント」/「型アノテーション」/「typing」
• 「LBYLとEAFP」/「例外処理」
• 「pathlib vs os.path」/「パス操作」
• 「CLIパターン」/「click使用法」
• 「コードレビュー」/「このコードを改善してほしい」
• Pythonコード品質または標準に関するすべての質問

注意: このスキルはDagster固有ではなく、汎用的なPythonスタイルガイダンスです。1つの明示的なLBYL傾向の規約セットをキャプチャしています。プロジェクトの規約が必要な場合はそれをオーバーライドできます。

このスキルと他のスキルの使い分け

ユーザーの需要	このスキル使用	代替スキル
「pythonらしくしてほしい」	✅ はい - Python標準
「これは良いpythonか」	✅ はい - コード品質
「型ヒント」	✅ はい - 型ガイダンス
「LBYLとEAFP」	✅ はい - 例外パターン
「pathlib vs os.path」	✅ はい - パス処理
「dagsterのベストプラクティス」	❌ いいえ	/dagster-best-practices
「Xパイプラインを実装する」	❌ いいえ	/dg 実装用
「どのインテグレーション使う」	❌ いいえ	/dagster-expert
「CLI引数パース」	✅ はい - CLIパターン

コア知識（常にロード）

@dignified-python-core.md

バージョン検出

プロジェクトの最小Pythonバージョンを確認 (順序で):

1. pyproject.toml - requires-python フィールドを探す（例：requires-python = ">=3.12"）
2. setup.py または setup.cfg - python_requires を探す
3. .python-version ファイル - 3.12 または 3.12.0 のようなバージョンを含む
4. バージョン指定が見つからない場合、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 をロード

リファレンスドキュメント構造

このスキルのリファレンス資料はトピック別に整理されています：

コアリファレンス

• dignified-python-core.md - 必須標準（常にロード）
• cli-patterns.md - コマンドラインインターフェースパターン（click、argparse）

バージョン固有リファレンス（versions/）

• python-3.10.md - Python 3.10以降で利用可能な機能
• python-3.11.md - Python 3.11以降で利用可能な機能
• python-3.12.md - Python 3.12以降で利用可能な機能
• 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() または計算を見る場合
• インライン import を検討する場合

references/advanced/api-design.md

読む場合:

• 関数にデフォルトパラメータ値を追加する場合
• 5個以上のパラメータを持つ関数を定義する場合
• ThreadPoolExecutor.submit() を使用する場合
• 関数シグネチャをレビューする場合

references/checklists.md

読む場合:

• Pythonコードをコミットする前の最終レビュー
• すべてのルールに従ったかどうか不確実な場合
• 要件の簡単なルックアップが必要な場合

このスキルの使用方法

1. コア知識は自動的にロードされます（デフォルト、pathlib、import、 アンチパターン）
2. バージョン検出は1回実行 - 最小Pythonバージョンを識別し、適切なバージョンファイルをロード
3. リファレンスドキュメントは上記のトリガーに基づいてオンデマンドでロード
4. 追加パターンは余分なロードが必要な場合があります（CLIパターン、subprocess）
5. 各ファイルは自立しています - そのドメイン用の完全なガイダンスを含みます