nanikasheila-csp-name-splitter-python-instructions.ocm.json json {
"ocm": "1",
"id": "nanikasheila-csp-name-splitter-python-instructions",
"kind": "skill",
"name": "python",
"description": "Python ファイルのコーディングガイドライン",
"publisher": "nanikasheila",
"version": "1.0.0",
"capabilities": {
"domains": [
"coding"
],
"tags": [
"skill-md",
"github-instructions"
],
"languages": [
"en"
]
},
"quality_prior": 0.6,
"examples": [
"Python ファイルのコーディングガイドライン"
],
"primary": false,
"metadata": {
"source": {
"provider": "github-instructions",
"repository": "https://github.com/nanikasheila/csp-name-splitter",
"path": ".github/instructions/python.instructions.md",
"ref": "67badd1b7a41ec9f7081e26aabdac1d86ebed34f",
"url": "https://github.com/nanikasheila/csp-name-splitter/blob/67badd1b7a41ec9f7081e26aabdac1d86ebed34f/.github/instructions/python.instructions.md",
"key": "nanikasheila/csp-name-splitter/.github/instructions/python.instructions.md"
},
"applies_to": "**/*.py"
},
"instructions": "# Python ガイドライン\n\n## 型ヒント\n\n- すべての関数引数と戻り値に型ヒントを付ける\n- `typing` モジュールの型を活用する（`Optional`, `Union`, `list[str]` 等）\n- 複雑な型は `TypeAlias` で名前を付ける\n\n## ドキュメント\n\n- すべてのパブリック関数・クラスに docstring を付ける\n- docstring 形式はプロジェクト内で統一する（Google style / NumPy style / reStructuredText）\n- 既存コードの docstring 形式に合わせる\n\n## コードスタイル\n\n- PEP 8 に従う\n- f-string を文字列フォーマットに使用する（`%` や `.format()` より優先）\n- リスト内包表記は1行で読める場合に使用し、複雑な場合はループに展開する\n\n## エラーハンドリング\n\n- 素の `except:` や `except Exception:` は避け、具体的な例外型を捕捉する\n- カスタム例外クラスを定義する場合は `Exception` を継承する\n\n## 禁止パターン\n\n- `import *` の使用\n- ミュータブルなデフォルト引数（`def f(x=[])` → `def f(x=None)` に修正）\n- グローバル変数の",
"cost": {
"context_tokens": 156
}
}
