메뉴
Python 环境管理。venv 创建、pip freeze/install、pyenv 版本管理、poetry 基础、常见坑。涉及 Python 虚拟环境或依赖管理时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
生成或审计模块的 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.
SOC 직업 분류 기준
| 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，谨慎处理 |