setup-mac

name	setup-mac
description	新Macセットアップオーケストレータ。新規Mac環境構築時または既存環境リセット後に使用。Xcode license/Homebrew/dotfiles deploy/brew bundle/mise/fisher/chsh/SSH切替を順次実行し、sudo/MAS Apple ID 等の対話プロンプトを安全に通す。

/setup-mac

新しい Mac のセットアップを実施する。canonical 実装は ~/.dotfiles/scripts/setup.sh。 このskillはそれを対話的にオーケストレートする。

前提（ユーザに確認すること）

skill 起動直後、以下を順に確認してから先に進む:

1. Claude Code が起動・ログイン済み （これが満たされているなら自明）
2. SSH 秘密鍵の入手経路が決まっている
   • 鍵と ssh config は private repo ukwhatn/.ssh で管理しており、秘密鍵は git 管理外
   • 既存マシンから移送するか、このマシンで新規生成して各サービスに登録する
3. GitHub アカウントに認証鍵・署名鍵を登録できる状態
   • web UI、または gh auth refresh -s admin:public_key,admin:ssh_signing_key

これらが揃っていない場合、揃うまでガイドして待つ。

実行手順

Step 1. setup.sh を取得して実行

~/.dotfiles が未存在の場合は curl で setup.sh を直接取得して実行:

curl -fsSL https://raw.githubusercontent.com/ukwhatn/dotfiles/main/scripts/setup.sh | bash

または ~/.dotfiles が既に clone 済みなら:

bash ~/.dotfiles/scripts/setup.sh

このスクリプトは以下を実行する（idempotent）:

1. Xcode CLT 確認 + license 承諾（sudo prompt）
2. Homebrew インストール
3. dotfiles を ~/.dotfiles に clone
4. rsync で ~/.dotfiles/* を $HOME/ にデプロイ
5. brew bundle 実行（注意: sudo / MAS Apple ID の対話プロンプトが出る）
6. mise install
7. fisher + fish plugins インストール
8. login shell を fish に切替
9. dotfiles remote を SSH に変更
10. 動作確認

Step 2. 対話プロンプトの監視

setup.sh 実行中、以下の対話プロンプトを user に伝える:

• sudo password （Xcode license, fish を /etc/shells に追加, sudo cask install 等）
• MAS Apple ID sign-in （Spark, Xcode）: App Store アプリで Apple ID にサインインしてから brew bundle 再実行

エラーが出たら原因を切り分け:

• sudo: a terminal is required → user が別ターミナルで該当コマンドを手動実行
• App Spark needs to be installed → App Store サインイン後 brew bundle install 再実行
• Cask already installed → 無害、無視

Step 3. 残り手動ステップ（ユーザ操作）

setup.sh 完了後、以下を case-by-case でガイド:

1. ~/.ssh の構築

   • gh repo clone ukwhatn/.ssh ~/.ssh-bootstrap
   • mkdir -p ~/.ssh && mv ~/.ssh-bootstrap/.git ~/.ssh/ && rmdir ~/.ssh-bootstrap
   • git -C ~/.ssh checkout . && chmod 700 ~/.ssh && chmod 600 ~/.ssh/keys/*
   • 秘密鍵を配置（既存マシンから移送、または新規生成して各サービスへ登録）
   • signing key は .gitconfig が ~/.ssh/keys/sign_ukwhatn を参照するので追加設定は不要

2. GitHub CLI 認証

   • gh auth login を実行
   • SSH を選択、Web 経由で認証

3. SSH 疎通確認

   • ssh -T [e-mail] → "Hi ! You've successfully authenticated"

4. 業務用 fish functions （任意）

   • 私用 helper を使う場合: git clone [e-mail]:ukwhatn/functions.git ~/work-fish-functions
   • ~/.config/fish/config.fish に source ~/work-fish-functions/*.fish を追記

5. アプリ起動 + 権限付与

   • Karabiner-Elements: アクセシビリティ・入力監視
   • Raycast: アクセシビリティ
   • 1Password: アクセシビリティ・ロック解除

6. ターミナル再起動

   • login shell が fish になっていることを確認: echo $SHELL

Step 4. 動作確認 + レポート

最後に以下を確認して報告:

• fish --version / mise current / gh auth status / brew bundle check
• git -C ~/.dotfiles remote -v が SSH になっているか
• ssh -T [e-mail] 成功

完了報告に含める:

• ✅ 完了項目
• ⚠ user の追加対応待ち項目（gh auth login 等）
• ⚠ 既知の制限（zoom の sudo, MAS の Apple ID）

トラブルシューティング

症状	対処
xcodebuild -license で sudo 必要	! sudo xcodebuild -license accept を別ターミナルで
brew bundle で cask sudo 必要	該当 cask を手動 brew install --cask <name>
fisher install で curl 失敗	ネットワーク確認、proxy 設定確認
mise install で python ビルド失敗	Xcode license / CLT を再確認、mise install python@3.13.9 --verbose
chsh で 非標準シェル エラー	/etc/shells への fish 追加が未済、sudo で追加

重要

• このskillは破壊的操作を含む（chsh, /etc/shells書込, dotfiles deploy）
• setup.sh は idempotent なので複数回実行しても安全
• 既存設定が消えそうな状況では rsync 前に user 確認