用途:当用户要求“为新 Mac 配置开发环境”“在 macOS 上安装 Homebrew 和 Node”“为新 MacBook 准备编码环境”时使用,直接执行配置命令,不把命令转交给用户,除非需要图形界面提示或管理员授权。
主要能力与用法:使用非交互参数(-y、--yes、NONINTERACTIVE=1),开始前告知用户可能需要安装命令行工具和管理员批准。步骤一预检:uname -sm、which brew/node/npm/npx/uv、xcode-select -p,已存在的工具跳过重装。步骤二安装 Xcode Command Line Tools:xcode-select --install;无图形界面时可用 softwareupdate 列表匹配后 sudo softwareupdate -i "$CLT_LABEL" --verbose,该命令不支持自动批准,安装后重新检查 xcode-select -p。步骤三安装 Homebrew:NONINTERACTIVE=1 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。步骤四安装 Node:优先 brew install node,失败时用 Node 官方 tar 包解压到 $HOME/.local 并建立 node/npm/npx 软链,然后 export PATH="$HOME/.local/bin:$PATH"。步骤五安装 uv 与 Python:curl -LsSf https://astral.sh/uv/install.sh | sh,随后 uv python install。步骤六安装技能包:GH_TOKEN=<token> npx skills add fwfutures/rome2rio-skills fwfutures/vibe-a-thon -g -y;克隆失败可改用 GitHub zipball 下载解压后 npx skills add /path/to/extracted/repo -g -y。步骤七验证:which brew、node -v、npm -v、npx -v、uv --version、uv python list、npx skills list -g。步骤八报告已安装与既有工具、成功技能、剩余阻塞与下一步命令。
限制:需要命令行工具与管理员批准;Homebrew 失败且无管理员权限时只能走用户级 Node 回退;技能在 Agent 中的链接取决于宿主运行时,npx skills list -g 未显示不代表安装失败。令牌应保存在环境变量中,不得写入日志或总结。