Menü
在 NixOS 系统上工作时使用。确保正确使用现代 Nix/NixOS CLI、完整的 shell 能力、sudo 权限和正确的系统维护流程。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
| name | nixos-modern-cli |
| description | 在 NixOS 系统上工作时使用。确保正确使用现代 Nix/NixOS CLI、完整的 shell 能力、sudo 权限和正确的系统维护流程。 |
NixOS 是一个声明式、不可变的 Linux 发行版。关键区别：
/usr/bin、/usr/lib — 所有软件位于 Nix store（/nix/store）apt、yum、pacman — 使用 nix 命令或编辑 /etc/nixos/configuration.nix（或 flake）/etc/default/grub、/etc/fstab — 这些由 NixOS 配置生成nix shell nixpkgs#<pkg> 获取临时工具sudo 正常工作，systemctl 行为与预期一致nixos-rebuild 应用配置变更获取 shell 访问后，验证可用工具：
# 检查现代 nixos CLI（首选）
nixos --help 2>/dev/null && echo "nixos-cli available"
# 检查 nix-command（优于传统 nix-* 命令）
nix --help 2>/dev/null && echo "nix-command available"
始终优先使用现代等位命令：
| 传统命令 | 现代命令（优先） |
|---|---|
nixos-rebuild switch | nixos rebuild switch（有 nixos-cli 时）或 nixos-rebuild switch |
nix-env -iA | nix profile install |
nix-shell | nix shell |
nix-build | nix build |
nix-collect-garbage | nix store gc |
nix-store --optimise | nix store optimise |
nix-channel --update | 使用 flake 则不需要 |
如果有 nixos-cli（软件包 nixos-cli）：
nixos rebuild switch --flake /etc/nixos
nixos generation delete --all # 清理旧 generation
nixos store gc # 垃圾回收
nixos store optimise # 优化 store
如果只有 nix-command：
sudo nixos-rebuild switch --flake /etc/nixos
nix store gc
nix store optimise
NixOS 的 shell 环境极简。需要系统 PATH 之外的命令时：
# 临时 shell，包含所需工具
nix shell nixpkgs#git nixpkgs#ripgrep nixpkgs#curl
# 或进入持久开发 shell
nix develop nixpkgs#<package>
许多 shell 脚本依赖 grep、sed、tr、head、tail、python3 等。
在 NixOS 上这些默认不在 PATH 中。使用 nix shell 的 --command 标志在齐全的环境中运行脚本：
# 单条命令，附带所需包
nix shell nixpkgs#python3 nixpkgs#coreutils nixpkgs#gnused \
nixpkgs#gnugrep nixpkgs#bash --command \
bash -c 'python3 my_script.py arg1 arg2'
# 复杂多步流程
nix shell nixpkgs#python3 nixpkgs#coreutils nixpkgs#gnused \
nixpkgs#gnugrep nixpkgs#bash --command bash -c '
cd /path/to/project
python3 install.py 2>&1
ls -la output/
echo "done"
'
Shell 脚本常用包对照：
| 工具 | 包名 |
|---|---|
python3 | nixpkgs#python3 |
grep、ls、cat、head、tail、wc、tr、sort、mkdir、rm、find | nixpkgs#coreutils |
sed | nixpkgs#gnused |
bash（完整版） | nixpkgs#bash |
awk | nixpkgs#gawk |
git | nixpkgs#git |
systemctl status
systemctl --failed
journalctl -xe
journalctl -u <service-name> -f
cd /etc/nixos
nix flake update
sudo nixos-rebuild switch --flake .
# 删除旧 generation
sudo nixos-rebuild list-generations
sudo nix-env --delete-generations old
# 或用 nixos-cli：
nixos generation delete --all
# 垃圾回收
nix store gc
nix store optimise
sudo systemctl start/stop/restart <service>
sudo systemctl enable/disable <service>
systemctl --user start/stop/restart <service>
nix shell nixpkgs#<cmd>nix 命令未找到？ 二进制文件在 /run/current-system/sw/bin/nix，即使不在 PATH 中也可用完整路径调用environment.systemPackagesnix-env 变更不持久？ nix-env 是命令式的，绕过 NixOS 声明式配置 — 推荐编辑 /etc/nixos//etc/nixos/ 中的文件，然后 sudo nixos-rebuild switchconfiguration.nix 的 environment.systemPackages，然后 rebuildNix 将软件安装在 /nix/store/<hash>-<name>-<version> 中。写入到配置文件
（.gitconfig、.bashrc、systemd unit 等）的绝对 Nix store 路径在系统更新
或 nix store gc 后会立即失效。
gh auth setup-git 会将 gh 的绝对路径写入 ~/.gitconfig：
[credential "https://github.com"]
helper = !/nix/store/pidh15...-gh-2.94.0/bin/.gh-wrapped auth git-credential
GC 回收旧 store 路径后，Git 无法调用凭据助手，回退到交互式终端提示。 非交互环境下直接失败，症状为：
fatal: could not read Username for 'https://github.com': terminal prompts disabled
将硬编码的绝对路径替换为通过 $PATH 查找的命令名：
# 修复前（不稳定）
git config --global credential.https://github.com.helper \
'!/nix/store/xxxx-gh-2.94.0/bin/.gh-wrapped auth git-credential'
# 修复后（持久）
git config --global credential.https://github.com.helper \
'!gh auth git-credential'
规则：任何写入配置文件的 Nix store 绝对路径都会成为定时炸弹。 优先使用裸命令名（依赖
$PATH）或指向/run/current-system/sw/bin/的符号链接（该路径在系统更新时由 NixOS 自动替换）。
检查常见配置文件中是否包含 /nix/store/ 路径：
grep -rn '/nix/store/' ~/.gitconfig ~/.bashrc ~/.zshrc ~/.config/ 2>/dev/null
| 工具 | 陷阱 | 修复 |
|---|---|---|
pip install --user | ~/.local/bin/ 中的脚本 shebang 指向 Nix store Python | 使用 nix shell 或虚拟环境，不要用 pip install --user |
gem install | 同 pip，二进制 stub 指向特定 Ruby 版本 | 使用 nixpkgs 中的 Ruby 包或 bundler |
cargo install | 二进制 hardcode 了构建时的 Nix store rpath | 使用 nixpkgs 中的 Rust 包或 nix build |
systemd unit ExecStart= | 指向 /nix/store/… 的绝对路径 | 使用 lib.getExe pkg 或在 $PATH 中引用 |
按 NixKits 风格为任意项目编写或重新生成完整的多语言文档 — 简洁、表驱动、含语言切换器标题和模块分类 README。覆盖 README、各模块文档及技能文档。
检查 NixKits 所有软件包的上游版本更新并自动应用；将本次修复记入维护日志。检测新版本、更新构建配置、更新文档、报告本地安装版本、撰写修复记录。
为文档撰写技能提供伪中国语（pcn）语言支持。以日语汉字词汇为基础、剥离平假名与片假名、保留日语语序的伪本地化。可被 write-project-docs 自动发现调用。
按 NixKits 规范撰写或更新 MAINTENANCE.md 维护日志。支持软件更新记录和错误修复记录两种类型，自动关联 git commit、生成摘要、五语同步。
将 NixKits 技能安装或更新到编码助手目录（opencode、codewhale、codex、openclaw、agents）。支持本地和在线两种安装模式。
当用户误删 /etc/nixos 目录下的文件（flake.nix、flake.lock 等）时，从 Nix store 中恢复。