dotfiles

使用 GNU Stow 管理开发环境配置文件的 dotfiles 仓库。

安装使用

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

帮我安装这个 AI Skill:dotfiles。
它的用途是:使用 GNU Stow 管理开发环境配置文件的 dotfiles 仓库。
完整的 Skill 内容见:https://321skill.com/skills/dotfiles-jbuckmccready/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“我换了一台新电脑,需要快速搭建和之前一样的开发环境。”,它会指导你克隆这个 dotfiles 仓库,并使用 `stow` 命令一键链接 neovim、tmux、fish 等配置,让你迅速恢复熟悉的终端和编辑器设置。或者,当你

对AI说:“我的 neovim 插件预览图片功能失效了”,它可以提醒你检查并安装 ImageMagick 依赖。

介绍

这是一个集中管理个人开发环境配置文件的仓库,核心解决了开发者需要在多台机器上同步和恢复统一开发环境的痛点。它使用 GNU Stow 工具,通过创建符号链接的方式,将仓库中的配置文件(如 neovim、tmux、fish shell 等)优雅地部署到用户主目录,避免了手动复制或修改系统文件。

使用方式非常直接:克隆仓库后,只需针对需要的配置包(如 nvim, tmux)运行 stow {package} 命令,即可自动在文件系统的正确位置创建软链接,实现配置的快速安装。对于需要机器特定覆盖的配置(如 Git 签名密钥),仓库也预留了本地配置文件机制。

该仓库非常适合追求高效、可复现开发环境的全栈开发、后端开发及运维工程师。它尤其适合那些频繁切换工作机器、或希望在新设备上快速搭建熟悉开发环境的专业人士。

使用建议:首次使用前,请确保系统已安装 GNU Stow。由于配置涉及终端、编辑器、Shell 等多个层面,建议用户先理解每个配置包的作用,再按需启用。对于团队协作,可将此仓库作为环境标准化的基础模板。注意,部分工具(如 tree-sitter-cli)需要额外安装,请参照仓库内的安装说明。

核心特点

与零散存放配置文件或使用简单复制脚本的方案相比,本仓库严格采用 GNU Stow 进行符号链接管理,实现了配置的模块化部署与干净卸载;同时,它明确区分了版本控制的通用配置与机器本地配置,并通过详细的工具链集成说明(如 neovim 插件依赖、tmux 插件管理、Windows Terminal 适配)提供了开箱即用的现代化终端开发环境。

注意事项

该配置仓库高度个性化,紧密依赖作者特定的工具链(如 fish shell, ghostty, 特定 neovim 插件),直接套用可能需要对现有工作流进行较大调整,不适合希望保持最小化或完全不同工具栈的用户。

常见问题

如何安装某个特定的配置,比如只想要 neovim 配置?

在仓库根目录下执行命令 `stow nvim` 即可单独安装 neovim 的配置文件。

如何在多台机器上管理不同的 Git 配置(如邮箱)?

仓库已设置 Git 包含本地配置文件,您可以在 `~/.gitconfig.local` 中设置机器特定的用户信息,该文件不会被版本控制。

给 AI 助手的安装指引

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

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