用途:渲染或安装单个打包的 dotfiles 配置文件,面向 Ubuntu 或 macOS 的 dotfiles 部署初始化,以及编辑 colors.yml、构建或对比生成结果。使用前应先阅读 references/configuration.md,再更改状态或执行真实的 create 操作。
主要能力与用法:通过 ./green build、./green diff、./green create --dry-run 进行安全默认的构建、对比与试运行;在明确授权后可用 COLORS_PAR_DOTFILES_PREVENT_OVERWRITE=false ./green create 执行一次真实创建。初始化时把 green 复制到项目根目录并赋予可执行权限,依据配置参考创建 colors.yml,忽略 .colors/ 与 .envrc.private,先 build 或 diff 检查生成的配置文件,再在明确授权后执行 dry-run 和 create。
限制与安全:colors.yml 只包含非机密的期望状态;不要导出 COLORS_PAR_PROFILE;不要编辑或提交 .colors/;保持 dotfiles-prevent-overwrite: true,仅为一次授权创建可临时解除。delete 不受支持,此包不会从主目录删除文件;含凭据的源文件有意不打包。
分类依据:该技能涉及 dotfiles 配置的构建、试运行与安装部署,属于部署与运维用途,因此归入 devops。