mcpField
E
environment-triage

environment-triage

github.com/parcadei开发3.9k480 次安装39 周前更新
代码仓库

关于 environment-triage

environment-triage 是排查 Python 安装异常的技能，帮助使用 uv 或虚拟环境的开发者确认实际解释器，并据此修正版本配置。

主要功能

  1. 01检查 uv 实际使用的 Python 版本
  2. 02查看 .python-version 配置
  3. 03确认软件包是否已安装
  4. 04修正解释器版本并重建环境

适用场景

  1. 01uv sync 后依赖缺失
  2. 02pip install 后导入失败
  3. 03可选依赖受 Python 版本限制

安装

复制下面的命令，在终端中运行。

$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