drillan Python コマンド判別・実行
概要
現在の環境で使用すべき適切なPythonコマンドを判別し、スクリプトを実行します。プロジェクトの設定（pyproject.toml、.venv、uv）を確認し、最適な方法で実行します。
前提条件
なし（環境を自動検出します）
使用方法
方法1: ラッパースクリプトで実行（推奨）
run-python.sh を使用して、Pythonスクリプトを直接実行します：
skills/detect-python-command/scripts/run-python.sh script.py [args...]
例:
# 設定ファイルの検証
skills/detect-python-command/scripts/run-python.sh \
skills/mixseek-config-validate/scripts/validate-config.py config.toml
# 引数付きで実行
skills/detect-python-command/scripts/run-python.sh script.py --verbose --output result.json
方法2: コマンドの確認のみ
使用されるPythonコマンドを確認したい場合：
# 標準モード（コマンド名のみ）
skills/detect-python-command/scripts/detect-python.sh
# 詳細モード（判別過程を表示）
skills/detect-python-command/scripts/detect-python.sh --verbose
判別ロジック
以下の優先順位で判別します：
| 優先度 | 条件 | 使用するコマンド |
|---|---|---|
| 1 | pyproject.toml が存在 かつ uv がインストール済み |
uv run python |
| 2 | .venv/bin/python が存在 |
.venv/bin/python |
| 3 | python コマンドが存在 |
python |
| 4 | python3 コマンドが存在 |
python3 |
| 5 | いずれも該当しない | エラー終了 |
例
他のスキルからの参照
# mixseek-config-validate からの使用例
skills/detect-python-command/scripts/run-python.sh \
skills/mixseek-config-validate/scripts/validate-config.py config.toml --type team
環境情報の確認
User: このプロジェクトでどのPythonコマンドを使えばいい？
Agent: 判別スクリプトを実行します...
$ skills/detect-python-command/scripts/detect-python.sh --verbose
出力:
Detecting Python command...
pyproject.toml: found
uv: installed (0.9.24)
Result: uv run python
このプロジェクトでは `uv run python` が使用されます。
スクリプト実行時は run-python.sh を使用してください。
スクリプト一覧
| スクリプト | 用途 |
|---|---|
run-python.sh |
Pythonスクリプトを適切なコマンドで実行（推奨） |
detect-python.sh |
使用されるコマンドを確認（情報提供用） |
トラブルシューティング
Pythonが見つからない
Error: No Python interpreter found
解決方法:
- Python をインストール
- または
uv syncを実行して仮想環境を作成
スクリプトが見つからない
Error: Script not found: script.py
解決方法:
- スクリプトのパスが正しいか確認
- 相対パスの場合、カレントディレクトリを確認
uv が見つからない
uv がインストールされていない場合、フォールバックとして .venv/bin/python または システムの python3 を使用します。
uv のインストールが必要な場合は、ユーザーに確認してから公式ドキュメント（https://docs.astral.sh/uv/）を案内してください。
関連スキル
このスキルは以下のスキルから参照されます：
mixseek-config-validate- 設定ファイルの検証