nixos-config: Skill for Claude Code

User

架构

NixOS 系统账户与 Home Manager 用户配置分属两个项目：

/home/admin/nixos-config/
  modules/users.nix             ← 系统账户、组和管理员权限
  machines/<machine>/local.nix  ← mcb.users / mcb.adminUsers
/home/admin/mcbctl/
  profiles/                     ← 16 个共享 profile 模块
  home/                         ← 单用户 Home Manager 入口、配置与脚本

添加用户

先在 NixOS 项目注册系统账户，再独立激活 mcbctl 的 Home Manager 配置：

cd /home/admin/nixos-config
./run.sh add-user alice --admin
./run.sh deploy --host nixos

cd /home/admin/mcbctl
nix flake check

在调用方 flake 中显式暴露 Alice 的 Home Manager target；Linux target 的 homeModules.linux 会由 helper 自动组合，Niri 由 desktopEnvironment = "niri" 触发；NixOS integration 与宿主应用能力仍通过 extraModules 显式提供：

homeConfigurations."alice@x86_64-linux" =
  inputs.mcbctl.lib.mkHomeConfiguration {
    system = "x86_64-linux";
    username = "alice";
    homeDirectory = "/home/alice";
    desktopEnvironment = "niri";
    extraModules = [
      inputs.mcbctl.homeModules.nixos
      {
        mcb.desktop.providers.kazumi = true;
        mcb.desktop.providers.steam = true;
      }
    ];
  };

nix run /home/admin/mcbctl#home-manager -- \
  switch --flake /path/to/caller-flake#alice@x86_64-linux

admin 当前主机可直接使用 mcbctl 的完整 target：

cd /home/admin/mcbctl
nix run .#home-manager -- switch -b hm-backup --flake .#admin@nixos

该 target 只适用于当前 x86_64-linux NixOS 工作站，显式组合 Niri、NixOS integration、16 个 profile 和 Kazumi/Steam/WeMeet/Clash Verge capability；首次接管已有用户文件时保留 -b hm-backup，接管完成后可省略。portable admin@x86_64-linux target 仍只组合 portable core。nixos-config 的 run.sh add-user 只更新 machines/<machine>/local.nix 中的系统账户；它不创建 Home Manager 文件。mcbctl 不自动发现系统用户或机器；其他用户须通过 lib.mkHomeConfiguration { system; username; homeDirectory; desktopEnvironment ? null; extraModules ? [ ]; } 显式提供身份、平台层和宿主 capability。

修改现有用户

改什么	去
系统账户与权限	/home/admin/nixos-config/modules/users.nix + machines/<machine>/local.nix
软件选择	/home/admin/mcbctl/home/packages.nix + /home/admin/mcbctl/profiles/
dotfiles	/home/admin/mcbctl/home/config/
Git 身份	调用方通过 extraModules 显式传入 /home/admin/mcbctl/home/local.nix（gitignored、仅非敏感覆盖）
Shell 配置	/home/admin/mcbctl/home/shell.nix
Niri 配置	/home/admin/mcbctl/home/config/niri/
用户脚本	/home/admin/mcbctl/home/scripts/<name> + scripts.nix