uv-script

Installation
SKILL.md

uv-script

python foo.py で動かす単発のスクリプトを、venv や requirements.txt を作らずに書く。依存とバージョンは スクリプト先頭のインラインメタデータ(PEP 723、# /// script ブロック)に書き、uv run が実行のたびに環境を用意する。

原則:

  • 1 ファイルで完結させる。依存・Python バージョン・exclude-newer はすべてメタデータに入れ、pip install / uv venv / uv pip / requirements.txt は使わない
  • 依存が 1 つでもあるなら [tool.uv] exclude-newer を必ず書く。これが無いと後日実行したときに解決結果が変わる。値はスクリプトを書いた時点の UTC 時刻(RFC 3339)
  • exclude-newer を先に書いてから uv add --script する。uv add --script --exclude-newer はメタデータに日付を書いてくれない(uv 0.12 時点)ので手で書く。先に書いておけば uv add が付ける下限バージョンもその日付に揃う
  • dependencies = [] は空でも必須。requires-python は >=3.X で明示する
  • uv run --with は使い捨ての実験専用。ファイルとして残すスクリプトには使わない
  • 書き上げたら 必ず uv run で一度動かす

コマンドの詳細と細かい挙動は references/cheatsheet.md。

手順

1. 雛形を作る

Installs
2
Repository
upamune/skills
First Seen
Sep 14, 2026