mirror-dotfiles

name	mirror-dotfiles
description	ローカル設定→dotfiles repo の triage 同期。$HOME の設定ファイルを変更後 repo へ反映したい時に使用。差分を commit/skip/sanitize 対話判断し、ハードコードパス/secrets を除去して ~/.dotfiles に commit & push。

/mirror-dotfiles

$HOME の管理対象ファイルと ~/.dotfiles/ を比較し、triage しつつ repo に反映する。

管理対象

以下のファイル/ディレクトリのみ対象（dotfiles repo に存在するもの）:

$HOME/.zshrc                          ↔ ~/.dotfiles/.zshrc
$HOME/.bashrc                         ↔ ~/.dotfiles/.bashrc
$HOME/.bash_profile                   ↔ ~/.dotfiles/.bash_profile
$HOME/.profile                        ↔ ~/.dotfiles/.profile
$HOME/.gitconfig                      ↔ ~/.dotfiles/.gitconfig
$HOME/Brewfile                        ↔ ~/.dotfiles/Brewfile
$HOME/.config/shell/env.sh            ↔ ~/.dotfiles/.config/shell/env.sh
$HOME/.config/shell/aliases.sh        ↔ ~/.dotfiles/.config/shell/aliases.sh
$HOME/.config/fish/config.fish        ↔ ~/.dotfiles/.config/fish/config.fish
$HOME/.config/fish/fish_plugins       ↔ ~/.dotfiles/.config/fish/fish_plugins
$HOME/.config/starship.toml           ↔ ~/.dotfiles/.config/starship.toml
$HOME/.config/mise/config.toml        ↔ ~/.dotfiles/.config/mise/config.toml
$HOME/.config/gh/config.yml           ↔ ~/.dotfiles/.config/gh/config.yml
$HOME/.config/karabiner/karabiner.json ↔ ~/.dotfiles/.config/karabiner/karabiner.json
$HOME/.config/git/ignore              ↔ ~/.dotfiles/.config/git/ignore

対象外（同期しない）:

• ~/.config/gh/hosts.yml — auth 情報
• ~/.ssh/ — 別 repo (ukwhatn/.ssh) で管理
• ~/.claude/ — Claude Code state（別 repo）
• ~/.config/fish/functions/ — fisher 生成物 + 別 repo の混在
• ~/.config/fish/conf.d/* — fisher 自動生成
• 上に列挙されていない任意の ~/.config/* 配下のファイル

ワークフロー

Step 1. 差分検出

各管理対象ファイルについて diff $HOME/<path> ~/.dotfiles/<path> を取得。 状態を 4 分類:

状態	意味	デフォルトアクション
identical	差分なし	何もしない
local-only	$HOME のみに存在	dotfiles に新規追加候補（要 triage）
dotfiles-only	~/.dotfiles/ のみに存在	$HOME にデプロイ漏れ（rsync 推奨）
diff	内容差分あり	要 triage

Step 2. ユーザに差分提示

各 diff / local-only について以下を提示し、選択肢を渡す:

[N/M] ~/.zshrc
─────────────────────────────────
- # Rancher Desktop ブロック
- export PATH="/Users/yuki.c.watanabe/.rd/bin:$PATH"
+ (なし)
─────────────────────────────────
Action: [c]ommit / [s]kip / [z]sanitize / [v]iew full / [e]dit

• commit: diff をそのまま ~/.dotfiles/ 側に反映
• skip: local 固有のためrepo に入れない。次へ進む
• sanitize: Claude が triage（ハードコードパス除去 / secrets 削除 / コメント整形）してから反映
  • 例: /Users/<user>/path → $HOME/path または ~/path に書換
  • 例: signingkey ssh-ed25519 AAAA... → 削除（user が個別設定）
  • 例: API token / credentials → 削除
• view full: 全ファイル内容を表示
• edit: user が手動で repo 側を編集

Step 3. Sanitize の判断基準

Claude は以下のパターンを自動検出し、sanitize 候補を user に提案:

パターン	処理
/Users/<username>/...	$HOME/... または ~/... に置換
ssh-ed25519 AAAA...（gitconfig signingkey）	削除 + コメントで「個別設定」と明記
MANAGED BY RANCHER DESKTOP ブロック	削除（dotfiles 管理対象外）
password = ..., token = ..., api_key = ...	削除 + 警告
*.dena.com, *.dena.jp メール	削除（業務 local 設定）
~/google-cloud-sdk/path.bash.inc 等の絶対パス	削除（gcloud は最小構成から外したため）

検出後、user に確認:

sanitize 候補:
  L12: /Users/watanabe-yuki3/.bun → $HOME/.bun に書換
  L18: signingkey ssh-ed25519 AAAA... → 削除（ユーザ個別設定）
適用する？ [y/n/edit]

Step 4. dotfiles repo に反映 + commit

すべての triage 完了後:

cd ~/.dotfiles
git add -A
git status
git diff --cached

user に最終確認 → commit メッセージ生成（git-cz 風、prefix 以外は日本語）:

chore: 設定ファイルをローカル状態と同期

- .zshrc に bun completions を追記
- .config/fish/config.fish に <変更>

push:

git push origin main

安全装置

• dotfiles repo の状態確認: 開始前に git status で uncommitted changes 有無を確認、あれば user 確認
• dry-run option: skill 起動時 user が「dry-run」と指定したら、commit/push せず diff 確認のみ
• secrets スキャン: token/password らしき文字列は必ず警告
• rollback: 直前の commit に戻したい場合は git reset --soft HEAD~1 を提示

制限

• バイナリファイルは対象外（textual config のみ）
• ~/.config/karabiner/karabiner.json は JSON だが diff 可能
• ~/.dotfiles/scripts/ ~/.dotfiles/README.md ~/.dotfiles/.claude/ は対象外（mirror 不要、user が直接編集）

実行例

user: /mirror-dotfiles

claude:
[1/15] ~/.zshrc - identical, skip
[2/15] ~/.bashrc - identical, skip
[3/15] ~/.gitconfig - DIFF detected:
  ローカル side に signingkey = ssh-ed25519 AAAA... が追加
  Action [c/s/z/v/e]: z

claude: sanitize 提案:
  L4: 削除 (signingkey は user 個別設定とコメント化)
  適用? [y/n]: y

[4/15] ~/Brewfile - identical, skip
...

15個中 1個更新。
変更内容:
  modified: .gitconfig  (signingkey コメント化)

commit する？ [y/n]: y
commit message:
  chore: .gitconfig の signingkey をテンプレ化

push する？ [y/n]: y
✅ pushed to origin/main