mcpField
E
environment-triage

environment-triage

github.com/parcadei開発3.9k480 回インストール39 週間前に更新
リポジトリ

environment-triage について

environment-triageは、Pythonのインストール問題を調べる開発者向けのスキルです。uvや仮想環境が実際に選択したインタープリターを確認してから、原因を調査します。

主な機能

  1. 01uvが選択したPythonバージョンの確認
  2. 02.python-version設定の確認
  3. 03パッケージのインストール確認
  4. 04バージョン変更と環境の再構築

活用シーン

  1. 01uv sync後に依存パッケージが見つからない場合
  2. 02pip install後にインポートできない場合
  3. 03Pythonバージョン条件で任意依存が除外される場合

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill environment-triage

インストール後、Claude Code で/environment-triageを入力して読み込まれたか確認します。

詳細

環境の切り分け

uv sync や pip install の動作が予想と異なる場合は、実際に使われているインタープリターを確認してください。

パターン

uv/venv が別のインタープリターを選択している場合、システムの Python は判断基準になりません。

推奨事項

# What uv ACTUALLY uses
uv run python --version

# What's pinned (this controls uv)
cat .python-version

# Confirm package is installed
uv pip show <package>

# Confirm import works in uv context
uv run python -c "import <package>; print(<package>.__version__)"

よくある修正方法

オプションの依存関係で Python 3.12 以降が必要なのに、.python-version が 3.11 の場合：

echo "3.13" > .python-version
rm -rf .venv && uv venv && uv sync --all-extras

禁止事項

  • uv の使用中に python3 --version を信用する
  • インポートを確認せずに、インストールが成功したと思い込む
  • インタープリターのバージョンを確認する前に、さらにデバッグする

セッションの情報源

  • 2243c067：python_version >= 3.12 マーカーにより symbolica-agentica がスキップされていましたが、uv は 3.11 を使用していました
  • 4784f390：agentica のインポートエラーは、誤ったインタープリターが原因と判明しました

コメント

Markdown 対応