القائمة
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)