dotfiles

一套用于快速搭建和同步 macOS 开发环境的 dotfiles 配置

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:dotfiles。
它的用途是:一套用于快速搭建和同步 macOS 开发环境的 dotfiles 配置
完整的 Skill 内容见:https://321skill.com/skills/dotfiles-joshukraine/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我刚拿到一台新的 MacBook Pro,需要快速搭建我的开发环境。”,它会指导你克隆这个 dotfiles 仓库,并运行 `./setup.sh --dry-run` 预览将要进行的操作,确认无误后执行 `./setup.sh` 即可自动安装和配置 Neovim、Zsh、Starship 等全套工具。

介绍

这个 Skill 解决的是开发者在多台 macOS 设备上或重装系统后,需要反复手动配置开发环境的痛点。它通过一套预定义的配置文件(如 Neovim、Zsh、Tmux 等)和自动化脚本,实现开发环境的一键部署和同步。

使用方式非常简单:克隆仓库后,运行 setup.sh 脚本即可。脚本会利用 GNU Stow 工具,将仓库中的配置文件以符号链接的方式关联到你的用户目录(如 ~/.zshrc),并支持预览和冲突检测。

它非常适合需要在 macOS 上进行全栈或终端开发的工程师,尤其是使用 Neovim、Zsh、Tmux 等工具栈的用户。对于追求效率、希望环境配置可重复、可版本控制的开发者来说,这是一个极佳的选择。

需要注意的是,这套配置主要针对 macOS 系统,并且预设了特定的工具链(如 Homebrew, asdf)。使用前建议仔细阅读 setup.sh 脚本,并检查 $HOME 目录下是否有同名配置文件,以避免冲突。对于已经拥有成熟自定义配置的用户,建议将其作为参考或基础进行修改。

核心特点

与许多仅提供配置片段的 dotfiles 仓库不同,它提供了一套完整的、开箱即用的终端开发环境,深度集成了 LazyVim、Ghostty、Claude Code 等现代工具,并通过一个精心设计的、支持干运行的 `setup.sh` 脚本实现了高度自动化和安全的部署流程。

注意事项

主要面向 macOS 用户,且预设的工具栈和配置风格可能不适合所有开发者,需要一定的学习和调整成本。

常见问题

这套配置支持 Windows 或 Linux 吗?

主要针对 macOS 设计,部分配置(如 Zsh、Neovim)可能在其他 Unix-like 系统上可用,但核心的安装脚本和工具链(如 Homebrew)是为 macOS 优化的。

如果我已经有自己的 .zshrc 或 .vimrc 文件怎么办?

运行 `setup.sh` 脚本时会检测冲突,并提供备份选项。建议在运行前手动备份你的现有配置,或在克隆后只选取你需要的部分配置文件进行手动链接。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/dotfiles-joshukraine/raw/index.md 读取 dotfiles 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。