dotfiles
一套用于统一管理本地开发环境配置与AI编码代理设置的dotfiles工具集。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:dotfiles。 它的用途是:一套用于统一管理本地开发环境配置与AI编码代理设置的dotfiles工具集。 详细介绍见:https://321skill.com/skills/dotfiles-keenranger/ 请根据该页面的说明完成安装。
使用示例
当你换了一台新电脑,只需克隆此仓库并运行 `./install.sh`,它就会自动为你设置好熟悉的终端环境、Git配置,并将预设的AI编码代理技能和配置链接到位。在日常开发中,如果你想更新所有AI代理共享的提示词或技能,只需在仓库中修改,然后运行 `./install.sh create_codex_symlinks` 即可快速同步到Codex等代理中。
介绍
该仓库旨在解决开发者在多台机器或不同AI编码代理(如Codex、Claude Code)之间,环境配置、技能、设置分散且难以同步的问题。它通过模块化的安装脚本和清晰的目录结构,将个人开发环境的配置文件(dotfiles)、共享的AI代理使用指南、工作流技能以及代理特定设置(如Claude的钩子和代理)集中管理。
使用方式非常灵活,主要通过执行install.sh脚本并传入不同参数来完成不同任务。例如,./install.sh执行完整的个人机器设置,而./install.sh codex_machine则适用于公司机器等无需个人Git身份的场景。脚本的核心功能是创建符号链接,将仓库中的配置和技能链接到系统或AI代理的对应目录,实现配置的集中管理和快速同步。
它非常适合需要频繁在不同开发机器间切换,或希望标准化、自动化其本地开发环境(尤其是与AI编码代理协同工作)的开发者。无论是个人开发者还是团队,都可以利用这套工具减少环境配置的重复劳动。
使用建议是,在初次使用前仔细阅读仓库结构,理解agent/、codex/、claude/等目录的用途。对于GPG密钥备份功能,请确保所有密钥使用相同密码,并妥善保管备份文件。注意,该工具主要管理配置的链接和同步,不替代具体的环境依赖安装。
核心特点
与普通的dotfiles仓库相比,它深度集成了对AI编码代理(Codex、Claude Code)的配置管理,提供了共享的代理使用指南、工作流技能和代理专属设置。其GPG备份功能设计严谨,要求所有密钥密码一致以确保备份完整性,且恢复流程不依赖机器本地密钥链,更具可移植性。
注意事项
不适合仅需管理简单命令行配置、而不使用AI编码代理或无需复杂环境同步的轻量级用户。
常见问题
这个dotfiles仓库和普通的有什么区别?
它不仅管理Shell等传统配置,还专门为Codex、Claude Code等AI编码代理提供了共享技能、配置和设置管理,是面向AI增强开发的工作流工具。
GPG备份功能安全吗?
安全。它会用AES256加密整个备份包,并要求所有被备份的密钥使用同一密码,避免创建不完整的备份。恢复时也支持校验文件完整性。