메뉴
uv、ruff、ty を使って再現可能な Python 開発環境を整えたいとき。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | python-setup-dev-environment |
| description | uv、ruff、ty を使って再現可能な Python 開発環境を整えたいとき。 |
uv・ruff・ty を使って、再現可能な Python 開発環境を短い手順で整える skill です。
環境構築と日次運用の入口を 1 本にまとめ、余計な判断を減らします。
ゴール駆動で使うため、最初に達成したいゴール、成功条件、確認手段を短く固定します。
uv run に統一したいときmypy 前提の運用を ty に寄せたいときuv で基盤を作るuv init .
uv run python --version
uv add --dev ruff ty
uv を実行入口にすると、依存関係と実行環境を同じ状態で扱えます。
uv run ruff format .
uv run ruff check .
uv run ty check .
整形、lint、型チェックの順に回すと、差分と失敗原因が追いやすくなります。
# Replace main.py with your project entry script if needed.
uv run python main.py
main.py のようなエントリースクリプトがあるプロジェクトでは、uv run で仮想環境を起こしつつ起動確認までまとめてできます。
uv sync
uv run ruff check .
uv run ty check .
別の端末や別の時点でも同じ状態に戻せるかを確認します。
python ... の直実行を標準にしないuv pip install は通常運用にしないty.toml か pyproject.toml に寄せるskillgit-commitgh-pr-createQ: なぜ ty を使うの？
A: ty は uv / ruff と同じ Astral 系ツールで、型チェックを素早く回しやすいからです。より深い移行判断が必要な場合だけ、別の参照文書を追加します。
こんなときに使う: Ubuntu / Linux サーバーに SSH で接続し、sudo、systemd サービス、HTTP 監視を一連で安全に進めたいとき。 接続前に SSH_AUTH_SOCK を含む認証状態を固定し、認証で止まらずに サーバー接続・権限確認・サービス起動・停止・再起動・状態確認を一気に行いたいとき。
調査→修正→検証→ふりかえり/後続 Issue 化までを 1 つの改善ループで回したいときに使う。 実装前の再現確認や、review 指摘・検証結果をもとに次のアクションへつなぐ。
こんなときに使う: 現在の会話内容をもとに、実装・エージェント発注に直結する PRD を作りたいとき。 追加のインタビューはせず、すでに会話に出ている内容だけから構成する。 情報が不足している場合は捏造せず「未確定」として明示する。
こんなときに使う: ユーザーが「インタビューして」「質問して」「設計を詰めたい」などと言ったら使う。 計画や設計の重要な判断軸を洗い出し、具体例・反例・影響範囲まで深掘りして要件整理に落とす。
Copilot の custom skill / agent / repository instructions の作成・改善・構造確認を 1 つの入口にまとめる。複合スキルとして、対象に応じて適切な authoring ルートへ 分けつつ、実行時のモデル呼び出しを抑止してルーティングを優先する。試作から `plugins/*` 配布へ昇格するときの name / description 整備も扱う。skill / agent / repo-wide instructions / path-specific instructions を新規作成したいとき、既存定義を育てたいとき、公開前に責務や導線を確かめたいとき。
新しい custom agent を既存 agent 群と同じ型で立ち上げる。agent の新規追加、役割分離のための専門 agent 作成、既存群の隙間を埋めたいとき。