Dotfile

多设备 dotfiles 与 AI 代理配置同步工具

安装使用

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

帮我安装这个 AI Skill:Dotfile。
它的用途是:多设备 dotfiles 与 AI 代理配置同步工具
完整的 Skill 内容见:https://321skill.com/skills/dotfile-x-6/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'帮我用 chezmoi 同步 dotfiles 到新装的 WSL 环境,并确保 Claude 的 agents 和 plugins 配置正确拆分',它会自动拉取本仓库模板,执行 chezmoi apply 将 ~/.agents 和 ~/.claude/plugins 按照预定义 split layout 部署到 WSL 对应路径,同时生成 agents.md 文件用于 Claude 加载。整个过程无需手动拷贝文件,环境即可恢复。

介绍

在日常开发中,跨 Windows 和 WSL 环境同步 dotfiles、AI 代理配置(如 Claude 的 agents 和 plugins)往往繁琐且易出错。本 Skill 借助 chezmoi 模板引擎,统一管理 /.agents 共享目录、/.claude/plugins 分割布局以及 agents.md 等配置文件,确保你在不同系统、不同终端上获得一致的开发环境和 AI 助手能力。

使用方式非常简单:先通过 chezmoi 初始化本仓库作为 dotfile 源,然后执行同步命令即可自动将配置模板应用到本地。对于 ~/.agents 和 ~/.claude/plugins,Skill 会按照 split layout 策略分别处理 Windows 和 WSL 下的路径,避免冲突。后续如需修改,只需编辑源仓库中的模板文件,再次同步即可。

本 Skill 适合需要在多设备(尤其是 Windows + WSL)间保持开发环境一致的运维工程师、全栈开发者,以及同时使用多个 AI 编码代理(如 Claude、Cursor)的智能体开发者。它也能帮助团队统一 AI 工具配置,减少因环境差异导致的协作问题。

建议先备份现有 dotfiles 再首次应用,以免覆盖本地自定义配置。如果仅需同步单一系统或不需要 AI 代理配置,该 Skill 可能显得过于复杂,更推荐使用 chezmoi 或 GNU Stow 等基础工具。首次同步后,请检查 agents.md 中的布局是否正确,确保 Claude 插件能正常加载。

核心特点

与单纯管理 dotfiles 的工具不同,本 Skill 专为 Windows + WSL 双环境设计,同时集成了 AI 代理(agents)和 Claude 插件(plugins)的同步与布局拆分,而其他方案通常只关注 shell 配置,缺乏对 AI 编码工具配置的跨平台管理。

注意事项

不适合只需单一系统 dotfile 管理或不需要 AI 代理配置同步的用户,且依赖 chezmoi 模板语法,学习成本略高于普通 dotfile 方案。

常见问题

如何在 Windows 和 WSL 之间同步 Claude 插件配置?

本 Skill 会自动识别当前系统,将 ~/.claude/plugins 映射到对应路径,并采用 split layout 避免覆盖。你只需在源仓库中维护一份模板,同步时 chezmoi 会根据系统变量渲染出不同内容。

安装后如何验证 agents 配置是否生效?

执行 `cat ~/.agents/agents.md` 查看布局是否正确,并检查 Claude 客户端是否加载了该文件。如果 Agents 列表未刷新,可重启 Claude 或手动 source 配置文件。

给 AI 助手的安装指引

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

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