Claude 写文件乱放路径？装这个 Skill 交给它操心

你写的 Python 小工具，在自己电脑上跑得好好的，丢给同事——崩了。为啥？因为你把配置写到了 ~/.mytool/config.json，人家 Mac 上根本没这路径。

这不是什么疑难杂症，是每个做 CLI 工具的开发者迟早要踩的坑：**文件该放哪儿？**

一个 Spec，治好了”乱放文件”的毛病

Linux/Unix 世界里有个老规矩叫 XDG Base Directory Specification（XDG 基准目录规范），早就把这件事说清楚了：

• 配置放 ~/.config
• 数据放 ~/.local/share
• 缓存放 ~/.cache
• 状态文件放 ~/.local/state

但问题是：你自己写代码去读这些路径，一堆 os.environ.get() 判断，写出来又丑又容易出错。

xdg-base-directory 这个 Skill，就是来解决这个问题的。

Claude 装上它，路径问题再也不用操心

只要装上这个 Skill，Claude Code 在处理任何涉及「用户目录存文件」的场景时，会自动：

• 读取系统 $XDG_CONFIG_HOME、$XDG_DATA_HOME 等环境变量（没设就走默认值）
• 生成符合规范的路径字符串
• 帮你检查目标目录是否存在，不存在就提示创建

相当于给 Claude 灌输了「正经应用该怎么放文件」的行业标准，以后再也不会生成 ~/.appname/something 这种硬编码路径了。

适用场景

• 你在写 Python CLI 工具，需要读写用户级配置
• 你的应用要跨 Linux/macOS/BSD 多平台，路径不能写死
• 你想让自己的项目符合开源社区的规范预期，方便贡献者快速上手
• 你在教 AI 写代码，想让它生成的文件结构更专业

怎么装

在 Claude Code 里一行搞定：

/plugin marketplace add Jamie-BitFlight/claude_skills
/plugin install xdg-base-directory@jamie-bitflight-skills

之后新建会话，Claude 就会自动识别「现在要读写用户配置」的场景并调用这个 Skill。

说到底这是一个「隐形的基础设施」——你不需要记住 XDG 规范细节，Claude 替你处理，你只管写真正的业务逻辑。

GitHub：https://github.com/jamie-bitflight/claude_skills

GitHub: https://github.com/jamie-bitflight/claude_skills