菜单
Debug Nix build failures, eval errors, and runtime issues. Use when asked to debug, fix errors, troubleshoot, diagnose build/eval failures, greetd crashes, or systemd failed services.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Create or edit NixOS/Home Manager modules. Use when asked to create modules, add new modules, split modules, or manage the module architecture.
Manage system and user software packages, profiles, and overlays. Use when asked to install, add, remove, change software, enable/disable profiles, or manage Flatpak apps.
Refactor NixOS configuration — extract modules, clean up, remove dead code, consolidate duplicates. Use when asked to refactor, split, clean, reorganize, optimize, or consolidate Nix config.
Validate, build, and deploy the NixOS configuration. Use when asked to run, build, check, validate, verify, test, or deploy the NixOS config.
Manage NixOS users — add, remove, or modify user configurations. Use when asked to add users, create users, manage users, set up multi-user, or configure profiles and dotfiles.
Safely rebuild and deploy the NixOS system. Use when asked to rebuild, switch, deploy, apply configuration, or activate changes.
| name | debug |
| description | Debug Nix build failures, eval errors, and runtime issues. Use when asked to debug, fix errors, troubleshoot, diagnose build/eval failures, greetd crashes, or systemd failed services. |
| 特征 | 类型 | 查什么 |
|---|---|---|
error: undefined variable | 未定义变量 | 拼写、with 污染 |
error: attribute 'xxx' missing | 属性缺失 | nixpkgs API 变更、包名错误 |
error: The option 'xxx' is used but not defined | 选项未声明 | 去 modules/options.nix 声明 |
error: infinite recursion | 无限递归 | 自引用配置 |
error: value is X while a Y was expected | 类型不匹配 | 选项类型声明 |
error: A definition for option 'xxx' is not of type '...' | 选项类型错误 | 检查赋值类型 |
nix flake check 2>&1 # eval 阶段
nixos-rebuild build --flake /etc/nixos#<machine> 2>&1 | tee build.log # 构建阶段
nix log /nix/store/<hash>-<name>.drv # 构建日志
nix flake check --show-trace 2>&1 | head -100 # 完整 trace
| 症状 | 根因 | 修复 |
|---|---|---|
No such file or directory (新 .nix 文件) | 没 git add | git add <文件> |
mcb.xxx is used but not defined | 在功能模块中声明选项 | 移到 modules/options.nix |
undefined variable | with lib; 污染 | 显式 lib.xxx |
| 列表被覆盖 | 直接赋值 = [pkg] | 用 lib.mkAfter |
journalctl -u greetd -b --no-pager | tail -80 # 查看 greetd 日志
| 日志特征 | 原因 | 修复 |
|---|---|---|
| greeter 不断重启 | greeter 崩溃 → greetd restart loop | 检查 greeter 命令是否正确；agreety 是最可靠的选项 |
unrecognized option '-s' / '-d' / '-m' | cage >=0.2 废弃旧参数 | 清空 cageArgs，移除 greetd command 中的对应参数 |
Failed to initialize GTK / 白屏 | Mesa 回归（regreet 等图形 greeter） | 切换到 agreety（无 GTK/Mesa 依赖），或加 GSK_RENDERER=ngl |
| cage 找不到 GPU/DRM | 内核模块未加载 | lsmod | grep i915；检查 hardware-gpu.nix |
systemctl --failed # 失败服务
journalctl -u <service> -b # 服务日志
loginctl list-sessions # 桌面会话