mcpField
P
python-scripting

python-scripting

github.com/89jobrien開発4139 回インストール10 週間前に更新
リポジトリ

python-scripting について

uv と PEP 723 のインラインメタデータを使い、単体で動作する Python スクリプトを作成するスキルです。自動化やデータ処理、コマンドライン作業に取り組む開発者向けに、引数や入出力、再現性の指針を示します。

主な機能

  1. 01単体 Python スクリプトの作成
  2. 02PEP 723 のインライン依存関係
  3. 03argparse による引数設定
  4. 04入出力の処理
  5. 05再現可能なビルドの指針

活用シーン

  1. 01単発の自動化スクリプト作成
  2. 02小規模なデータ処理
  3. 03Python コマンドラインツールの作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/89jobrien/steve --skill python-scripting

インストール後、Claude Code で/python-scriptingを入力して読み込まれたか確認します。

同梱ファイルreferences/uv-script.template.py

詳細

Python スクリプティングスキル

uv と PEP 723 のインラインスクリプトメタデータを使用して、自己完結型の Python スクリプトを作成します。

このスキルでできること

  • スタンドアロンの Python スクリプトを作成する
  • PEP 723 のインライン依存関係を使用する
  • 引数解析を設定する
  • 入出力を処理する
  • 再現可能なビルドを設定する

使用する場面

  • スタンドアロンのユーティリティスクリプト
  • 単発の自動化タスク
  • 簡単なデータ処理
  • CLI ツール
  • 依存関係が必要なスクリプト

参照ファイル

  • references/UV_SCRIPT.template.py - PEP 723 メタデータを含む Python スクリプトのテンプレート

PEP 723 形式

#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.12"
# dependencies = [
#   "requests",
#   "rich",
# ]
# ///

スクリプトの実行

uv run script.py [args]

依存関係は初回実行時に自動でインストールされます。

ベストプラクティス

  • 再現性を確保するために exclude-newer を使用します
  • 使用例を含む docstring を記述します
  • CLI 引数には argparse を使用します
  • 終了コードを返します（成功は 0、エラーは 0 以外）
  • スクリプトの役割を 1 つのタスクに絞ります

コメント

Markdown 対応