python-code-stylecommit cbb6049SKILL.md · コーディング規約
Python コードスタイル
Python のリンター・フォーマッター設定、PEP 8 の命名、import の順序、型ヒント、Google スタイルの docstring をまとめます。
npx skills add wshobson/agents --skill python-code-styleコマンドを選択しました。手動でコピーしてください。
- 権限
- read-repo
- write-files
- shell
- network
- 対応ツール
- Claude Code, Codex, Cursor, Copilot, OpenCode
- GitHub
- 42.1k
- 提供元
- コミュニティ · Seth Hobson
- 状態
- スキャン済み
- ライセンス
- MIT
- カテゴリ
- コーディング規約
基本ルール
書式の議論はツールに任せ、一度設定したら自動で適用すること。
実行フェーズ
フェーズ 01ツール設定
pyproject.toml で ruff をリンター兼フォーマッターとして設定し、mypy か pyright を strict で有効にします。
フェーズ 02命名と import
PEP 8 に従い短さより明確さを優先し、import は標準ライブラリ・サードパーティ・ローカルの順にまとめ、絶対 import のみ使います。
フェーズ 03型と docstring
公開 API すべてに型ヒントと Google スタイルの docstring を付け、Args・Returns・Raises・例を書きます。
フェーズ 04書式と文書
行幅は120にして読みやすく改行し、README と Keep a Changelog 形式の CHANGELOG を整え、CI でリンターを走らせます。
権限の説明（SKILL.md より）
| 機能 | 必要か | 説明 |
|---|---|---|
| ファイル書き込み | 必要 | pyproject.toml などの設定を変更し、コードに型と docstring を加え、プロジェクト文書を書きます。 |
| コマンド実行 | 一部で必要 | ruff check --fix、ruff format、ruff や mypy をインストールするコマンドを実行します。 |
| 外部通信 | 一部で必要 | pip で ruff や mypy をインストールするときにパッケージインデックスへアクセスするだけです。 |
SKILL.md のフロントマター（YAML）
---
name: python-code-style
description: Python code style, linting, formatting, naming conventions, and documentation standards. Use when writing new code, reviewing style, configuring linters, writing docstrings, or establishing project standards.
---関連スキル
ルールスキャンですべてのリスクを検出できるわけではありません。インストール前にこのスキルの SKILL.md を読み、権限を確認してください。