mac-setup（Mac 设置）

Mac Setup for SRP

为 SRP 员工提供 Mac 开发环境的安装、配置和验证。支持智能检测已安装软件，让用户选择需要安装的组件，并在安装后进行验证检查。

Quick Start

帮我配置 Mac 开发环境
Setup my Mac for SRP development
检查我的 Mac 开发环境

Workflow Overview

执行此 skill 时，按以下 5 个阶段进行：

1. 前置检查 → 2. 智能检测 → 3. 用户选择 → 4. 执行安装 → 5. 验证检查

Phase 1: Pre-requisite Check (前置检查)

1.1 Check Homebrew

Homebrew 是所有后续安装的前提。

# 检测 Homebrew 是否已安装
which brew
brew --version

如果未安装 Homebrew： 提示用户先安装 Homebrew，这是唯一需要手动执行的步骤（因为需要输入密码）：

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

安装完成后，配置阿里云镜像加速：

echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.aliyun.com/homebrew/homebrew-bottles' >> ~/.zshrc
source ~/.zshrc

1.2 Check Google Cloud Authentication (Optional)

如果用户选择安装 GKE 配置或 Telepresence，需要先完成 gcloud 认证。

# 检查 gcloud 认证状态
gcloud auth list 2>/dev/null | grep -q "ACTIVE" && echo "authenticated" || echo "not authenticated"

如果未认证且用户选择了需要认证的组件： 引导用户完成认证（会打开浏览器）：

gcloud auth login
gcloud auth application-default login

Phase 2: Smart Detection (智能检测)

检测以下所有组件的安装状态。使用此检测逻辑：

Component Detection Commands

Configuration Detection

Detection Script

执行以下脚本进行完整检测：

echo "=== Mac Setup Detection Report ==="
echo ""

echo "## Package Manager"
echo -n "Homebrew: "; which brew > /dev/null 2>&1 && echo "✅ Installed ($(brew --version | head -1))" || echo "❌ Not installed"
echo ""

echo "## AI Tools"
echo -n "Claude Code: "; which claude > /dev/null 2>&1 && echo "✅ Installed" || echo "❌ Not installed"
echo ""

echo "## Terminal"
echo -n "Warp Terminal: "; [ -d "/Applications/Warp.app" ] && echo "✅ Installed" || echo "❌ Not installed"
echo ""

echo "## Version Control"
echo -n "Git: "; which git > /dev/null 2>&1 && echo "✅ Installed ($(git --version))" || echo "❌ Not installed"
echo -n "GitHub CLI: "; which gh > /dev/null 2>&1 && echo "✅ Installed ($(gh --version | head -1))" || echo "❌ Not installed"
echo -n "Git LFS: "; which git-lfs > /dev/null 2>&1 && echo "✅ Installed" || echo "❌ Not installed"
echo ""

echo "## Development Environment"
echo -n "Python 3.13: "; brew list python@3.13 > /dev/null 2>&1 && echo "✅ Installed" || echo "❌ Not installed"
echo -n "Anaconda: "; ([ -d "/opt/homebrew/anaconda3" ] || [ -d "$HOME/anaconda3" ]) && echo "✅ Installed" || echo "❌ Not installed"
echo -n "Orbstack: "; [ -d "/Applications/OrbStack.app" ] && echo "✅ Installed" || echo "❌ Not installed"
echo ""

echo "## IDE"
echo -n "Cursor: "; [ -d "/Applications/Cursor.app" ] && echo "✅ Installed" || echo "❌ Not installed"
echo ""

echo "## Cloud CLI"
echo -n "Google Cloud SDK: "; which gcloud > /dev/null 2>&1 && echo "✅ Installed ($(gcloud --version 2>/dev/null | head -1))" || echo "❌ Not installed"
echo -n "kubectl: "; which kubectl > /dev/null 2>&1 && echo "✅ Installed" || echo "❌ Not installed"
echo -n "Azure CLI: "; which az > /dev/null 2>&1 && echo "✅ Installed" || echo "❌ Not installed"
echo -n "Oracle CLI: "; which oci > /dev/null 2>&1 && echo "✅ Installed" || echo "❌ Not installed"
echo -n "DigitalOcean CLI: "; which doctl > /dev/null 2>&1 && echo "✅ Installed" || echo "❌ Not installed"
echo ""

echo "## DevOps Tools"
echo -n "Terraform: "; which terraform > /dev/null 2>&1 && echo "✅ Installed ($(terraform version | head -1))" || echo "❌ Not installed"
echo -n "Telepresence: "; which telepresence > /dev/null 2>&1 && echo "✅ Installed" || echo "❌ Not installed"
echo ""

echo "## Configurations"
echo -n "pip mirror config: "; grep -q "pypi.tuna.tsinghua.edu.cn" ~/.pip/pip.conf 2>/dev/null && echo "✅ Configured" || echo "❌ Not configured"
echo -n "GKE contexts: "; kubectl config get-contexts 2>/dev/null | grep -q "srp-cluster" && echo "✅ Configured" || echo "❌ Not configured"
echo -n "KUBECONFIG env: "; grep -q "KUBECONFIG" ~/.zshrc 2>/dev/null && echo "✅ Configured" || echo "❌ Not configured"

Phase 3: User Selection (用户选择)

根据检测结果，向用户展示未安装的组件，让用户选择要安装的内容。

按类别分组展示：

1. 基础工具 (All Staff)

- Claude Code - AI 编程助手 (公司全员必装) - Warp Terminal - 现代化终端 - Git + GitHub CLI + Git LFS - 版本控制

1. 开发环境 (Developers)

- Python 3.13 - 基础 Python - Anaconda - Python 虚拟环境管理 - Cursor IDE - AI 增强的代码编辑器 - Cursor Extensions - Cursor 扩展插件包 - Orbstack - 容器运行环境

1. 云平台 CLI (Developers/DevOps)

- Google Cloud SDK - GCP 访问工具 - Azure CLI - Azure 访问工具 - Oracle CLI - OCI 访问工具 - DigitalOcean CLI - DO 访问工具

1. DevOps 工具

- Terraform - 基础设施即代码 - Miscellaneous - telnet, iftop, mtr, node, maven, ansible, pssh

1. 配置项

- pip 镜像配置 - 使用清华镜像加速 - GKE 集群配置 - 配置 K8s 访问上下文 - Telepresence VPN - 内网访问工具

使用 AskUserQuestion 工具让用户进行多选。

Phase 4: Installation (执行安装)

根据用户选择，按依赖顺序执行安装。

Installation Commands

基础工具

Claude Code:

brew install --cask claude-code

Warp Terminal:

brew install --cask warp

安装后提示用户加入 SRP Team: https://app.warp.dev/team/9uUrBMqrIoZ7Jj5J6qrnSN

Git + GitHub CLI + Git LFS:

brew install gh git git-lfs
git lfs install

开发环境

Python 3.13:

brew install python@3.13

Anaconda:

brew install --cask anaconda

Cursor IDE:

brew install --cask cursor

Cursor Extensions: 安装 Cursor 扩展。扩展列表在 skill 目录的 cursor-extensions.txt 文件中。

执行时，Claude 应该：

1. 读取 cursor-extensions.txt 文件内容
2. 逐行执行 cursor --install-extension <extension-id>

# 示例：安装单个扩展
cursor --install-extension ms-python.python

Orbstack:

brew install orbstack

云平台 CLI

Google Cloud SDK:

brew install --cask google-cloud-sdk
gcloud components install gke-gcloud-auth-plugin kubectl kustomize bq
brew install gettext

Azure CLI:

brew install azure-cli

Oracle CLI:

brew install oci-cli

DigitalOcean CLI:

brew install doctl

DevOps 工具

Terraform:

brew tap hashicorp/tap
brew install hashicorp/tap/terraform

Miscellaneous:

brew install telnet iftop mtr node maven ansible pssh

Telepresence:

sudo curl -fL https://app.getambassador.io/download/tel2oss/releases/download/v2.18.0/telepresence-darwin-arm64 -o /usr/local/bin/telepresence
sudo chmod a+x /usr/local/bin/telepresence

配置项

pip 镜像配置:

mkdir -p ~/.pip
tee ~/.pip/pip.conf << 'EOF'
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/

[install]
trusted-host=mirrors.aliyun.com
               pypi.ngc.nvidia.com
               pypi.tuna.tsinghua.edu.cn

no-cache-dir = true
EOF

GKE 集群配置:

前提：需要先完成 gcloud auth login

# 备份现有配置
[ -f ~/.kube/config.srp ] && mv -f ~/.kube/config.srp ~/.kube/config.srp.bak

# 设置 KUBECONFIG
export KUBECONFIG=~/.kube/config.srp
grep -q "KUBECONFIG" ~/.zshrc || echo 'export KUBECONFIG=~/.kube/config.srp' >> ~/.zshrc

# 获取集群凭证
gcloud container clusters get-credentials srp-cluster-dev-us-east1 --location us-east1 --project srpdev-7b1d3
gcloud container clusters get-credentials srp-cluster-dev-us-west1 --location us-west1 --project srpdev-7b1d3
gcloud container clusters get-credentials srp-cluster-staging-us-east1 --location us-east1 --project srpstaging
gcloud container clusters get-credentials srp-cluster-staging-us-west1 --location us-west1 --project srpstaging
gcloud container clusters get-credentials srp-cluster-production-us-east1 --location us-east1 --project srpproduct-dc37e
gcloud container clusters get-credentials srp-cluster-production-us-west1 --location us-west1 --project srpproduct-dc37e

# 重命名 context 为简短名称
kubectl config rename-context gke_srpdev-7b1d3_us-east1_srp-cluster-dev-us-east1 srp-cluster-dev-us-east1
kubectl config rename-context gke_srpdev-7b1d3_us-west1_srp-cluster-dev-us-west1 srp-cluster-dev-us-west1
kubectl config rename-context gke_srpstaging_us-east1_srp-cluster-staging-us-east1 srp-cluster-staging-us-east1
kubectl config rename-context gke_srpstaging_us-west1_srp-cluster-staging-us-west1 srp-cluster-staging-us-west1
kubectl config rename-context gke_srpproduct-dc37e_us-east1_srp-cluster-production-us-east1 srp-cluster-production-us-east1
kubectl config rename-context gke_srpproduct-dc37e_us-west1_srp-cluster-production-us-west1 srp-cluster-production-us-west1

# 设置默认 context
kubectl config use-context srp-cluster-dev-us-east1

Phase 5: Verification (验证检查)

对已安装的组件进行功能验证，确保安装配置正确。

Verification Script

echo "=== Mac Setup Verification Report ==="
echo ""
PASS=0
FAIL=0

verify() {
    local name="$1"
    local cmd="$2"
    echo -n "$name: "
    if eval "$cmd" > /dev/null 2>&1; then
        echo "✅ PASS"
        ((PASS++))
    else
        echo "❌ FAIL"
        ((FAIL++))
    fi
}

echo "## Software Verification"
verify "Homebrew" "brew --version"
verify "Claude Code" "claude --version"
verify "Warp Terminal" "[ -d '/Applications/Warp.app' ]"
verify "Git" "git --version"
verify "GitHub CLI" "gh --version"
verify "Git LFS" "git lfs version"
verify "Python 3.13" "python3.13 --version"
verify "Anaconda" "conda --version"
verify "Cursor" "[ -d '/Applications/Cursor.app' ]"
verify "Orbstack" "[ -d '/Applications/OrbStack.app' ]"
verify "Google Cloud SDK" "gcloud --version"
verify "kubectl" "kubectl version --client"
verify "Azure CLI" "az --version"
verify "Terraform" "terraform version"
verify "Telepresence" "telepresence version"
echo ""

echo "## Configuration Verification"
verify "pip mirror" "grep -q 'pypi.tuna.tsinghua.edu.cn' ~/.pip/pip.conf"
verify "KUBECONFIG env" "grep -q 'KUBECONFIG' ~/.zshrc"
echo ""

echo "## GKE Connectivity Verification"
verify "GKE contexts configured" "kubectl config get-contexts | grep -q 'srp-cluster'"
verify "GKE dev cluster access" "kubectl --context srp-cluster-dev-us-east1 get namespaces"
echo ""

echo "=== Summary ==="
echo "Passed: $PASS"
echo "Failed: $FAIL"

if [ $FAIL -gt 0 ]; then
    echo ""
    echo "⚠️  Some verifications failed. Please check the items above."
fi

Detailed Verification Checks

Troubleshooting Guide

问题：Homebrew 安装失败

• 检查网络连接
• 尝试使用代理或镜像源

问题：gcloud auth 失败

• 确保浏览器可以正常打开
• 检查是否有公司网络限制

问题：GKE 集群连接失败

• 确认 gcloud auth 已完成
• 检查是否有 VPN 连接要求
• 确认账号是否有集群访问权限

问题：Telepresence 连接失败

• 确保 GKE 配置正确
• 检查是否已运行 telepresence quit -s
• 尝试重新连接: telepresence connect --context srp-cluster-dev-us-east1

Reference Documentation

• 飞书文档: Mac Setup (for SRP)
• Warp Team 邀请: https://app.warp.dev/team/9uUrBMqrIoZ7Jj5J6qrnSN
• Telepresence 使用指南: 参考飞书文档中的链接

Related Skills

• lark-docs: 访问飞书文档获取最新配置信息
• lark-messages: 在飞书群组中寻求帮助