Git Worktree from Issue スキル

このスキルは、既存の GitHub Issue から Git Worktree を使って作業ブランチを作成する標準手順を提供します。

⚠️ 重要な禁止事項

• •master（またはmain）ブランチで直接コード修正を行わない
• •master ブランチで git commit や git push を提案しない
• •既存Issueから作業を開始する際は、必ずこのスキルを使用する

実行手順

0. 古い Worktree の自動掃除

前回のセッションで削除が遅延された Worktree がある場合、自動的に削除する:

bash ~/.claude/skills/gh-pr-approve/cleanup-stale-worktrees.sh

出力がない場合は掃除不要。

1. 引数の確認とIssue取得

引数がある場合（例: /gh-worktree-from-issue 123）:

• •指定されたIssue番号の詳細を取得
• •mcp__github__issue_read を使用

引数がない場合:

• •リポジトリのOpen状態のIssue一覧を取得
• •mcp__github__search_issues で検索
• •ユーザーに選択肢を提示

Issue一覧の表示例:

以下のOpen Issueが見つかりました:

1. #123 - プレビュー機能の追加 (feature)
2. #124 - パースエラーの修正 (bug)
3. #125 - ドキュメント更新 (documentation)

どのIssueで作業を開始しますか？番号を入力してください:

2. Issueタイトルからブランチ名を自動生成

Issue情報から適切なブランチ名を生成する。

生成ルール:

1. •Issueのラベルまたはタイトルから feature or fix を判定
   • •ラベルに bug, fix, hotfix が含まれる → fix/
   • •それ以外 → feature/
2. •Issue番号を必ず含める: issue-<番号>
3. •タイトルから主要なキーワードを抽出（英数字、ハイフン区切り）

生成例:

Issue #123: "プレビュー機能の追加" (ラベル: enhancement)
  → feature/issue-123-preview-feature

Issue #456: "Fix: パースエラーの修正" (ラベル: bug)
  → fix/issue-456-parse-error

Issue #789: "ドキュメント更新" (ラベル: documentation)
  → feature/issue-789-document-update

日本語タイトルの英語変換例（簡易的）:

• •"追加" → "add"
• •"修正" → "fix"
• •"更新" → "update"
• •"改善" → "improve"
• •"削除" → "remove"

3. Git リポジトリ情報の取得

現在のリポジトリ名を取得する:

git remote -v

プロジェクト名を抽出（例: claude-code-config）

4. Git Worktree コマンドの実行

生成したブランチ名でWorktreeを作成する:

git worktree add ../<プロジェクト名>-<ブランチ種別> <ブランチ名>

具体例:

# Issue #123 (feature) の場合
git worktree add ../claude-config-feature feature/issue-123-preview-feature

# Issue #456 (fix) の場合
git worktree add ../claude-config-fix fix/issue-456-parse-error

5. 作業ディレクトリへの移動

Worktree ディレクトリへの移動コマンドを実行:

cd ../<プロジェクト名>-<ブランチ種別>

5a. 空コミットを作成して push

Worktree 作成直後は差分がないため、空コミットでブランチをリモートに push する：

git commit --allow-empty -m "chore: start work on #<Issue番号>"
git push -u origin <ブランチ名>

5b. Draft PR を作成

mcp__github__create_pull_request で Draft PR を作成する（draft: true を指定）：

• •title: WIP: <Issueタイトル>
• •body: Closes #<Issue番号>\n\n作業中...
• •head: <ブランチ名>
• •base: main（または master）
• •draft: true

フォールバック: mcp__github__create_pull_request が draft パラメータをサポートしない場合：

gh pr create --draft --title "WIP: <Issueタイトル>" --body "Closes #<Issue番号>

作業中..."

5c. クリップボードにコピー

Worktree の絶対パスを取得し、クリップボードにコピーする：

WORKTREE_ABSPATH="$(cd ../<プロジェクト名>-<ブランチ種別> && pwd)"
bash ~/.claude/skills/_shared/copy-to-clipboard.sh "cd ${WORKTREE_ABSPATH} && claude"

• •コマンドが 成功 した場合 → 完了メッセージに「📋 クリップボードにコピー済み」と表示
• •コマンドが 失敗 した場合 → 完了メッセージに「⚠ 手動でコピーしてください」と表示し、コピー用テキストをそのまま表示

6. 作業開始の確認メッセージ

ユーザーに以下のメッセージを表示:

Issue #<番号> から作業を開始しました。

Issue: <タイトル>
ブランチ: <ブランチ名>
作業ディレクトリ: ../<プロジェクト名>-<ブランチ種別>
Draft PR: #<PR番号>

📋 クリップボードにコピー済み: cd <Worktreeの絶対パス> && claude
新しいターミナルで貼り付けて作業を開始してください。

作業完了後は `/gh-pr-create` で Draft PR を Ready for Review に変更してください。

実行例

# ユーザー入力: /gh-worktree-from-issue 123

# 1. Issue #123 の情報を取得
# タイトル: "プレビュー機能の追加"
# ラベル: enhancement

# 2. ブランチ名を生成
# → feature/issue-123-preview-feature

# 3. Worktree を作成
git worktree add ../claude-config-feature feature/issue-123-preview-feature

# 4. ディレクトリに移動
cd ../claude-config-feature

# 5a. 空コミット + push
git commit --allow-empty -m "chore: start work on #123"
git push -u origin feature/issue-123-preview-feature

# 5b. Draft PR を作成
# mcp__github__create_pull_request で Draft PR を作成
# → Draft PR #124 作成

# 6. 確認メッセージを表示
# "Issue #123 から作業を開始しました..."

Worktree のメリット

• •✅ ブランチ切り替え時のファイル変更が不要
• •✅ ビルドや node_modules 再構築が不要
• •✅ 緊急対応が入っても作業中のコードを退避する必要がない
• •✅ 複数の作業を並行して進められる

注意事項

• •Issue番号は必ずブランチ名に含める（後でPR作成時に紐付けるため）
• •Worktreeを削除する前にコミット・プッシュを忘れずに行う
• •.git フォルダは元のリポジトリで共有される
• •PRマージ後は忘れずにWorktreeを削除する

次のステップ

作業完了後は、以下のスキルを使用して Draft PR を Ready for Review に変更:

• •/gh-pr-create - 既存 Draft PR を検出して Ready for Review に変更（Draft PR がない場合は新規作成）

Worktree 一覧の確認

必要に応じて、以下のコマンドで現在のWorktree一覧を確認できる:

git worktree list