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

Component Category Detection Command

Homebrew Package Manager which brew

Claude Code AI Tools which claude

Warp Terminal Terminal ls /Applications/Warp.app 2>/dev/null

Git Version Control which git

GitHub CLI Version Control which gh

Git LFS Version Control which git-lfs

Python 3.13 Development brew list python@3.13 2>/dev/null

Anaconda Development ls /opt/homebrew/anaconda3 2>/dev/null || ls ~/anaconda3 2>/dev/null

Google Cloud SDK Cloud CLI which gcloud

kubectl Cloud CLI which kubectl

Azure CLI Cloud CLI which az

Oracle CLI Cloud CLI which oci

DigitalOcean CLI Cloud CLI which doctl

Terraform DevOps which terraform

Cursor IDE IDE ls /Applications/Cursor.app 2>/dev/null

Orbstack Containers ls /Applications/OrbStack.app 2>/dev/null

Telepresence VPN which telepresence

Configuration Detection

Configuration Detection Command

pip mirror grep -q "pypi.tuna.tsinghua.edu.cn" ~/.pip/pip.conf 2>/dev/null

GKE contexts kubectl config get-contexts 2>/dev/null | grep -q "srp-cluster"

KUBECONFIG env grep -q "KUBECONFIG=~/.kube/config.srp" ~/.zshrc 2>/dev/null

Cursor extensions Compare installed vs required extensions

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 (用户选择)

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

按类别分组展示：

基础工具 (All Staff)

• Claude Code - AI 编程助手 (公司全员必装)

• Warp Terminal - 现代化终端

• Git + GitHub CLI + Git LFS - 版本控制

开发环境 (Developers)

• Python 3.13 - 基础 Python

• Anaconda - Python 虚拟环境管理

• Cursor IDE - AI 增强的代码编辑器

• Cursor Extensions - Cursor 扩展插件包

• Orbstack - 容器运行环境

云平台 CLI (Developers/DevOps)

• Google Cloud SDK - GCP 访问工具

• Azure CLI - Azure 访问工具

• Oracle CLI - OCI 访问工具

• DigitalOcean CLI - DO 访问工具

DevOps 工具

• Terraform - 基础设施即代码

• Miscellaneous - telnet, iftop, mtr, node, maven, ansible, pssh

配置项

• 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 应该：

• 读取 cursor-extensions.txt 文件内容

• 逐行执行 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

Component Verification Method Success Criteria

Homebrew brew --version

返回版本号

Claude Code claude --version

返回版本号

Warp Terminal 检查 App 目录 /Applications/Warp.app 存在

Git git --version

返回版本号

GitHub CLI gh auth status

显示认证状态

Git LFS git lfs version

返回版本号

Python python3.13 --version

返回 3.13.x

Anaconda conda --version

返回版本号

Cursor 检查 App 目录 /Applications/Cursor.app 存在

Orbstack orb version

返回版本号

gcloud gcloud auth list

显示 ACTIVE 账号

kubectl kubectl cluster-info

返回集群信息

GKE access kubectl get namespaces

返回 namespace 列表

Telepresence telepresence version

返回版本号

pip config 检查配置文件 包含清华镜像地址

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 : 在飞书群组中寻求帮助