Menu
Python 环境管理。venv 创建、pip freeze/install、pyenv 版本管理、poetry 基础、常见坑。涉及 Python 虚拟环境或依赖管理时使用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
生成或审计模块的 SPEC.md。使用场景：用户要求"给 XX 模块写 spec"、"审计所有 spec"、"检查 spec 是否过期"。
Automates SailFish release workflow: fix build/type errors, update CHANGELOG (EN + CN), run npm version with pre/post hooks. Use when the user asks to release, 发版, 发布, bump version, or update changelog.
后端代码修改后，通过 CLI 测试验证功能正确性。使用场景：修改了 electron/services/ 下的代码需要测试、准备提交代码前跑回归、用户要求"跑测试"/"验证一下"。
完成新功能开发或较大修改后，使用本机 Claude CLI 进行代码审查。
使用 ts-morph 静态分析工具查询代码结构（类层次、方法签名、引用、依赖等），替代手动读源码。使用场景：需要了解类的方法/属性、继承链、符号引用、文件结构、依赖关系时。
When committing or staging changes, only include files related to the current task or conversation; do not stage or commit unrelated modifications. Use when the user asks to commit, stage, 提交, or when preparing to run git add/commit.
| name | python-venv |
| description | Python 环境管理。venv 创建、pip freeze/install、pyenv 版本管理、poetry 基础、常见坑。涉及 Python 虚拟环境或依赖管理时使用。 |
| version | 1.0.0 |
python3 -m venv .venv
source .venv/bin/activate # Linux/macOS
# .venv\Scripts\activate # Windows
deactivate
指定解释器：python3.11 -m venv .venv
pip install -r requirements.txt
pip freeze > requirements.txt
pip list --outdated
推荐：用 pip freeze 前先激活对应 venv，避免混入全局包。
pyenv install 3.11.6
pyenv local 3.11.6 # 当前目录
pyenv global 3.11.6 # 全局默认
配合 venv：pyenv exec python -m venv .venv
poetry init
poetry add requests
poetry install
poetry run python main.py
导出 requirements：poetry export -f requirements.txt --without-hashes > requirements.txt
| 问题 | 处理 |
|---|---|
ModuleNotFoundError | 确认已激活 venv，且包安装在当前环境 |
| 权限错误 | 避免 sudo pip，用 venv 或 --user |
| 多 Python 冲突 | 用 python -m venv、python -m pip 明确解释器 |
| lock 文件冲突 | poetry：删 poetry.lock 重跑 poetry install，谨慎处理 |