用途:在 macOS 上通过 Homebrew 安装一套精选的现代命令行工具,并补齐常被忽略的 shell 集成配置,使 fzf 快捷键、zoxide 跳转等真正可用。内容反映 2026 年生态现状(用 eza 而非已废弃的 exa,用 fzf --zsh 而非旧安装脚本,zoxide 初始化放在 compinit 之后)。
主要能力:核心搜索/导航/查看工具 ripgrep、fd、fzf、bat、eza、zoxide、tree、wget、jq、yq;Git 体验 gh、git-delta、lazygit;系统监控 htop(或 btop);可选 atuin 提供可搜索的 shell 历史。安装命令示例:brew install ripgrep fd fzf bat eza zoxide tree wget jq yq;brew install gh git-delta lazygit;brew install htop。
使用方式:先确认 command -v brew 成功,否则应转向 homebrew-setup。安装后以 grep 守卫方式向 ~/.zshrc 幂等追加集成行:source <(fzf --zsh)、eval "$(zoxide init zsh)",并确保 compinit 已存在。可选别名(需先询问用户)如 alias ls='eza --icons'、alias cat='bat --style=plain'、alias lg='lazygit';--icons 需终端选用 Nerd Font。可将 delta 设为 git 分页器:git config --global core.pager delta 等。最后运行 sh "${CLAUDE_SKILL_DIR}/scripts/check.sh" 并在新 shell 中验证 Ctrl-R、z 跳转与 rg --version。
适用场景:macOS 开发环境初始化、终端工具链统一配置。
限制:不负责 Homebrew 安装、提示符/主题/插件(属 zsh-setup)、GUI 应用、云 CLI、AI 智能体 CLI、语言运行时;gh 的登录认证属 git-ssh-identity;不重构 ~/.zshrc;别名不强制、不用于脚本;macOS 为 BSD 用户态,GNU 参数习惯可能失效。