開発コマンド (Development Commands)

日常の開発で使うコマンドの一覧．コマンドを推測せず必ず本ファイルを参照する（新しく確定・変更された時は本ファイルに反映する）．

※ 学習・評価・リモート実行のコマンドは未実装のため本ファイルには未記載（実装時に追記する）． ※ Git Bash ではログの日本語が文字化けする．先頭に PYTHONIOENCODING=utf-8 を付けると正しく表示される．

環境 (Environment)

目的	コマンド	備考
依存の同期	`uv sync`	初回・`pyproject.toml` 変更後．手元には CPU 版 PyTorch が入る
依存の追加	`uv add <パッケージ>`	`uv.lock` が更新されるのでコミットする
開発用依存の追加	`uv add --dev <パッケージ>`	pytest・ruff 等
Python の実行	`uv run python <スクリプト>`	仮想環境を明示的に有効化しなくてよい

目的	コマンド	備考
合成データの生成	`uv run python scripts/make_synthetic_dataset.py`	出力は `data/synthetic/`（`images/<label>_<severity>/` と `manifest.csv`）．既定は 1 ディレクトリ 10 枚・seed 0
合成データの作り直し	`uv run python scripts/make_synthetic_dataset.py --overwrite`	目印ファイル `.synthetic_dataset` がある出力先だけを削除して作り直す（実データの誤削除を防ぐため）
枚数・seed の指定	`uv run python scripts/make_synthetic_dataset.py --per-dir 50 --seed 1`	出力先は `--out` で変更できる

設定ファイルは configs/synthetic.yaml（手元の合成データ）と configs/newton.yaml（サーバの実データ）．環境変数 TIAS_DATA_ROOT を設定すると data.root より優先される．

目的	コマンド
全テスト	`uv run pytest`
特定ファイル	`uv run pytest tests/data/test_split.py`
詳細表示	`uv run pytest -v`

臨床データに依存するテストは書かない（合成データで動くテストのみ）．

※ .claude/ はテンプレート所有のため ruff の対象外（pyproject.toml の extend-exclude）．テンプレート由来のフックのテストは uv run pytest .claude/hooks/tests で実行する．

目的	コマンド	備考
フックのテスト	`bash .claude/hooks/tests/test_hooks.py` 相当を `uv run pytest .claude/hooks/tests`	テンプレート由来．`.claude/` の変更時に確認する

実装した時点で本ファイルに追記する．