首页龙虾技能列表 › python — Python — Python 环境助手

python — Python — Python 环境助手

v1.0.0

使用 Python 进行实用的项目设置、依赖安装、脚本执行和环境故障排除,具有安全默认设置。适用于涉及 pyproject.toml、requirements.txt、虚拟环境设置、运行 Python 脚本/测试、包基本操作或修复常见 Python 错误(解释器不匹配、pip 解析器冲突、缺少模块、构建失败)等任务。

0· 812·4 当前·4 累计
by @jvy·MIT-0
下载技能包
License
MIT-0
最后更新
2026/3/14
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
该技能的要求、指令和包含的辅助脚本与其管理 Python 虚拟环境和安装包的声明目的相符;所请求或安装的内容看似合理、无不相关内容。
评估建议
该技能似乎做了它宣称的所有事情:创建/修复虚拟环境和使用包含的 python_env_tool.py 辅助脚本安装包。安装或运行前:1) 查看您计划安装的 requirements.txt/pyproject.toml - 包安装脚本可以运行代码;仅从可信来源安装;2) 注意 bootstrap --recreate 选项将删除现有的 venv 目录;3) 该技能将调用 pip 从网络(PyPI)获取包;如果处理敏感数据,请考虑在隔离环境中运行;4) 如果您不希望代理自动调用该技能,请在代理设置中禁用隐式/自动调用。总体而言,该技能与其声明的目的相符、合理。...
详细分析 ▾
用途与能力
名称/描述(Python 环境助手)与所需二进制文件(python3, pip/pip3)匹配,brew 安装的 python,以及捆绑的 python_env_tool.py 脚本,该脚本实现了 venv 启动、安装和医生命令。
指令范围
SKILL.md 指示运行捆绑的辅助脚本和标准 Python 工具(venv, pip, pytest)。它不请求读取无关文件或秘密。指导明确推荐安全实践(检查依赖文件,偏好 venvs)。辅助脚本运行子进程以执行预期的包安装和 venv 创建。
安装机制
安装元数据使用标准 brew 公式 'python'(及其 apt 替代品)提供 python3/pip。这是该目的的预期、低风险安装机制。
凭证需求
未请求环境变量或凭证(合理)。一个操作注意事项:该技能从外部源(pip/PyPI)安装包,这些包可以在安装时执行任意代码——这对于包安装助手是预期的,但在安装不受信任的要求之前,用户应考虑此操作风险。
持久化与权限
always:false,无系统范围的配置更改请求。agents/openai.yaml 允许隐式/自动调用(allow_implicit_invocation: true),这对于技能是正常的;没有其他广泛的权限或对其他技能的修改。
安全有层次,运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发,无需署名。

运行时依赖

无特殊依赖

版本

latestv1.0.02026/3/14

["发布 'python' 技能,重点是安全项目设置和可复制的 Python 工作流。","添加了标准工作流,用于创建虚拟环境、安装依赖项和执行脚本,使用捆绑的辅助脚本。","强调了避免解释器不匹配和不安全的全局安装的最佳实践。","提供了常见 Python 错误的故障排除提示。","包含新辅助脚本:`scripts/python_env_tool.py` 用于自动化环境管理。"]

● 无害

安装命令 点击复制

官方npx clawhub@latest install python3
镜像加速npx clawhub@latest install python3 --registry https://cn.clawhub-mirror.com

技能文档

使用此技能保持 Python 工作流在本地/开发 shell 中可复制和低风险。

安全默认值

  • 优先使用项目本地虚拟环境(.venv)而非全局安装。
  • 优先使用 python3 -m pip ... 避免解释器和 pip 不匹配。
  • 安装前检查依赖文件(requirements*.txtpyproject.toml)。
  • 避免执行未知的 setup hooks 或随机安装脚本,无用户批准。

标准工作流

  • 检测当前环境:
python3 --version
python3 -c "import sys; print(sys.executable)"
{baseDir}/scripts/python_env_tool.py doctor
  • 创建或刷新 venv:
{baseDir}/scripts/python_env_tool.py bootstrap --venv .venv --requirements requirements.txt
  • 安装项目包(如果存在 pyproject.toml):
{baseDir}/scripts/python_env_tool.py install --venv .venv --editable
  • 从 venv 解释器运行测试/工具:
.venv/bin/python -m pytest -q
.venv/bin/python -m pip list --outdated

任务配方

# 安装特定包到 venv
{baseDir}/scripts/python_env_tool.py install --venv .venv --package requests --package pydantic
# 从 requirements 文件安装
{baseDir}/scripts/python_env_tool.py install --venv .venv --requirements requirements-dev.txt
# 从头重建损坏的 venv
{baseDir}/scripts/python_env_tool.py bootstrap --venv .venv --recreate --requirements requirements.txt

故障排除规则

  • ModuleNotFoundError:验证命令是否通过 .venv/bin/python 运行,然后重新安装依赖项。
  • externally-managed-environment:停止全局安装尝试;使用 venv。
  • 本地依赖构建失败:升级 pip setuptools wheel,然后重试。
  • 多个 Python 版本:始终打印并确认 sys.executable 之前进行修复。

捆绑辅助脚本

使用辅助脚本进行可重复的环境设置和诊断:
{baseDir}/scripts/python_env_tool.py --help
{baseDir}/scripts/python_env_tool.py doctor

数据来源:ClawHub ↗ · 中文优化:龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险,如需更匹配、更安全的方案,建议联系付费定制

了解定制服务