Openclaw向けPython コーディングガイドライン

高品質で慣用的、かつメンテナンスが容易なコードを保証するために設計された、包括的な Python コーディング標準と自動チェックのセット。

adarshdigievo
v1.0.0
Feb 3, 2026
14
12.4k
0

インストール&ダウンロード

1. ClawHub CLI

レジストリから直接スキルをインストールする最速の方法です。

npx clawhub@latest install python

2. 手動インストール

スキルフォルダを以下のいずれかの場所にコピーしてください

グローバル
~/.openclaw/skills/
ワークスペース
<project>/skills/

優先順位:ワークスペース > ローカル > バンドル

3. プロンプトのインストール

このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。

Clawhubを使って python をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください(npm i -g clawhub)。

ダウンロードをご希望ですか?

ZIPアーカイブで生のスキルファイルを取得します。

Python コーディングガイドライン とは?

このスキルは、PEP 8 準拠、モダンな構文、効率的な依存関係管理に焦点を当てた Python 開発のための堅牢なフレームワークを提供します。これらの標準を統合することで、開発者と AI エージェントはコードベース全体で一貫性を維持し、uv のような高性能ツールを活用し、可読性とパフォーマンスを向上させる Pythonic なパターンを採用できます。これは、Openclaw Skills エコシステム内で Python コードを記述、レビュー、リファクタリングするための決定的なガイドとして機能します。

厳格なバージョニング(Python 3.10+)と、型ヒントやデータクラスなどのモダンな機能の適用により、このスキルはソフトウェアの将来性を保証し、一般的な落とし穴を回避します。CLI ツールの構築から複雑なバックエンドまで、これらのガイドラインは初期のコード記述から最終的なテスト、デプロイに至るまでの開発ライフサイクルを合理化します。

Python コーディングガイドライン のユースケース

  • チームプロジェクト全体でのコードスタイルと PEP 8 準拠の標準化。
  • コミット前の構文検証とユニットテストの自動化。
  • レガシーなコードベースからモダンな Python 3.10+ 機能への移行。
  • uv または pip を使用した効率的な依存関係管理の実装。
  • dataclasses や pathlib などの慣用的な Pythonic パターンを使用したコードのリファクタリング。

Python コーディングガイドライン の仕組み

  1. エージェントが Python ソースコードを分析し、PEP 8 とモダンな構文標準への準拠を確認します。
  2. 実行時エラーを防ぐため、py_compile モジュールを使用して自動構文チェックを実行します。
  3. 依存関係管理は速度のために uv を優先し、必要に応じて pip にフォールバックします。
  4. pytest や unittest などのテストスイートを自動的に検出し、ロジックを検証するために実行します。
  5. クリーンで標準化された構造を維持するために、Ruff や Black などのコードフォーマットおよびリンティングツールを呼び出します。
  6. 慣用的なコード品質を確保するために、型ヒントやコンテキストマネージャーなどのモダンな Python 機能を検証します。

Python コーディングガイドライン のセットアップ

開発環境でこれらの Openclaw Skills を活用するには、モダンな Python 環境と必要なツールがインストールされていることを確認してください。

# Python 3.10+ がインストールされていることを確認
python --version

# 推奨: 高速な依存関係管理のために uv をインストール
curl -LsSf https://astral.sh/uv/install.sh | sh

# 必須のリンティングおよびテストツールをインストール
pip install pytest ruff black

# 新規に開始する場合は uv でプロジェクトを初期化
uv init

Python コーディングガイドライン のデータスキーマとタクソノミー

このスキルは、以下のタクソノミーを使用して技術要件とメタデータを整理します。

要件 標準仕様
インデント スペース 4 つ(タブ不可)
最大行長 88 文字(Black デフォルト)
命名規則 snake_case(関数/変数)、PascalCase(クラス)
インポート順序 標準ライブラリ \u2192 サードパーティ \u2192 ローカル(アルファベット順)
最小バージョン Python 3.10+
テストパターン ファイル名は test_*.py、関数名は test_*

Python コーディングガイドライン の高度な機能

  • 再現可能な環境のための uv pip compile を使用した自動依存関係解決。
  • 構造的パターンマッチングやセイウチ演算子などのモダンな Python 3.11-3.13 機能のサポート。
  • IDE サポートと信頼性向上のための公開関数に対する包括的な型ヒントの強制。
  • より安全な I/O 操作のための Pathlib とコンテキストマネージャーを使用したインテリジェントなリソース管理。
  • ミュータブルなデフォルト引数やベアな例外処理を防ぐための組み込みアンチパターン検出。

SKILL.md


ローディング

関連するOpenclawのスキル

特徴*