Dotfile
同步管理 dotfile 配置的智能工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Dotfile。 它的用途是:同步管理 dotfile 配置的智能工具 完整的 Skill 内容见:https://321skill.com/skills/dotfile-x-3/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用 Dotfile 同步我的 ~/.claude/plugins 配置到 Windows 和 WSL',它会自动识别当前环境,调用 chezmoi 模板,将插件目录按 split layout 拆分到对应平台目录,并确保两边配置一致。
介绍
Dotfile 主要解决跨平台(Windows + WSL)开发环境配置同步问题,让你无需手动拷贝和调整 dotfile 即可保持多机配置一致。它基于 chezmoi 的模板化管理和 agents 的共享机制,自动处理 ~/.agents 和 ~/.claude/plugins 的拆分布局,并利用 [agents.md] 文件记录同步规则。
使用方法非常简单:安装后通过 chezmoi 初始化你的 dotfile 仓库,Agents 会自动识别 Windows 和 WSL 的差异,按 split layout 策略将插件和配置分别写入对应目录。你只需在任意一端修改配置,另一端会自动同步生效。
适合运维工程师、全栈开发者以及需要频繁切换 Windows 和 WSL 环境的智能体开发者。如果你使用 Claude 插件或自定义 agents,这个工具能显著减少手动配置的重复劳动。
建议在首次同步前备份现有 dotfile,并仔细阅读 [agents.md] 中的布局说明,避免覆盖已有配置。如果遇到同步冲突,可以先手动合并再执行 chezmoi apply。
核心特点
与普通 dotfile 管理器不同,Dotfile 专门针对 Windows+WSL 双环境设计,支持 agents 插件目录的拆分布局,并内置 chezmoi 模板引擎,能自动处理路径差异和条件渲染。
注意事项
不适合纯 macOS/Linux 单一环境用户,也不支持无 chezmoi 依赖的简单复制场景。
常见问题
如何与 chezmoi 集成?
只需在 ~/.agents 目录下运行 chezmoi init --apply 你的 dotfile 仓库,Dotfile 会自动读取 agents 配置并执行模板渲染。
支持哪些平台?
主要支持 Windows 和 WSL(Windows Subsystem for Linux),通过 agents 共享机制实现双向同步。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/dotfile-x-3/raw/index.md 读取 Dotfile 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/dotfile-x-3/raw/index.md(查看排版版本)