new-machine-setup スキル

新しいmacOSマシンのセットアップ手順を案内する。

セットアップ手順概要

Phase 1: macOS初期設定

1. システム環境設定

   • Apple IDでサインイン
   • iCloud設定
   • キーボード/トラックパッド設定

2. Xcode Command Line Tools

   bashCopy

   xcode-select --install
   

Phase 2: Homebrewインストール

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Phase 3: 基本ツールインストール

# Apple Silicon Macの場合
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# Git インストール
brew install git gh

Phase 4: SSH設定

# SSH鍵の生成（既存がない場合）
ssh-keygen -t ed25519 -C "your@email.com"

# ssh-agentに追加
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# GitHub CLI で認証
gh auth login

Phase 5: dotfilesクローン

# ghqでクローン（推奨）
brew install ghq
ghq get git@github.com:snkrheadz/laptop.git

# または直接クローン
git clone git@github.com:snkrheadz/laptop.git ~/ghq/github.com/snkrheadz/laptop

Phase 6: install.sh実行

cd ~/ghq/github.com/snkrheadz/laptop
./install.sh

これにより以下が実行される:

• バックアップ作成
• シンボリックリンク作成
• Homebrew パッケージインストール
• pre-commit フック設定
• auto-sync launchd設定
• mise ランタイムインストール

Phase 7: シェル再起動

exec zsh

Phase 8: 追加設定

1. 秘密情報の設定

   bashCopy

   # ~/.secrets.env を編集（install.shで作成済み）
   vim ~/.secrets.env
   

2. アプリケーション設定

   • 各アプリのログイン/同期設定

3. IDEプラグイン

   • VS Code拡張機能は Brewfile から自動インストール

旧マシンからの移行

データ移行

確認事項

# 移行後の確認
brew bundle check --file=~/ghq/github.com/snkrheadz/laptop/Brewfile
mise list
git config --global user.name
git config --global user.email

使用例

• "新しいMacのセットアップ手順を教えて"
• "dotfilesの適用方法"
• "Homebrewのインストール方法"
• "新マシンへの移行手順"
• "セットアップチェックリスト"

チェックリスト

• Xcode Command Line Tools
• Homebrew
• Git/GitHub CLI
• SSH鍵設定
• dotfilesクローン
• install.sh実行
• シェル再起動
• ~/.secrets.env設定
• mise runtimes確認
• auto-sync動作確認

トラブルシューティング

Homebrewのパスが通らない

# Apple Silicon Mac
eval "$(/opt/homebrew/bin/brew shellenv)"

# Intel Mac
eval "$(/usr/local/bin/brew shellenv)"

permissionエラー

# /opt/homebrew の権限修正
sudo chown -R $(whoami) /opt/homebrew

install.shが失敗

1. エラーメッセージを確認
2. 依存ツールが入っているか確認
3. ネットワーク接続を確認
4. 手動で各ステップを実行して問題特定

注意事項

• SSH鍵は慎重に扱う（移行時は暗号化転送推奨）
• install.shは冪等（何度実行してもOK）
• 既存設定は自動バックアップされる
• Apple Silicon/Intel Macでパスが異なる