dotfiles

使用 Yadm 和 Yubikey 管理个人开发环境配置的 dotfiles 仓库。

安装使用

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

帮我安装这个 AI Skill:dotfiles。
它的用途是:使用 Yadm 和 Yubikey 管理个人开发环境配置的 dotfiles 仓库。
详细介绍见:https://321skill.com/skills/dotfiles-theoutdoorprogrammer/
请根据该页面的说明完成安装。

使用示例

当你拿到一台新的 Mac 工作电脑时,对 AI 说:“帮我按照 Joey 的 dotfiles 仓库配置我的新电脑。” AI 会引导你执行 `brew install yadm` 和 `yadm clone` 等命令,并提醒你插入 Yubikey 来导入密钥。运行 `yadm bootstrap` 后,你的 shell、Git、编辑器等配置就会自动设置完成,与原有环境保持一致。

介绍

这个 Skill 旨在解决开发者在多台机器间同步和部署个人开发环境配置时,遇到的繁琐、易出错和安全性问题。它通过 Yadm(一个基于 Git 的 dotfiles 管理工具)来版本化管理 shell、编辑器、工具等配置文件,并集成了 Yubikey 硬件密钥进行 GPG 和 SSH 密钥的安全管理,确保配置迁移的安全与便捷。

使用方式非常清晰:首先在 macOS 上通过 Homebrew 安装 Yadm,然后克隆此仓库,接着按照指引导入 Yubikey 上的 GPG 公钥并添加 SSH 公钥,最后运行引导脚本即可自动完成环境的初始配置。整个过程通过脚本自动化,减少了手动操作的步骤。

它特别适合那些使用 macOS、拥有 Yubikey 硬件密钥,并且需要在不同工作站(如公司电脑和个人电脑)之间快速、安全地搭建一致开发环境的工程师。对于追求环境可复现性和安全性的开发者来说,这是一个高效的解决方案。

需要注意的是,此 Skill 的安装流程和脚本主要针对 macOS 系统设计,使用其他操作系统的用户可能需要自行调整。此外,它重度依赖 Yubikey 进行密钥管理,没有此硬件的用户无法使用完整的 GPG/SSH 功能。在首次使用前,请确保已正确设置好你的 Yubikey。

核心特点

核心区别在于深度集成 Yubikey 硬件密钥进行 GPG 和 SSH 密钥管理,将安全身份验证与配置同步紧密结合;同时,它提供了完整的、针对 macOS 的自动化引导脚本,实现了从零到可用的“一键式”环境部署。

注意事项

不适合不使用 Yubikey 硬件密钥、或非 macOS 系统的用户。

常见问题

没有 Yubikey 能用这个 dotfiles 仓库吗?

可以克隆仓库,但涉及 GPG 签名和 SSH 密钥管理的核心功能将无法使用,需要自行配置替代方案。

如何在 Linux 或 Windows 上使用?

需要手动安装 Yadm 并可能修改 bootstrap 脚本中的部分命令,因为脚本和工具链主要针对 macOS 优化。