用途
该技能围绕 Comtrya 这一声明式系统配置工具展开，Comtrya 通过 YAML/TOML 清单描述系统的期望状态，并可幂等地应用于 macOS、Linux 和 Windows。核心原则是：清单描述期望状态，重复应用不会产生副作用。通过本技能，可以了解如何设计多操作系统配置、管理包管理器冲突、组织团队配置工作流。
主要能力
- 多操作系统清单结构：使用
where条件针对特定操作系统、架构或运行时条件。例如可通过variants为 Linux 指定 apt、macOS 指定 brew、Windows 指定 winget，也可让 Comtrya 自动检测默认包管理器。 - 按关注点组织清单：按职责而非操作系统拆分清单，如
base.yml（跨平台）、dev-tools.yml（带 OS 变体的开发依赖）、system.yml（操作系统特定项），支持通过--manifest参数依次应用多个清单。 - 包管理器安全：Comtrya 是幂等且增量式的，
package.install不会移除或降级。其行为包括：已安装的包会跳过（no-op）；使用不同提供者的同名包会保持独立；同一包管理器下只有单个声明生效。可通过文档化团队策略（如「Linux 团队只用 apt」）来避免冲突。 - 依赖排序：Comtrya 不会自动排序操作，需显式声明依赖，使用
depends_on。例如先创建 docker 组，再安装 docker 包，最后启用服务，否则会出现静默失败。 - 权限提升模式：对需要提升权限的操作使用
privileged: true，或以sudo comtrya apply运行整个清单。应尽量避免不必要的提权，用户配置文件可用file.copy而非特权命令。 - 应用前验证：强制验证流程不可跳过，按顺序执行：语法校验（
comtrya validate）→ 在测试机上干跑（comtrya apply --dry-run）→ 邀请一位团队成员在实际机器上试点并确认无故障 → 再推广到团队。 - 回滚与恢复：回滚仅用于紧急情况。清单描述的是期望状态而非状态变更，恢复需手动移除变更或编写反向操作（
package.remove、file.delete），并通过版本控制清单追踪变更。 - 常见模式：符号链接配置文件、下载并安装二进制、将 Git 仓库纳入配置、用户与组管理（需权限）。
使用方式
通过 Comtrya 应用清单：comtrya apply --manifest base.yml --manifest dev-tools.yml。验证语法：comtrya validate manifest.yml。干跑预览：comtrya apply --dry-run --manifest manifest.yml。安装可固定版本：COMTRYA_VERSION=0.3.0 curl -fsSL https://get.comtrya.dev | INSTALL_VERSION=$COMTRYA_VERSION sh。
适用场景
设计多操作系统配置（开发团队、CI/CD、个人机器）；结构化清单以处理 OS 差异；管理包管理器冲突；同时设置 dotfiles 与系统配置；在广泛应用前测试变更；安全处理权限提升。
限制
文件操作（file.link、file.copy、directory.copy）要求源文件位于清单相对的 files/ 子目录中，以避免 Comtrya 将配置文件误解析为清单。Comtrya 不会自动排序操作。不同 Comtrya 版本在可用操作、where 子句语法、权限处理上可能不同。验证流程不可跳过，跳过会导致每名受影响用户 1–4 小时的恢复成本。回滚成本高且易出错，应以验证预防为主。