메뉴
Use this before writing Python code, creating Python scripts, modifying Python files, or when user asks to "write python", "create a python script", "implement in python". TRIGGER when starting any Python development task.
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/archibate/dotfiles-opencode --skill writing-python명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | writing-python |
| description | Use this before writing Python code, creating Python scripts, modifying Python files, or when user asks to "write python", "create a python script", "implement in python". TRIGGER when starting any Python development task. |
Modern Python development using uv for package management, PEP 723 for single-file scripts, and best-in-class tooling.
By default, create self-contained scripts using PEP 723 format:
#!/usr/bin/env -S uv run --script
# /// script
# dependencies = [
# "typer",
# "rich",
# ]
# ///
"""
Script description and usage examples.
Usage:
uv run python3 script.py --help
uv run python3 script.py --option value
"""
import sys
# ... rest of script
Run with: uv run python3 script.py
For larger projects requiring multiple files:
# Pin Python version
uv python pin 3.12
# Create virtual environment
uv venv --python 3.12
# Activate environment
source .venv/bin/activate
# Add dependencies
uv add package-name
# Run script
uv run python script.py
All tooling configuration is centralized in /tests/pyproject.toml.
Run from /tests directory:
cd tests
# Run tests
uv run pytest
uv run pytest -v # verbose
# Type checking
uv run pyright
uv run pyright --stats
# Linting & formatting
uv run ruff check ../.opencode/skill
uv run ruff check --fix ../.opencode/skill
uv run ruff format ../.opencode/skill
Tool choices:
For detailed usage, see:
references/ruff.md - Linting and formattingreferences/pyright.md - Static type checkingreferences/pytest.md - Testing framework--help flaguv run python3 script.py --help--dry-run - Show what would happen without executing--verbose - Detailed output for debugging#!/usr/bin/env uv run python3
# /// script
# dependencies = [
# "typer", # Modern CLI framework
# "rich", # Beautiful terminal output
# "httpx", # Modern HTTP client
# ]
# ///
Minimize dependencies - Try using stdlib first.
uv add <package> # Add package to pyproject.toml
uv remove <package> # Remove package
uv sync # Install/sync dependencies
uv lock # Create/update lock file
uv python install <version> # Install Python version
uv python list # List installed versions
uv python pin <version> # Set project Python version
uv run python script.py # Run with project environment
uvx <tool> # Run tool in isolated environment
uv tool install <package> # Install global tool
General approach: Code directly as you see fit.
Use TDD when: Facing issues or building complex components.
See references/pytest.md for comprehensive testing guide.
.opencode/skill/<skill>/
├── SKILL.md
└── scripts/
├── <script>.py
└── tests/
└── test_<script>.py
from pathlib import Path
import subprocess
SCRIPT_PATH = Path(__file__).parent.parent / "script.py"
def run_script(*args, env=None):
"""Execute script with uv run."""
cmd = ["uv", "run", str(SCRIPT_PATH)] + list(args)
result = subprocess.run(cmd, capture_output=True, text=True, env=env)
return result.stdout, result.stderr, result.returncode
class TestVersion:
"""Test --version flag."""
def test_version_flag(self):
"""--version should output version and exit with 0."""
stdout, stderr, code = run_script("--version")
assert code == 0
assert "version" in stdout.lower()
| Code | Meaning |
|---|---|
| 0 | Success (version, help, dry-run) |
| 1 | Runtime/API error |
| 2 | Validation error |
| 130 | Keyboard interrupt |
See references/pyright.md for comprehensive type checking guide.
def greet(name: str) -> str:
return f"Hello, {name}"
def find_user(id: int) -> str | None:
return None
def process(items: list[str]) -> dict[str, int]:
return {item: len(item) for item in items}
Use structured docstrings with Args, Returns, and Raises sections:
def calculate_total(items: list[dict], tax_rate: float = 0.0) -> float:
"""Calculate the total cost of items including tax.
Args:
items: List of item dictionaries with 'price' keys
tax_rate: Tax rate as decimal (e.g., 0.08 for 8%)
Returns:
Total cost including tax
Raises:
ValueError: If items is empty or tax_rate is negative
"""
if not items:
raise ValueError("Items list cannot be empty")
if tax_rate < 0:
raise ValueError("Tax rate cannot be negative")
subtotal = sum(item["price"] for item in items)
return subtotal * (1 + tax_rate)
python3 or pip directlyNever use mutable objects (lists, dicts) as default argument values:
# BAD - The list persists across calls!
def add_item(item, items=[]):
items.append(item)
return items
add_item("a") # ['a']
add_item("b") # ['a', 'b'] - Unexpected!
# GOOD - Use None and create inside function
def add_item(item, items=None):
if items is None:
items = []
items.append(item)
return items
Never use bare except: - always catch specific exceptions:
# BAD - Catches everything including KeyboardInterrupt
try:
do_something()
except:
pass
# GOOD - Catch specific exceptions
try:
do_something()
except (ValueError, TypeError) as e:
print(f"Error: {e}", file=sys.stderr)
sys.exit(1)
Use is / is not for None comparisons:
# BAD
if value == None:
...
# GOOD
if value is None:
...
Store secrets in .env files, never in code:
# Load from .env file
from dotenv import load_dotenv
import os
load_dotenv()
api_key = os.getenv("API_KEY")
if not api_key:
print("Error: API_KEY not set", file=sys.stderr)
sys.exit(1)
.env to .gitignore# Environment variables
.env
.env.local
.env.*.local
references/ruff.md - Linting and formatting guidereferences/pyright.md - Type checking guidereferences/pytest.md - Testing framework guide