dotfiles

一键部署和管理跨平台开发环境配置的自动化工具集。

安装使用

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

帮我安装这个 AI Skill:dotfiles。
它的用途是:一键部署和管理跨平台开发环境配置的自动化工具集。
详细介绍见:https://321skill.com/skills/dotfiles-ishii1648/
请根据该页面的说明完成安装。

使用示例

当你拿到一台新的MacBook Pro准备开始工作时,

对AI说:‘帮我把开发环境配好’,你可以先克隆这个仓库,运行 bash scripts/setup.sh,它会自动为你安装并配置好fish、tmux、Neovim、Git以及Claude Code的所有预设技能。当需要登录远程服务器开发时,使用 --profile remote 参数即可快速部署精简而高效的远程终端环境。

介绍

这个仓库解决开发者在多台机器(如个人Mac、公司Linux、远程服务器)上快速、一致地搭建开发环境的痛点。它通过一个统一的脚本(setup.sh)和声明式清单(manifest),自动化安装和配置fish shell、tmux、Neovim、Git、Claude Code等核心工具,并处理SSH密钥、Git用户信息等繁琐设置。

使用方式非常直接:克隆仓库,按需编辑本地清单文件(如设置用户名和SSH密钥路径),然后运行bash scripts/setup.sh即可。脚本支持多种预设配置(profile),例如针对远程服务器的—profile remote会跳过本地GUI工具,而—dry-run模式可以安全地检查配置状态。

它特别适合需要频繁切换或重建开发环境的全栈开发、运维工程师和智能体开发者。无论是配置新电脑、统一团队环境,还是为远程开发服务器快速部署基础工具链,都能显著提升效率。

需要注意的是,它主要管理“通用”配置,而将机器特定的设置(如公司内部工具、特定密钥)剥离到独立的仓库中,以保持核心配置的纯净和可移植性。首次使用前,请确保阅读README,正确生成并配置SSH密钥。

核心特点

与零散的dotfiles管理方案不同,它采用声明式的YAML清单(manifest)来定义所有组件和依赖,实现真正的一键式、可复现的环境部署;同时,它通过精细的“profile”机制(如full, remote, linux)和与Claude Code/Codex CLI的深度集成,为AI辅助开发提供了开箱即用的技能(skills)和沙箱环境。

注意事项

不适合只需要简单复制几个配置文件、或环境高度定制化且不愿遵循其清单和profile结构的用户。

常见问题

如何在全新的Linux服务器上使用?

克隆仓库后,使用 bash scripts/setup.sh --profile linux 命令,该配置会跳过Ghostty等本地GUI工具,专注于服务器端环境。

如何安全地在Docker容器里测试Claude Code的自动运行?

仓库提供了Docker沙箱方案,详细步骤见 docs/claude-docker-sandbox.md,确保AI代码在隔离环境中执行。