Dotfiles Skill Sync

この skill は、このリポジトリを clone した作業ツリーのルートで使う。同期対象の唯一の真実は setup.yaml で、setup.sh はそれを適用するだけのエンジン。setup.yaml と dotfiles/、skills/ を基準に、端末固有の変更を壊さずに dotfiles と skills を同期する。端末へ配る skill は repo root の skills/ にあり、gh skill で管理する。

Core Rule

既存ファイルを確認せずに上書きしない。削除、秘匿情報を含む可能性がある内容の取り込み、競合解消、外部コマンドのインストールは、判断材料を示してから必要に応じてユーザーに確認する。

Initial Checks

1. 現在地がこの repo の root か確認する。
   • test -f setup.yaml && test -f setup.sh && test -d dotfiles && test -d skills
   • 違う場合は repo root へ移動してから続ける。
2. 作業ツリーを確認する。
   • git status --short
   • ユーザーの未コミット変更を上書きしない。
3. setup.yaml を読み、同期対象の全体像を把握する。./setup.sh --check で repo との整合性を検証する。
4. repo root の MEMORY.md(git 管理外の判断メモ)を読む。存在しなければ references/sync-memory.md のテンプレートで作成する。

Read First

必要な作業に応じて reference を読む。

• references/repository-map.md: setup.yaml の構造、skill 配置、注意が必要な対象を確認する。
• references/sync-workflow.md: 調査、分類、マージ、削除確認、検証の具体的な手順を確認する。
• references/history.md: 過去バージョンを辿る場面と git log / git show の使い方を確認する。
• references/sync-memory.md: MEMORY.md の形式、記録・参照・整理のルールを確認する。

Workflow

1. リポジトリ状態を確認する。
   • git status --short
   • git log --oneline --decorate --max-count=20 -- setup.yaml setup.sh dotfiles skills .claude/skills/dotfiles-skill-sync
   • setup.yaml、dotfiles/、skills/ の現在内容
2. 端末側の対象ファイルを棚卸しする。対象一覧はここに書かれていない。setup.yaml の files / dirs / git_clones の端末側パスと zshrc_source の各行、および ${ZDOTDIR:-$HOME}/.zshrc を、manifest から導出して確認する。
3. 各差分を分類する。
   • Repository update: 一般化でき、秘匿情報を含まず、このリポジトリに取り込むべき変更。
   • Local keep: 端末固有、秘密情報、個人パス、業務固有値など、外に持ち出さず維持する変更。
   • Merge needed: repo 版と local 版の両方に意味がある変更。
   • Remove candidate: setup.yaml や現行 dotfiles から外れ、古くなった可能性があるファイルや設定。
4. MEMORY.md と突き合わせ、記録済みの判断を適用する。
   • 記録があり、差分の内容も記録時から変わっていない対象は、再確認せず記録どおりに扱う。計画には「記録済み」として載せる。
   • 差分が記録時から変わっている対象は、記録があっても再確認する。
5. 同期計画を短く提示する。
   • 取り込むもの、ローカルに残すもの、マージするもの、削除候補を分ける。
   • 削除候補は必ずユーザー確認を得る。
   • 秘匿情報の可能性がある差分は内容をそのまま表示しすぎず、キー名や構造だけで確認する。
6. 合意済みの変更だけ実施する。
   • repo に入れる変更は dotfiles/、skills/、setup.yaml、または関連 skill に反映する。配布対象の追加・削除は setup.yaml だけを編集し、engine である setup.sh は挙動変更が必要なときだけ触る。
   • 端末へ反映する変更は、端末版に repo 版と衝突する独自の変更がある場合(Merge needed)だけ、適用前に端末版を一時退避する。端末版が repo 版と同一、または単に古いだけなら退避せずに上書きする。
   • skills/ 配下の端末反映は手動コピーではなく gh skill install ./skills --from-local --agent <agent> --scope user --force で行う。repo root(.)ではなく ./skills を指す。root を指すと cc-plugins/*/skills の skill まで拾われる。対象と agent は setup.yaml の skills セクションから導出し、エントリが all なら --all、個別 skill なら skill 名を指定する(setup.sh の install_skills と同じ形)。他 repo 由来の skill は remote_skills セクションから導出し、gh skill install <owner/repo> <skill> --agent <agent> --scope user --force で行う(install_remote_skills と同じ形)。
   • .zshrc への追記は重複しないように検査してから行う。
7. 検証する。
   • ./setup.sh --check
   • git diff --check
   • 変更した Markdown / shell / YAML / TOML / JSON の構文確認
   • 必要なら bash -n setup.sh、zsh -n、jq、git config --get などの軽量検証
8. 今回ユーザーが確定した判断のうち、次回も再確認になり得るもの(Local keep、削除見送りなど)を MEMORY.md に記録する。書式と記録対象は references/sync-memory.md に従う。

Confirmation Rules

必ず確認する操作:

• 端末側ファイルの削除、移動、破壊的な上書き
• 秘密情報、トークン、個人メール、社内 URL、個人パスを repo に取り込む可能性がある変更
• curl | sh、npm install -g、playwright install-deps、apt install などネットワークや管理者権限を使う操作
• 既存 skill や plugin の削除

確認なしで進めてよい操作:

• 読み取り、差分確認、構文確認
• repo 内でのこの skill / reference の改善
• 明らかな typo 修正

Output Style

日本語で、判断単位ごとに短く報告する。差分が多い場合は表にして、対象, 分類, 理由, 提案, 確認要否 を示す。