管理 Python 项目环境,支持虚拟环境创建、依赖安装与环境诊断
Python 环境工具基础版是一项面向实际任务的技能,主要用于本工具是 开发工具 领域的 FREE 版本 AI Skill,专为个人用户与轻量级场景设计;通过自然语言指令驱动 AI Agent 执行任务,提供核心功能与简洁易用的操作体验;
它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
本工具是 开发工具 领域的 FREE 版本 AI Skill,专为个人用户与轻量级场景设计。通过自然语言指令驱动 AI Agent 执行任务,提供核心功能与简洁易用的操作体验。
FREE 版本与 PRO 版本完全兼容,可在需要时升级至 PRO 版本获取高级功能、批量操作与团队协同能力。
| 维度 | FREE 版本 | PRO 版本 |
|---|---|---|
| 目标用户 | 个人用户 | 企业团队 |
| 功能范围 | 核心功能 | 全部功能 |
| 批量操作 | 不支持 | 支持 |
| 团队协作 | 不支持 | 支持 |
| 技术支持 | 社区支持 | 优先响应 |
| 数据分析 | 基础统计 | 高级分析 |
FREE 版本提供以下能力:
检测当前 Python 环境与解释器路径
输入: 用户提供检测当前 Python 环境与所需的指令和必要参数。 处理: 按照skill规范执行检测当前 Python 环境与操作,遵循单一意图原则。 输出: 返回检测当前 Python 环境与的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作创建或刷新项目虚拟环境
输入: 用户提供创建或刷新项目虚拟环境所需的指令和必要参数。 处理: 按照skill规范执行创建或刷新项目虚拟环境操作,遵循单一意图原则。 输出: 返回创建或刷新项目虚拟环境的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作安装项目依赖与开发包
输入: 用户提供安装项目依赖与开发包所需的指令和必要参数。 处理: 按照skill规范执行安装项目依赖与开发包操作,遵循单一意图原则。 输出: 返回安装项目依赖与开发包的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作运行测试与工具检查
输入: 用户提供运行测试与工具检查所需的指令和必要参数。 处理: 按照skill规范执行运行测试与工具检查操作,遵循单一意图原则。 输出: 返回运行测试与工具检查的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作环境诊断与故障排查
输入: 用户提供环境诊断与故障排查所需的指令和必要参数。 处理: 按照skill规范执行环境诊断与故障排查操作,遵循单一意图原则。 输出: 返回环境诊断与故障排查的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作本版本提供 5 项核心能力,覆盖 开发工具 的常见使用场景。如需批量操作、团队协作、数据分析等高级功能,可升级至 PRO 版本。
FREE 版本核心功能清单:
PRO 版本扩展功能预览:
输入: 用户提供功能详情所需的指令和必要参数。
处理: 按照skill规范执行功能详情操作,遵循单一意图原则。
输出: 返回功能详情的执行结果,包含操作状态和输出数据。
技术参数:使用input_params和output_format参数控制执行行为,支持json/text/csv输出格式。
能力覆盖范围:本skill的核心能力覆盖以下场景关键词:项目环境、支持虚拟环境创建、依赖安装与环境诊、开发工具领域的专、辅助工具、提供核心基础功能等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。
创建虚拟环境并安装依赖
# 检测环境 python3 --version python3 -c "import sys; print(sys.executable)" # 创建虚拟环境 python3 -m venv .venv # 依赖说明 .venv/bin/pip install -r requirements.txt
排查 ModuleNotFoundError 等常见问题
# 诊断步骤 1. 确认使用 .venv/bin/python 2. 检查依赖是否已安装 3. 检查 PYTHONPATH 设置 4. 重新安装依赖 .venv/bin/python -m pip list --outdated
以下场景Python 环境工具基础版不适合处理:
需要数据分析、报表生成、统计洞察、数据可视化时使用。不适用于非本工具能力范围的需求。
确保已安装并配置好 AI Agent 环境(Claude Code / Cursor / Codex / Gemini CLI 等),本 Skill 通过 SKILL.md 指令驱动 Agent 执行任务。
系统要求:
# 标准工作流 python3 -m venv .venv source .venv/bin/activate # Linux/macOS # .venvScriptsactivate # Windows python3 -m pip install -r requirements.txt python3 -m pip install -e . # 安装项目包
配置完成后,可通过以下方式验证是否正常工作:
# 验证环境变量是否设置
echo "配置检查:"
env | grep -E "API|KEY|TOKEN|SECRET" | sed "s/=.*/=***/" # Linux/macOS
# 或 PowerShell
# Get-ChildItem Env: | Where-Object {$_.Name -match "API|KEY|TOKEN"} | Format-Table
在 AI Agent 对话中描述你的需求,Agent 会根据本 Skill 的指令自动执行对应操作。
请帮我初始化项目环境
Agent 将自动:
-Table: 命令参数,用于指定操作选项-E: 命令参数,用于指定操作选项-ChildItem: 命令参数,用于指定操作选项-Object: 命令参数,用于指定操作选项# 标准工作流 python3 -m venv .venv source .venv/bin/activate # Linux/macOS # .venvScriptsactivate # Windows python3 -m pip install -r requirements.txt python3 -m pip install -e . # 安装项目包
{
"edition": "free",
"auto_retry": false,
"max_concurrent": 1,
"log_level": "info",
"cache_enabled": true,
"timeout": 30
}
FREE 配置项说明:
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| auto_retry | bool | false | 失败后自动重试 |
| max_concurrent | int | 1 | 最大并发数(FREE 限制为1) |
| log_level | string | info | 日志级别 |
| cache_enabled | bool | true | 启用结果缓存 |
| timeout | int | 30 | 操作超时时间(秒) |
A: 确认命令通过 .venv/bin/python 执行,然后重新安装依赖。
A: 停止全局安装尝试,使用虚拟环境管理依赖。
A: 升级到 PRO 版本非常简单:
A: FREE 版本主要限制:
A: FREE 版本所有数据本地存储,不上传云端,确保隐私安全。建议定期备份配置文件与数据目录。
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |
| curl | CLI 工具 | 推荐 | 系统自带或包管理器安装 |
| jq | JSON 处理 | 推荐 | apt install jq / brew install jq |
| Python 3.8+ | 运行时 | 视需求 | python.org 下载 |
| Node.js 18+ | 运行时 | 视需求 | nodejs.org 下载 |
FREE 版本支持单一 API Key 配置,满足个人使用需求:
版本信息
| 项目 | 值 |
|---|---|
| 版本号 | 1.0.0 |
| 版本类型 | FREE |
| 许可证 | MIT |
| 兼容性 | 可升级至 PRO 版本 |
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
相关专题
热门下载
相关下载
精品课程
共0课时 | 0人学习
共0课时 | 0人学习
共0课时 | 0人学习
最新文章