菜单
Update flake.lock, handle patches, and test builds. Use when asked to update the flake, run nix run .#update, handle patch failures, or test darwin/nixos builds after an update.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Manage .flake.patches — find fixes for build failures, check if patches landed in nixos-unstable, register or remove patches. Use when a nix build fails after a flake update.
Flake update with fork merge — create merge commit, run flake-lock-merge, advance main. Use when updating flake inputs in a repo with both a public (kdn) and private (fork) remote.
jj version control patterns — working copy, split/squash, bookmarks, fork rebase. Single source of truth for jj usage in this repo; use whenever reaching for a raw git command, or when working with jj commits, splits, rebases, or bookmark management.
| name | flake-update |
| description | Update flake.lock, handle patches, and test builds. Use when asked to update the flake, run nix run .#update, handle patch failures, or test darwin/nixos builds after an update. |
| type | Skill |
| timestamp | "2026-07-03T20:19:14.000Z" |
Full reference: docs/flake-update.md Fork workflow: docs/flake-update.fork.md (if fork remote configured) Patch handling: docs/flake-patches.md
# @ is the empty working copy on top of upstream
nix run '.#update'
# patch failed? remove from .flake.patches/config.toml + delete .patch file, then:
# nix run '.#update' -- g:patches
jj describe -m 'chore(flake): update'
jj bookmark set upstream -r @-
# test (see Testing below), fix failures with jj split + squash
gh search prs "<package>" --repo NixOS/nixpkgs --limit 5gh api "repos/NixOS/nixpkgs/compare/nixos-unstable...<commit>" --jq '.status'
"ahead" = not yet landed → register patch"behind" / "identical" = already landed → remove old patch.flake.patches/config.toml:
[patch.nixpkgs.my-fix]
url = "https://github.com/NixOS/nixpkgs/pull/<PR>.patch?full_index=1"
nix run '.#update' -- g:patches# macOS — use pre-update rev to avoid rebuilding the tool itself:
PRE_UPDATE_REV=$(jj log -r 'upstream@<fork-remote>' --no-graph -T 'commit_id')
nix run "git+file://$PWD?rev=${PRE_UPDATE_REV}#darwin-rebuild" -- build
# or current tree:
nix run '.#darwin-rebuild' -- build
# switch (requires sudo — hand off to user):
nix run '.#darwin-rebuild' -- switch
# NixOS local:
./nixos-rebuild.sh build
./nixos-rebuild.sh switch # requires sudo
# NixOS remote:
./nixos-rebuild.sh build remote=<hostname>
./nixos-rebuild.sh switch remote=<hostname>
jj bookmark set upstream -r @- — targets the just-described commit, not the new empty @nix run '.#darwin-rebuild' -- build in background: pass run_in_background=trueswitch — hand off to user (requires sudo)