symlink-manage スキル

Name: Symlink Manage
Rating: 76
Author: snkrheadz

dotfilesのシンボリックリンク管理を行う。

管理対象のシンボリックリンク

ターゲット	ソース（laptop repo）
`~/.zshrc`	`zsh/.zshrc`
`~/.aliases`	`zsh/.aliases`
`~/.zsh/`	`zsh/.zsh/`
`~/.gitconfig`	`git/.gitconfig`
`~/.gitmessage`	`git/.gitmessage`
`~/.gitignore`	`git/.gitignore_global`
`~/.tmux.conf`	`tmux/.tmux.conf`
`~/.tigrc`	`tig/.tigrc`
`~/.fzf.zsh`	`fzf/.fzf.zsh`
`~/.fzf.bash`	`fzf/.fzf.bash`
`~/.config/ghostty/config`	`ghostty/config`
`~/.config/mise/config.toml`	`mise/config.toml`
`~/.claude/`	`claude/` (部分的)

コマンド

全symlink状態確認

bash

LAPTOP_DIR="/Users/snkrheadz/ghq/github.com/snkrheadz/laptop"

echo "=== Symlink Status ==="
declare -A SYMLINKS=(
  ["$HOME/.zshrc"]="$LAPTOP_DIR/zsh/.zshrc"
  ["$HOME/.aliases"]="$LAPTOP_DIR/zsh/.aliases"
  ["$HOME/.zsh"]="$LAPTOP_DIR/zsh/.zsh"
  ["$HOME/.gitconfig"]="$LAPTOP_DIR/git/.gitconfig"
  ["$HOME/.gitmessage"]="$LAPTOP_DIR/git/.gitmessage"
  ["$HOME/.gitignore"]="$LAPTOP_DIR/git/.gitignore_global"
  ["$HOME/.tmux.conf"]="$LAPTOP_DIR/tmux/.tmux.conf"
  ["$HOME/.tigrc"]="$LAPTOP_DIR/tig/.tigrc"
  ["$HOME/.fzf.zsh"]="$LAPTOP_DIR/fzf/.fzf.zsh"
  ["$HOME/.fzf.bash"]="$LAPTOP_DIR/fzf/.fzf.bash"
  ["$HOME/.config/ghostty/config"]="$LAPTOP_DIR/ghostty/config"
  ["$HOME/.config/mise/config.toml"]="$LAPTOP_DIR/mise/config.toml"
)

for link in "${!SYMLINKS[@]}"; do
  target="${SYMLINKS[$link]}"
  if [ -L "$link" ]; then
    actual=$(readlink "$link")
    if [ "$actual" = "$target" ]; then
      echo "[OK] $link"
    else
      echo "[WRONG TARGET] $link -> $actual (expected: $target)"
    fi
  elif [ -e "$link" ]; then
    echo "[NOT SYMLINK] $link"
  else
    echo "[MISSING] $link"
  fi
done

特定symlinkの確認

bash

ls -la ~/.zshrc
readlink ~/.zshrc

壊れたsymlinkの検出

bash

find ~ -maxdepth 3 -type l ! -exec test -e {} \; -print 2>/dev/null

symlinkの再作成（単一ファイル）

bash

# 例: ~/.zshrc の再作成
rm -f ~/.zshrc
ln -sf /Users/snkrheadz/ghq/github.com/snkrheadz/laptop/zsh/.zshrc ~/.zshrc

全symlinkの再作成（install.sh経由）

bash

cd /Users/snkrheadz/ghq/github.com/snkrheadz/laptop && ./install.sh

実行フロー

状態確認

•全symlinkのステータスを確認
•壊れたリンクを特定
•問題のあるリンクを報告

修復

•問題のあるsymlinkを特定
•ユーザーに確認
•個別に再作成、または install.sh を推奨

使用例

•"symlinkの状態を確認"
•"リンク切れがないかチェック"
•"~/.zshrcのリンクを確認"
•"壊れたリンクを修復"
•"symlinkを再作成"

safe_ln関数（install.shより）

install.shでは以下のsafe_ln関数を使用してsymlinkを作成:

bash

safe_ln() {
  local src="$1"
  local dest="$2"

  # 既存のシンボリックリンクまたはファイルを削除
  if [ -L "$dest" ] || [ -e "$dest" ]; then
    rm -rf "$dest"
  fi

  # 親ディレクトリを作成
  mkdir -p "$(dirname "$dest")"

  # シンボリックリンクを作成
  ln -sf "$src" "$dest"
}

注意事項

•既存ファイル（非symlink）がある場合、上書き前にバックアップ推奨
•install.shを使えば全symlinkを一括で再作成可能
•~/.zsh/ はディレクトリ全体をsymlink
•Claude設定は claude/ 配下のファイルを個別にsymlink