開発コマンド (Development Commands)

日常の開発で使うコマンドの一覧．人間とエージェントがコマンドを推測せずに済むよう，ここを唯一の参照先とする．コマンドが確定・変更されたら本ファイルに反映する．

※ すべてプロジェクトルートで，仮想環境（.venv）を有効化した状態で実行する（構築手順は ENV_02）．グローバルの Python には pytest 等が入っていない場合がある．

テスト (Test)

# 全テスト（testpaths = tests は pyproject.toml で設定済み）
pytest

# 特定のテストファイル・詳細出力
pytest tests/analysis/test_uniformity.py
pytest -v

テストの書き方は .claude/rules/testing.md を参照．

Lint・フォーマット (Lint & Format)

# lint（設定は ruff.toml）
ruff check .

# 自動修正・フォーマット
ruff check . --fix
ruff format .

解析スクリプト (Analysis Scripts)

# PNG の照明均一性評価（単一画像 / ディレクトリ一括）
python scripts/run_uniformity.py --image data/smtias/whiteboard/xxx.png
python scripts/run_uniformity.py --image data/smtias/whiteboard/

# DNG の照明均一性評価
python scripts/run_uniformity_dng.py --image data/smtias/quantitative/xxx.dng

# ROI の対話的選択（config/roi_config.json に保存）
python scripts/select_roi.py --image data/smtias/whiteboard/xxx.png --key smtias.whiteboard

# 結果ビューア
streamlit run scripts/viewer.py

scripts/compare_*.py・plot_radial_clean.py 等の比較・作図スクリプトは，各ファイル冒頭の docstring「使い方」を参照する
入力は data/，出力は output/（いずれも Git 管理外）

Claude Code フックのテスト (Hook Tests)

.claude/hooks/ のフックを変更した場合，またはテンプレート同期後に実行する（標準ライブラリのみで動く）．

python -m unittest discover -s .claude/hooks/tests -p "test_*.py"