메뉴
Master the uv package manager. Triggers on: pyproject.toml, uv.lock, dependency management, pip alternatives, Dockerfile with Python, CI/CD Python setup, venv, requirements.txt migration.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | uv-package-manager |
| description | Master the uv package manager. Triggers on: pyproject.toml, uv.lock, dependency management, pip alternatives, Dockerfile with Python, CI/CD Python setup, venv, requirements.txt migration. |
uv instead of pip, poetry, or pip-tools for all Python dependency management.source .venv/bin/activate); use uv run <command>.requirements.txt unless specifically requested for a legacy system. Rely on pyproject.toml and uv.lock.uv init . # Initialize in current directory
uv python pin 3.12 # Pin Python version (.python-version)
uv add fastapi pydantic # Add to dependencies
uv add --dev pytest ruff # Add to dev-dependencies
uv remove pandas # Remove dependency
uv run python src/main.py
uv run pytest tests/
uv run ruff check src/
uv lock # Generate/update uv.lock
uv lock --upgrade-package httpx # Upgrade specific package
steps:
- uses: actions/checkout@v4
- name: Install uv
uses: astral-sh/setup-uv@v2
with:
enable-cache: true
cache-dependency-glob: "uv.lock"
- name: Install dependencies
run: uv sync --all-extras --dev
- name: Run tests
run: uv run pytest
MANDATORY: Always use cache mounts and isolate dependency installation from code copying to maximize Docker layer caching.
# BUILDER STAGE
FROM python:3.12-slim AS builder
COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
# Optimizations for Docker mounts
ENV UV_COMPILE_BYTECODE=1 \
UV_LINK_MODE=copy
WORKDIR /app
# 1. Install dependencies FIRST (layer caching)
RUN --mount=type=cache,target=/root/.cache/uv \
--mount=type=bind,source=uv.lock,target=uv.lock \
--mount=type=bind,source=pyproject.toml,target=pyproject.toml \
uv sync --frozen --no-install-project --no-dev --no-editable
# 2. Copy code and install project
COPY src/ ./src/
RUN --mount=type=cache,target=/root/.cache/uv \
uv sync --frozen --no-dev --no-editable
# RUNTIME STAGE
FROM python:3.12-slim AS runtime
WORKDIR /app
# Copy the isolated venv
COPY --from=builder /app/.venv /app/.venv
COPY src/ ./src/
ENV PATH="/app/.venv/bin:$PATH"
CMD ["python", "-m", "src.main"]
| ❌ Anti-pattern | ✅ Correct |
|---|---|
pip install -r requirements.txt | uv sync |
python -m venv .venv && source .venv/bin/activate | uv sync (creates venv automatically) |
uv pip install ... inside a Dockerfile | uv sync --frozen |
COPY . . before uv sync in Docker | Sync lockfiles first, copy code later |
Hexagonal Architecture (Ports & Adapters) for the video publishing pipeline. Triggers on: VideoPublisher, TrendingVideoFetcher, TimeSeriesReader, VideoMetadataReader, AuthCredentialStore, ReleaseDateValidator, OAuthProvider, publisher_registry, ports, adapters, domain, hexagonal, build_publishers, TaskGroup publish.
Type hint patterns for this repo: Protocol, TypeVar, TypedDict, Literal, Final, and strict ty usage. Triggers on: type hints, typing, TypeVar, Protocol, Generic, TypedDict, ty check.
Design, review, and optimize Dockerfiles, Docker images, and Docker Compose configurations for production, performance, and maintainability. Use when auditing Docker configurations, creating production-ready images, designing multi-container architectures, or implementing container orchestration with focus on security, reproducibility, minimal attack surface, build optimization, and observability.
Best practices for modeling, ingesting, querying, and analyzing time-series data with TinyFlux. Use when designing TinyFlux Point schemas, implementing query patterns, managing retention and partitioning, or integrating TinyFlux with pandas/NumPy for analysis and forecasting workflows.
Video processing migration (C1 split): guidelines for decomposing src/video_processing.py into src/infrastructure/video/. Triggers on: video_processing, VideoAssetManager, VideoRenderer, ThumbnailGenerator, VideoCompositor, moviepy, CompositeVideoClip, PIL Image.
Structured logging with structlog. Triggers on: log, logger, exception, structlog, observe, print, logging.