python3-core について
python3-coreは、Pythonエンジニアリングタスクを振り分けるスキルです。タスク領域に応じて開発基準や専門スキルを案内し、参考資料とプロジェクト用テンプレートも提供します。
主な機能
- 01タスクを専門スキルへ振り分け
- 02Pythonバージョン別の型付け指針
- 03ツールとPython機能のリファレンス
- 04プロジェクト用アセットテンプレート
- 05監査・レビュー・デバッグのエントリーポイント
活用シーン
- 01Python機能タスクの指針選び
- 02テストやフレームワーク関連スキルの検索
- 03パッケージングやプロジェクト設定でのテンプレート利用
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jamie-bitflight/ claude_skills --skill python3-coreインストール後、Claude Code で/python3-coreを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
assets/.editorconfig.markdownlint.jsonexample.pre-commit-config.yamlhatch_build.pyversion.pyreferences/modern-modules.mdPEP723.mdpython-development-orchestration.mdpython311-features.mdpython312-features.mdpython313-features.mdpython314-features.mdreferences/modern-modules/arrow.mdattrs.mdbidict.mdblinker.mdboltons.mdbox.mdcopier.mddatasette.mdfabric.mdGitPython.mdhttpx.mdpaho-mqtt.mdprefect.mdpython-diskcache.mdpython-dotenv.mdrobotframework.mdshiv.mduvloop.md詳細
Python エンジニアリングのルーティング
まず python-engineering:standards-for-python-development を読み込んでください。このスキルには、このプラグインが適用するすべてのルール(型付けと Any の境界ポリシー、アーキテクチャと SOLID、エラー処理、セキュリティ、パフォーマンス、識別子の命名、スクリプトの依存関係、Rich/Typer の出力、テスト、ツールのデフォルト設定)が含まれています。このスキルが、タスクに適用する専門スキルへルーティングします。
型付けのレーン
python3-typing は、プロジェクトの requires-python の下限と、すでにインストールされている依存関係からレーンを選びます。references/typing-matrix.md には各レーンのインポートと境界の形式が示されており、references/python311-features.md から references/python314-features.md には各バージョンで追加される機能が記載されています。
分野別ルーティング
タスクに明確に該当する場合にのみ、スキルを読み込んでください。
| タスク | 読み込むスキル |
|---|---|
| テスト駆動開発、レッド・グリーン・リファクター、実装前のテスト | python3-tdd |
| テストスイートの設計 — カバレッジ戦略、テストピラミッド、フィクスチャの階層、ミューテーション計画 | python3-test-design |
| 失敗するテストが実際のバグか、テストの不備かを判断する | analyze-test-failures |
| テスト失敗の調査アプローチをリセットする — 2つの仮説を立てるプロトコル、危険信号 | test-failure-mindset |
| テストスイート全体の監査 — カバレッジ、分離、モックの使用、命名、完全性 | comprehensive-test-review |
| Typer/Rich CLI ツール、プログレスバー、ターミナル出力 | python3-cli |
| FastAPI、Starlette、Django、Flask | python3-web |
| pandas、numpy、scipy、jupyter、データパイプライン | python3-data |
| async/await、asyncio、並行 I/O、タスクスケジューリング | async-python-patterns |
| 既存プロジェクトへの機能追加 — 調査、MoSCoW、TDD、統合、検証 | python3-add-feature |
| フェーズと受け入れ基準を含む、構成化された機能タスクファイルの作成 | create-feature-task |
| パッケージのメタデータとビルドターゲット — pyproject.toml、ビルドバックエンド、エントリーポイント | python3-packaging |
| PyPI への公開またはリリース作成 — CI ワークフロー、信頼された公開、TestPyPI | python3-publish-release-pipeline |
| uv、Hatchling、ty、pre-commit、TOML の編集 | python3-tools |
| MkDocs または Material テーマを使ったドキュメントサイト | mkdocs |
| 依存関係のインストールを妨げる制約が確認されている場合 — エアギャップ環境、uv なし、インターネット接続なし | python3-stdlib-only |
| PR、diff、ステージ済み/未ステージの変更、ファイル、ディレクトリに対する、広範な Python 品質/モダナイズ監査 | python-quality-audit |
| タスクの大まかな分類だけでは、この表から選べない場合 | specialist-skill-routing |
手動のエントリーポイント:/python-engineering:python-quality-audit(品質/モダナイズの並列監査)、/python-engineering:review(範囲を限定した一般的なコードレビュー)、/python-engineering:cleanup
(段階的な品質改善)、/python-engineering:lint(決定的なチェック)、
/python-engineering:debug(構造化されたデバッグ)。
リファレンス
| ファイル | 内容 |
|---|---|
references/PEP723.md | インラインスクリプトのメタデータ — ブロック構文、シバン形式、スクリプトを複数のファイルに分割する方法 |
references/typing-matrix.md | Python のバージョンと利用可能な依存関係に応じた型付けのレーン |
references/python311-features.md … python314-features.md | 各 Python バージョンで追加される機能 |
references/modern-modules.md | 用途別に精査された Python 3.11 以降のモジュール |
references/tool-library-registry.md | pyproject.toml のテンプレート変数を含む、ツール、ライブラリ、フレームワークのレジストリ |
references/python-development-orchestration.md | 専門エージェントをまたいだ Python タスクのオーケストレーション |
references/user-project-conventions.md | 本番プロジェクトから抽出した規約 |
アセット
${CLAUDE_PLUGIN_ROOT}/skills/python3-core/assets/ のテンプレート:
version.py— 2つのモードに対応したバージョン管理hatch_build.py— ビルドフックのテンプレートexample.pre-commit-config.yaml— 標準の Git フック.editorconfig— エディターのフォーマット設定