upgrade-nixos
将NixOS升级到新版本(例如25.05 → 25.11)-研究重大变更,更新flake输入,并引导完成升级过程
📖 中文导读:将NixOS升级到新版本(例如25.05 → 25.11)-研究重大变更,更新flake输入,并引导完成升级过程 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: upgrade-nixos description: | This skill upgrades NixOS to a new release version (e.g., 25.05 → 25.11). Triggers: "upgrade nixos", "upgrade to new release", "update nixos version", "move to nixos 25.11", "nixos release upgrade", "upgrade system version". Researches breaking changes, updates flake inputs, guides through upgrade. Not for flake.lock updates within same release (use upgrade-flake for that).
Upgrade NixOS Release
Upgrade NixOS to a new stable release version. This involves updating version-pinned flake inputs and handling any breaking changes.
Process
Check current state
nixos-version nix --versionIdentify version-pinned inputs in flake.nix that need updating:
nixpkgs(e.g.,nixos-25.05→nixos-25.11)home-manager(e.g.,release-25.05→release-25.11)nix-darwin(e.g.,nix-darwin-25.05→nix-darwin-25.11)stylix(e.g.,release-25.05→release-25.11)
Research the target release
- Use web search to find the latest stable NixOS release
- Check release notes for breaking changes relevant to this config
- Verify release branches exist for home-manager, stylix, nix-darwin
Identify breaking changes that affect this config:
- Scan modules for services/packages that might be affected
- Key areas: Hyprland, Docker, Steam, Secure Boot, impermanence
Create upgrade plan (use creating-plans skill):
- Save to
thoughts/shared/issues/NN-nixos-<version>-upgrade/plan.md - Include exact file changes with line numbers
- Include verification commands
- Include rollback instructions
- Save to
Execute upgrade (when user is ready):
# Edit flake.nix with new versions just update # Update flake.lock just check # Build without applying (safe) just switch # Apply the upgradePost-upgrade verification:
nixos-version nix --version docker --version systemctl status docker tailscaled hyprctl version
What stays pinned (don't change)
lanzaboote- explicit version pin (e.g., v0.4.2), not tied to NixOS releasesnixpkgs-unstable- always tracks unstable- Inputs that
follownixpkgs - automatically updated
Rollback
Print out the instructions to:
sudo nixos-rebuild switch --rollback
git checkout flake.nix flake.lock
$ARGUMENTS