<!-- security-allowlist: curl-pipe-bash -->

環境セットアップガイド

概要

開発環境を一から完全にセットアップするのを開発者に手助けします。このスキルは、ツールのインストール、依存関係の設定、環境変数の設定、セットアップが正しく機能することの確認について、段階的なガイダンスを提供します。

このスキルを使用する時

• 新しいプロジェクトを開始して開発環境をセットアップする必要があるとき
• プロジェクトに新しいチームメンバーをオンボーディングするとき
• 新しいマシンまたはオペレーティングシステムに切り替えるとき
• 環境関連の問題をトラブルシューティングするとき
• プロジェクトのセットアップ手順を文書化するとき
• 開発環境のドキュメントを作成するとき

仕組み

ステップ 1: 要件を特定する

インストール対象を決定するのを手助けします:

• プログラミング言語とバージョン (Node.js、Python、Go など)
• パッケージマネージャー (npm、pip、cargo など)
• データベースシステム (PostgreSQL、MongoDB、Redis など)
• 開発ツール (Git、Docker、IDE拡張機能など)
• 環境変数と設定ファイル

ステップ 2: 現在のセットアップを確認する

何かをインストールする前に、既にインストールされているものを確認するのを手助けします:

# インストールされているツールのバージョンを確認
node --version
python --version
git --version
docker --version

ステップ 3: インストール手順を提供する

プラットフォーム固有のインストールコマンドを提供します:

• macOS: Homebrewを使用
• Linux: apt、yum、またはパッケージマネージャーを使用
• Windows: Chocolatey、Scoop、または直接インストーラーを使用

ステップ 4: 環境を設定する

以下のセットアップを支援します:

• 環境変数 (.envファイル)
• 設定ファイル (.gitconfig、.npmrcなど)
• IDE設定 (VS Code、IntelliJなど)
• シェル設定 (.bashrc、.zshrcなど)

ステップ 5: インストールを検証する

すべてが機能することを確認する検証ステップを提供します:

• バージョン確認を実行
• 基本的なコマンドをテスト
• データベース接続を確認
• 環境変数が読み込まれていることを確認

例

例 1: Node.jsプロジェクトのセットアップ

## Node.js開発環境のセットアップ

### 前提条件
- macOS、Linux、またはWindows
- ターミナル/コマンドプロンプトへのアクセス
- インターネット接続

### ステップ 1: Node.jsをインストール

**macOS (Homebrewを使用):**
\`\`\`bash
# Homebrewをインストール (未インストールの場合)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Node.jsをインストール
brew install node
\`\`\`

**Linux (Ubuntu/Debian):**
\`\`\`bash
# パッケージリストを更新
sudo apt update

# Node.jsとnpmをインストール
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
\`\`\`

**Windows (Chocolateyを使用):**
\`\`\`powershell
# Chocolateyをインストール (未インストールの場合)
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# Node.jsをインストール
choco install nodejs
\`\`\`

### ステップ 2: インストールを確認

\`\`\`bash
node --version  # v20.x.x以上が表示される
npm --version   # 10.x.x以上が表示される
\`\`\`

### ステップ 3: プロジェクト依存関係をインストール

\`\`\`bash
# リポジトリをクローン
git clone https://github.com/your-repo/project.git
cd project

# 依存関係をインストール
npm install
\`\`\`

### ステップ 4: 環境変数を設定

\`.env\`ファイルを作成します:
\`\`\`bash
# サンプル環境ファイルをコピー
cp .env.example .env

# エディタで編集
nano .env
\`\`\`

\`.env\`ファイルの内容例:
\`\`\`
NODE_ENV=development
PORT=3000
DATABASE_URL=postgresql://localhost:5432/mydb
API_KEY=your-api-key-here
\`\`\`

### ステップ 5: プロジェクトを実行

\`\`\`bash
# 開発サーバーを起動
npm run dev

# 表示: Server running on http://localhost:3000
\`\`\`

### トラブルシューティング

**問題:** "node: command not found"
**解決策:** ターミナルを再起動するか、\`source ~/.bashrc\`(Linux)または\`source ~/.zshrc\`(macOS)を実行してください

**問題:** "Permission denied"エラー
**解決策:** npmでsudoを使用しないでください。権限を修正します:
\`\`\`bash
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
\`\`\`

例 2: Pythonプロジェクトのセットアップ

## Python開発環境のセットアップ

### ステップ 1: Pythonをインストール

**macOS:**
\`\`\`bash
brew install python@3.11
\`\`\`

**Linux:**
\`\`\`bash
sudo apt update
sudo apt install python3.11 python3.11-venv python3-pip
\`\`\`

**Windows:**
\`\`\`powershell
choco install python --version=3.11
\`\`\`

### ステップ 2: インストールを確認

\`\`\`bash
python3 --version  # Python 3.11.xが表示される
pip3 --version     # pip 23.x.xが表示される
\`\`\`

### ステップ 3: 仮想環境を作成

\`\`\`bash
# プロジェクトディレクトリに移動
cd my-project

# 仮想環境を作成
python3 -m venv venv

# 仮想環境を有効化
# macOS/Linux:
source venv/bin/activate

# Windows:
venv\Scripts\activate
\`\`\`

### ステップ 4: 依存関係をインストール

\`\`\`bash
# requirements.txtからインストール
pip install -r requirements.txt

# またはパッケージを個別にインストール
pip install flask sqlalchemy python-dotenv
\`\`\`

### ステップ 5: 環境変数を設定

\`.env\`ファイルを作成します:
\`\`\`
FLASK_APP=app.py
FLASK_ENV=development
DATABASE_URL=sqlite:///app.db
SECRET_KEY=your-secret-key-here
\`\`\`

### ステップ 6: アプリケーションを実行

\`\`\`bash
# Flask appを実行
flask run

# 表示: Running on http://127.0.0.1:5000
\`\`\`

例 3: Docker開発環境

## Docker開発環境のセットアップ

### ステップ 1: Dockerをインストール

**macOS:**
\`\`\`bash
brew install --cask docker
# またはdocker.comからDocker Desktopをダウンロード
\`\`\`

**Linux:**
\`\`\`bash
# Dockerをインストール
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# ユーザーをdockerグループに追加
sudo usermod -aG docker $USER
newgrp docker
\`\`\`

**Windows:**
docker.comからDocker Desktopをダウンロード

### ステップ 2: インストールを確認

\`\`\`bash
docker --version        # Docker version 24.x.xが表示される
docker-compose --version # Docker Compose version 2.x.xが表示される
\`\`\`

### ステップ 3: docker-compose.ymlを作成

\`\`\`yaml
version: '3.8'

services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=development
      - DATABASE_URL=postgresql://postgres:password@db:5432/mydb
    volumes:
      - .:/app
      - /app/node_modules
    depends_on:
      - db

  db:
    image: postgres:15
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=mydb
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:
\`\`\`

### ステップ 4: サービスを開始

\`\`\`bash
# コンテナをビルドして起動
docker-compose up -d

# ログを表示
docker-compose logs -f

# サービスを停止
docker-compose down
\`\`\`

### ステップ 5: サービスを確認

\`\`\`bash
# 実行中のコンテナを確認
docker ps

# データベース接続をテスト
docker-compose exec db psql -U postgres -d mydb
\`\`\`

ベストプラクティス

✅ このようにしてください

• すべてを文書化する - セットアップ手順を明確に記述する
• バージョンマネージャーを使用する - Node用はnvm、Python用はpyenv
• .env.exampleを作成する - 必要な環境変数を表示する
• クリーンシステムでテストする - 指示が一から機能することを確認する
• トラブルシューティングを含める - よくある問題と解決策を文書化する
• Dockerを使用する - マシン間で一貫した環境を提供する
• バージョンを固定する - パッケージファイルで正確なバージョンを指定する
• セットアップを自動化する - 可能な限りセットアップスクリプトを作成する
• 前提条件を確認する - 開始する前に必要なツールをリストアップする
• 検証ステップを提供する - セットアップが機能することをユーザーが確認できるようにする

❌ このようにしないでください

• ツールがインストールされていると仮定しない - 常に確認し、インストール手順を提供する
• 環境変数をスキップしない - 必要なすべての変数を文書化する
• npmでsudoを使用しない - 代わりに権限を修正する
• プラットフォームの違いを忘れない - OS固有の手順を提供する
• 検証を忘れない - 常にテストステップを含める
• グローバルインストールを使用しない - ローカル/仮想環境を推奨する
• エラーを無視しない - よくあるエラーへの対処方法を文書化する
• データベースセットアップをスキップしない - データベース初期化ステップを含める

よくある落とし穴

問題: インストール後に「コマンドが見つかりません」

症状: ツールをインストールしたがターミナルで認識されない 解決策:

• ターミナルを再起動するかシェル設定をソースする
• PATH環境変数を確認する
• インストール位置を確認する

# PATHを確認
echo $PATH

# PATHに追加 (例)
export PATH="/usr/local/bin:$PATH"

問題: npm/pipの権限エラー

症状: "EACCES"または"Permission denied"エラー 解決策:

• sudoを使用しない
• npm権限を修正するか、nvmを使用する
• Python用の仮想環境を使用する

# npm権限を修正
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

問題: ポートが既に使用中

症状: "Port 3000 is already in use" 解決策:

• ポートを使用しているプロセスを見つけて強制終了する
• 別のポートを使用する

# ポート3000を使用しているプロセスを見つける
lsof -i :3000

# プロセスを強制終了
kill -9 <PID>

# または別のポートを使用
PORT=3001 npm start

問題: データベース接続に失敗する

症状: "Connection refused"または"Authentication failed" 解決策:

• データベースが実行中であることを確認する
• 接続文字列を確認する
• 認証情報を確認する

# PostgreSQLが実行中か確認
sudo systemctl status postgresql

# 接続をテスト
psql -h localhost -U postgres -d mydb

セットアップスクリプトテンプレート

セットアップを自動化するためにsetup.shスクリプトを作成します:

#!/bin/bash

echo "🚀 開発環境をセットアップしています..."

# 前提条件を確認
command -v node >/dev/null 2>&1 || { echo "❌ Node.jsがインストールされていません"; exit 1; }
command -v git >/dev/null 2>&1 || { echo "❌ Gitがインストールされていません"; exit 1; }

echo "✅ 前提条件の確認が完了しました"

# 依存関係をインストール
echo "📦 依存関係をインストール中..."
npm install

# 環境ファイルをコピー
if [ ! -f .env ]; then
    echo "📝 .envファイルを作成中..."
    cp .env.example .env
    echo "⚠️  .envを編集してください"
fi

# データベースマイグレーションを実行
echo "🗄️  データベースマイグレーションを実行中..."
npm run migrate

# セットアップを検証
echo "🔍 セットアップを検証中..."
npm run test:setup

echo "✅ セットアップが完了しました。'npm run dev'を実行して開始してください"

関連スキル

• @brainstorming - セットアップ前に環境要件を計画する
• @systematic-debugging - 環境の問題をデバッグする
• @doc-coauthoring - セットアップドキュメントを作成する
• @git-pushing - Git設定をセットアップする

追加リソース

• Node.js インストールガイド
• Python 仮想環境
• Docker ドキュメント
• Homebrew (macOS)
• Chocolatey (Windows)
• nvm (Node Version Manager)
• pyenv (Python Version Manager)

---

プロのヒント: setup.shまたはsetup.ps1スクリプトを作成してセットアップ全体を自動化します。クリーンシステムで動作することを確認してください!

制限事項

• 上記で説明されたスコープに明確に一致する場合にのみこのスキルを使用してください。
• 出力を環境固有の検証、テスト、または専門家による審査の代替として扱わないでください。
• 必要な入力、権限、安全な境界、または成功基準が不明な場合は中止して説明を求めてください。