[スキル名] virtual-environment

仮想環境管理

仮想環境が必要なプロジェクトで、環境をチェックし、生成するスキルです。

このスキルが有効になるタイミング

次のファイルが発見された場合、仮想環境の必要性をチェックします。

検出ワークフロー

1. プロジェクトタイプの検出

# プロジェクトルートで実行
ls -la | grep -E "requirements|pyproject|Pipfile|package\.json|Gemfile|go\.mod"

2. 仮想環境の存在確認

# Python venv の確認
ls -la | grep -E "^d.*(venv|\.venv|env|\.env)$"

# Python - アクティベート状況
echo $VIRTUAL_ENV

# Node - node_modules の確認
ls -d node_modules 2>/dev/null

Python プロジェクト

venv (標準ライブラリ)

# 仮想環境の作成
python -m venv .venv

# アクティベート (macOS/Linux)
source .venv/bin/activate

# アクティベート (Windows)
.venv\Scripts\activate

# 依存関係のインストール
pip install -r requirements.txt

# 非アクティベート
deactivate

Poetry (推奨)

# Poetry のインストール確認
poetry --version

# 仮想環境の自動作成 + 依存関係のインストール
poetry install

# 仮想環境内で実行
poetry run python script.py

# シェルへの入室
poetry shell

Pipenv

# 仮想環境の作成 + 依存関係のインストール
pipenv install

# 仮想環境シェルへの入室
pipenv shell

# 仮想環境内で実行
pipenv run python script.py

Conda

# 環境の作成
conda create -n myenv python=3.11

# アクティベート
conda activate myenv

# 依存関係のインストール
conda install --file requirements.txt
# または
pip install -r requirements.txt

Node.js プロジェクト

# 依存関係のインストール (node_modules が自動生成されます)
npm install
# または
yarn install
# または
pnpm install

# 確認
ls node_modules

ワークフロー: プロジェクト開始時

Python プロジェクト

1. プロジェクトタイプを確認
   - pyproject.toml → Poetry/PDM
   - Pipfile → Pipenv
   - requirements.txt → venv

2. 仮想環境の存在を確認
   ls -la | grep -E "venv|\.venv"

3. なければ作成
   python -m venv .venv

4. アクティベート + 依存関係のインストール
   source .venv/bin/activate
   pip install -r requirements.txt

Node.js プロジェクト

1. package.json を確認
   cat package.json | head -20

2. node_modules を確認
   ls node_modules 2>/dev/null

3. なければインストール
   npm install

命名規則

.gitignore 設定

# Python virtual environments
.venv/
venv/
env/
.env/

# Node
node_modules/

# Python cache
__pycache__/
*.pyc
.pytest_cache/

# IDE
.idea/
.vscode/

クイックリファレンス

Python プロジェクトの開始

# 1. 仮想環境のチェックと作成
[ -d ".venv" ] || python -m venv .venv

# 2. アクティベート
source .venv/bin/activate

# 3. 依存関係のインストール
pip install -r requirements.txt

Node.js プロジェクトの開始

# 1. node_modules のチェックとインストール
[ -d "node_modules" ] || npm install

トラブルシューティング

チェックリスト

プロジェクト開始前:

• [ ] プロジェクトタイプを確認 (Python/Node/その他)
• [ ] 仮想環境の存在を確認
• [ ] なければ作成
• [ ] アクティベート (Python)
• [ ] 依存関係をインストール
• [ ] .gitignore に仮想環境フォルダが含まれていることを確認