菜单
この dotfiles (Nix / nix-darwin / home-manager) へ変更を加えるときの手順。 パッケージの追加・削除、エイリアスやシェル設定の変更、ツールのバージョン pin、 マシンの追加、home-manager のプログラム設定の追加・変更を行うときは必ず使うこと。 「〜をインストールして」「〜を追加して」「エイリアスを足して」「〜を pin して」 「新しいマシンを追加」「Dock/Finder の設定を変えて」のような依頼はすべて該当する。 inputs の更新やアップデート作業は nix-update スキルを使う。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | dotfiles-edit |
| description | この dotfiles (Nix / nix-darwin / home-manager) へ変更を加えるときの手順。 パッケージの追加・削除、エイリアスやシェル設定の変更、ツールのバージョン pin、 マシンの追加、home-manager のプログラム設定の追加・変更を行うときは必ず使うこと。 「〜をインストールして」「〜を追加して」「エイリアスを足して」「〜を pin して」 「新しいマシンを追加」「Dock/Finder の設定を変えて」のような依頼はすべて該当する。 inputs の更新やアップデート作業は nix-update スキルを使う。 |
変更の種類ごとに置き場所が決まっている。迷ったら既存ファイルの書き方に合わせる。
| やりたいこと | 場所 |
|---|---|
| CLI ツールのインストール | users/upamune/packages.nix (カテゴリコメントの下に追加) |
| home-manager モジュールがあるツールの設定 | users/upamune/cli.nix の programs.* |
| git / delta / gh の設定 | users/upamune/git.nix |
| zsh の宣言的設定 (履歴・キーマップ・補完初期化) | users/upamune/zsh.nix |
| zsh のエイリアス・関数・PATH | users/upamune/zshrc |
| プロンプト | users/upamune/starship.nix |
| 全マシン共通のシステムパッケージ | modules/common.nix |
| macOS システム設定 (Finder / Dock / キーボード) | machines/darwin.nix |
| WSL (NixOS) の設定 | machines/wsl.nix |
| パッケージのバージョン pin・差し替え | overlays/ に1ファイル追加 + overlays/default.nix に登録 |
| マシンの追加 | machines/<name>.nix を作成 + flake.nix で mkSystem を1回呼ぶ |
| ユーザー設定ファイルの追加 | users/upamune/ にファイル追加 + home.nix の imports に登録 |
lib/mksystem.nix は全マシン共通の組み立てロジック。個別の設定は入れない。
~/.zshrc.local に置く (リポジトリ管理外、
zshrc の末尾で読み込まれる)。pre-commit で gitleaks が走るが、頼り切らないこと。home.packages に生で足すより
programs.<tool>.enable = true を優先する (設定も宣言的に管理できるため)。zsh.nix に書く。
compinit / キーマップ / 履歴は home-manager が管理しているので zshrc で重複させない。変更したら必ず以下を通す。新規ファイルは git add しないと flake から見えない
(untracked のままだと "path does not exist" になる)。
git add -A
export NIX_USER=$(whoami) NIX_HOST=$(hostname -s)
nix flake check --impure
nix build .#darwinConfigurations.$NIX_HOST.system --impure --dry-run
make lint && make fmt
パッケージ追加が本当に反映されるかは nix eval でも確認できる:
nix eval --impure ".#darwinConfigurations.\"$NIX_HOST\".config.home-manager.users.\"$NIX_USER\".home.packages" \
--apply 'ps: builtins.filter (n: builtins.match ".*<パッケージ名>.*" n != null) (map (p: p.name) ps)'
make switch (sudo が必要)。Claude からは実行できないので、
ユーザーに ! make switch を案内する。