Zsh設定の変更・デバッグガイド（~4,600行, dual-stage loading, Zinit）。 エイリアス追加、PATH管理、プラグイン設定、起動時間最適化時に使用。
.zprofile (290行).zprofile
+-- utils.zsh (160行) を最初に source
-> detect_os(), has_command(), safe_path_prepend/append(), setup_locale()
-> XDG Base Directory 設定
-> 環境変数 (EDITOR, PAGER, LESS, etc.)
-> PATH 構築 (safe_path_prepend で重複排除)
-> 開発ツール設定 (Go, Rust, Node, Python, Ruby, etc.)
.zshrc (64行).zshrc
1. P10k instant prompt (WSL: quiet モード)
2. core_settings.zsh (78行) Zsh オプション、履歴設定
3. zinit_setup.zsh (338行) プラグインマネージャ
4. colors_and_prompt.zsh (52行) テーマ、Powerlevel10k
5. keybindings_custom.zsh (79行) カスタムキーバインド
6. functions.zsh (29行) シェル関数
aliases.zsh (334行) エイリアス定義
7. git-worktree.zsh (2,996行) Git Worktree コマンド群
-> unalias gwt* (OMZ git plugin との競合回避)
8. .zshrc.local ローカル設定(存在時)
9. .p10k.zsh, .fzf.zsh プロンプト/fzf
OS固有エイリアス: aliases_darwin.zsh, aliases_linux.zsh,
aliases_freebsd.zsh, aliases_msys.zsh — aliases.zsh から source
utils.zsh)| 関数 | 用途 | 戻り値 |
|---|---|---|
detect_os() | OS検出+キャッシュ | $ZSH_OS_TYPE, $ZSH_IS_WSL |
has_command CMD | コマンド存在チェック+キャッシュ | exit code 0/1 |
safe_path_prepend DIR | PATH先頭に追加（重複排除） | -- |
safe_path_append DIR | PATH末尾に追加（重複排除） | -- |
cleanup_path | typeset -U path で重複排除 | -- |
has_command ガード付き、フォールバック（モダンツール→標準コマンド）safe_path_prepend/safe_path_append で管理（.zprofile に配置）zinit_setup.zsh の setup_* 関数内、wait lucid で遅延読み込みkeybindings_custom.zsh、Emacs モード (bindkey -e)aliases_<os>.zsh に配置（aliases.zsh から自動 source）詳細な知識は references/ を参照:
references/templates.md — エイリアス・PATH・プラグイン追加のテンプレートと実例references/debugging.md — デバッグコマンド、Terminal Color Support、Zinit アーキテクチャ検証用スクリプト。Claude は実行して結果を受け取る（中身を読む必要なし）。
# 設定検証（source チェーン、構文、has_command ガード、PATH管理）
.claude/skills/zsh-config/scripts/validate.sh # 全モジュール
.claude/skills/zsh-config/scripts/validate.sh aliases.zsh # 特定モジュール
# クロスプラットフォーム検証（OS検出、エイリアス分岐、PATH、グレースフル劣化）
.claude/skills/zsh-config/scripts/cross_platform_check.sh
# 起動時間ベンチマーク（閾値判定付き）
.claude/skills/zsh-config/scripts/benchmark.sh # デフォルト: 5回、500ms
.claude/skills/zsh-config/scripts/benchmark.sh --threshold 300 --runs 10
aliases.zsh に has_command ガード付きで追加aliases_<os>.zsh に配置validate.sh で検証.zprofile に safe_path_prepend/safe_path_append で追加export PATH= の直接設定を避けるvalidate.sh で検証zinit_setup.zsh の適切な setup_* 関数内に配置wait lucid で遅延読み込みを設定benchmark.sh で起動時間への影響を測定keybindings_custom.zsh に追加bindkey -e) との整合性を確認validate.sh で構文検証# デバッグモードで読み込みテスト
ZSH_DEBUG=1 zsh -c "source ~/.zprofile && echo OK"
# 起動時間測定
time zsh -i -c exit
詳細は references/debugging.md を参照。