detect-python-command

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Python コマンド判別・実行

Python 命令检测与执行

概要

現在の環境で使用すべき適切なPythonコマンドを判別し、スクリプトを実行します。プロジェクトの設定（pyproject.toml、.venv、uv）を確認し、最適な方法で実行します。

判断当前环境中应使用的合适Python命令，并执行脚本。会检查项目配置（pyproject.toml、.venv、uv），以最优方式执行脚本。

前提条件

なし（環境を自動検出します）

无（会自动检测环境）

使用方法

方法1: ラッパースクリプトで実行（推奨）

方法1: 通过包装脚本执行（推荐）

run-python.sh

を使用して、Pythonスクリプトを直接実行します：

bash

skills/detect-python-command/scripts/run-python.sh script.py [args...]

例:

bash

undefined

使用

run-python.sh

直接执行Python脚本：

bash

skills/detect-python-command/scripts/run-python.sh script.py [args...]

示例:

bash

undefined

設定ファイルの検証

验证配置文件

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

undefined

skills/detect-python-command/scripts/run-python.sh script.py --verbose --output result.json

undefined

方法2: コマンドの確認のみ

方法2: 仅确认命令

使用されるPythonコマンドを確認したい場合：

bash

undefined

若只需确认将使用的Python命令：

bash

undefined

標準モード（コマンド名のみ）

标准模式（仅显示命令名）

skills/detect-python-command/scripts/detect-python.sh

詳細モード（判別過程を表示）

详细模式（显示判断过程）

skills/detect-python-command/scripts/detect-python.sh --verbose

undefined

skills/detect-python-command/scripts/detect-python.sh --verbose

undefined

判別ロジック

判断逻辑

以下の優先順位で判別します：

優先度	条件	使用するコマンド
1	`pyproject.toml` が存在かつ `uv` がインストール済み	`uv run python`
2	`.venv/bin/python` が存在	`.venv/bin/python`
3	`python` コマンドが存在	`python`
4	`python3` コマンドが存在	`python3`
5	いずれも該当しない	エラー終了

将按照以下优先级进行判断：

优先级	条件	使用的命令
1	存在 `pyproject.toml` 且已安装 `uv`	`uv run python`
2	存在 `.venv/bin/python`	`.venv/bin/python`
3	存在 `python` 命令	`python`
4	存在 `python3` 命令	`python3`
5	均不满足	报错退出

例

示例

他のスキルからの参照

从其他技能调用

bash

undefined

bash

undefined

mixseek-config-validate からの使用例

mixseek-config-validate的使用示例

skills/detect-python-command/scripts/run-python.sh
skills/mixseek-config-validate/scripts/validate-config.py config.toml --type team

undefined

skills/detect-python-command/scripts/run-python.sh
skills/mixseek-config-validate/scripts/validate-config.py config.toml --type team

undefined

環境情報の確認

确认环境信息

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 を使用してください。

用户：这个项目应该使用哪个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`	使用されるコマンドを確認（情報提供用）

脚本	用途
`run-python.sh`	使用合适的命令执行Python脚本（推荐）
`detect-python.sh`	确认将使用的命令（仅用于信息查询）

トラブルシューティング

故障排除

Pythonが見つからない

找不到Python

Error: No Python interpreter found

解決方法:

Python をインストール
または
```
uv sync
```
を実行して仮想環境を作成

Error: No Python interpreter found

解决方法:

安装Python
或执行
```
uv sync
```
创建虚拟环境

スクリプトが見つからない

找不到脚本

Error: Script not found: script.py

解決方法:

スクリプトのパスが正しいか確認
相対パスの場合、カレントディレクトリを確認

Error: Script not found: script.py

解决方法:

确认脚本路径是否正确
若使用相对路径，确认当前目录是否正确

uv が見つからない

找不到uv

uv がインストールされていない場合、フォールバックとして

.venv/bin/python

またはシステムの

python3

を使用します。

uv のインストールが必要な場合は、ユーザーに確認してから公式ドキュメント（https://docs.astral.sh/uv/）を案内してください。

若未安装uv，将自动回退使用

.venv/bin/python

或系统的

python3

。若需要安装uv，请先确认用户需求，再引导其查看官方文档（https://docs.astral.sh/uv/）。

相关技能

このスキルは以下のスキルから参照されます：

```
mixseek-config-validate
```
- 設定ファイルの検証

本技能被以下技能引用：

```
mixseek-config-validate
```
- 配置文件验证

優先度

条件

使用するコマンド

pyproject.toml

が存在かつ

uv

がインストール済み

uv run python

.venv/bin/python

が存在

.venv/bin/python

python

コマンドが存在

python

python3

コマンドが存在

python3

いずれも該当しない

エラー終了

优先级

条件

使用的命令

存在

pyproject.toml

且已安装

uv

uv run python

存在

.venv/bin/python

.venv/bin/python

存在

python

命令

python

存在

python3

命令

python3

均不满足

报错退出

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 を使用してください。

用户：这个项目应该使用哪个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

使用されるコマンドを確認（情報提供用）

脚本

用途

run-python.sh

使用合适的命令执行Python脚本（推荐）

detect-python.sh

确认将使用的命令（仅用于信息查询）

detect-python-command

Original

Translation

Python コマンド判別・実行

Python 命令检测与执行

概要

概要

前提条件

前提条件

使用方法

使用方法

方法1: ラッパースクリプトで実行（推奨）

方法1: 通过包装脚本执行（推荐）

設定ファイルの検証

验证配置文件

引数付きで実行

带参数执行

方法2: コマンドの確認のみ

方法2: 仅确认命令

標準モード（コマンド名のみ）

标准模式（仅显示命令名）

詳細モード（判別過程を表示）

详细模式（显示判断过程）

判別ロジック

判断逻辑

例

示例

他のスキルからの参照

从其他技能调用

mixseek-config-validate からの使用例

mixseek-config-validate的使用示例

環境情報の確認

确认环境信息

スクリプト一覧

脚本列表

トラブルシューティング

故障排除

Pythonが見つからない

找不到Python

スクリプトが見つからない

找不到脚本

uv が見つからない

找不到uv

関連スキル

相关技能

detect-python-command

Original

Translation

Python コマンド判別・実行

Python 命令检测与执行

概要

概要

前提条件

前提条件

使用方法

使用方法

方法1: ラッパースクリプトで実行（推奨）

方法1: 通过包装脚本执行（推荐）

設定ファイルの検証

验证配置文件

引数付きで実行

带参数执行

方法2: コマンドの確認のみ

方法2: 仅确认命令

標準モード（コマンド名のみ）

标准模式（仅显示命令名）

詳細モード（判別過程を表示）

详细模式（显示判断过程）

判別ロジック

判断逻辑

例

示例

他のスキルからの参照

从其他技能调用

mixseek-config-validate からの使用例

mixseek-config-validate的使用示例

環境情報の確認

确认环境信息

スクリプト一覧

脚本列表