Skip to content

docs: git-worktreeスキルでシンボリックリンク作成を必須化 #119

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sh1ma merged 1 commit into from
Jan 12, 2026
Merged

docs: git-worktreeスキルでシンボリックリンク作成を必須化 #119

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions .claude/skills/git-worktree/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ Git worktreeを使って並列開発を支援するスキル。

**作業を開始する前に、必ずこのスキルを使ってworktreeとブランチを作成すること。**

**worktree作成後は、必ず `.claude/settings.local.json` のシンボリックリンクを作成すること。** この手順は必須である。スキップしてはならない。シンボリックリンクを作成することで、MCP/コマンド/スキルの許可設定が全worktree間で確実に共有される。

## ブランチ命名規則

Conventional Commitに準じた形式でブランチ名を付ける:
Expand Down Expand Up @@ -53,7 +55,8 @@ ls worktrees 2>/dev/null || mkdir -p worktrees
# 2. 新しいブランチとworktreeを同時に作成
git worktree add worktrees/<branch-name> -b <type>/<short-description>

# 3. Claude設定のシンボリックリンクを作成（絶対パスを使用）
# 3. 【必須】Claude設定のシンボリックリンクを作成（絶対パスを使用）
# この手順は必ず実行すること。スキップ不可。
# メインリポジトリのルートディレクトリを取得
MAIN_REPO=$(git worktree list --porcelain | grep -m 1 "worktree" | cut -d' ' -f2)
# 既存のsettings.local.jsonを削除してからシンボリックリンクを作成
Expand All @@ -62,6 +65,7 @@ ln -s "${MAIN_REPO}/.claude/settings.local.json" worktrees/<branch-name>/.claude

# 例: feat/add-dark-mode ブランチとworktreeを作成
git worktree add worktrees/add-dark-mode -b feat/add-dark-mode
# 【必須】シンボリックリンク作成（この手順を忘れないこと）
MAIN_REPO=$(git worktree list --porcelain | grep -m 1 "worktree" | cut -d' ' -f2)
rm -f worktrees/add-dark-mode/.claude/settings.local.json
ln -s "${MAIN_REPO}/.claude/settings.local.json" worktrees/add-dark-mode/.claude/settings.local.json
Expand Down Expand Up @@ -95,7 +99,7 @@ git worktree add worktrees/<worktree-name> <existing-branch>
2. 適切なブランチ名を決定する（type/short-description形式）
3. worktreeを作成する
4. メインリポジトリのパスを取得する（`git worktree list --porcelain`を使用）
5. 既存のsettings.local.jsonを削除してから、Claude設定のシンボリックリンクを絶対パスで作成する（settings.local.jsonをメインリポジトリから参照）
5. **【必須】既存のsettings.local.jsonを削除してから、Claude設定のシンボリックリンクを絶対パスで作成する（settings.local.jsonをメインリポジトリから参照）。この手順は必ず実行すること。**
6. 作成したworktreeのパスを報告する
7. 作業完了後、worktreeの削除を案内する

Expand Down