What is pr-and-cleanup?

This Claude skill automates the end-to-end process of creating GitHub Pull Requests and cleaning up Git worktree environments. It streamlines developer workflows by performing safety checks for uncommitted changes, pushing code, generating PRs via GitHub CLI, and removing temporary worktrees. By automating the transition back to the main branch, it ensures a clutter-free and efficient development cycle for engineers managing multiple concurrent tasks.

When should I use pr-and-cleanup?

pr-and-cleanup is useful in the following scenarios: • Streamlining the workflow when a feature is completed in a Git worktree and needs an immediate PR submission and environment cleanup. • Managing multiple active worktrees by providing an automated way to organize, delete, and switch contexts without manual overhead. • Ensuring safety during the development lifecycle by automatically detecting uncommitted or unpushed changes before finalizing a task. • Standardizing the GitHub PR creation process using CLI commands to maintain consistency in branch management and repository hygiene.

name	pr-and-cleanup
description	\|

PR and Cleanup Skill

Purpose

このスキルは、worktree環境での作業完了後のPR作成とクリーンアップを自動化します:

未コミット変更の検出と警告
GitHub Pull Requestの作成
worktreeディレクトリの削除
メインブランチへの自動切り替え
安全な状態への復帰

When to Use

以下の場合にこのスキルを使用:

worktree環境で機能開発が完了した時
PRを作成してworktreeを片付けたい時
作業が中断され、worktreeをクリーンアップしたい時
複数のworktreeを管理していて整理したい時

Instructions

1. Verify Environment

現在の状態を確認:

# worktree内で実行されているか確認
git worktree list | grep "$(pwd)"

# 現在のブランチを確認
git branch --show-current

# 未コミット変更の確認
git status --short

2. Check for Uncommitted Changes

変更があるか確認:

if [ -n "$(git status --porcelain)" ]; then
  echo "⚠️ Uncommitted changes detected"
  git status
  # ユーザーに確認を求める
fi

対応オプション:

コミットしてから続行
変更を破棄して続行（--force オプション）
操作をキャンセル

3. Ensure Changes are Pushed

リモートとの同期を確認:

# プッシュされていないコミットがあるか確認
if [ -n "$(git log @{u}.. 2>/dev/null)" ]; then
  echo "⚠️ Unpushed commits detected"
  # 自動的にプッシュするか確認
fi

4. Create Pull Request

GitHub CLIでPRを作成:

# 基本的なPR作成（インタラクティブ）
gh pr create

# または、タイトルと説明を指定
gh pr create \
  --title "feat: add user authentication" \
  --body "This PR implements basic user authentication using JWT tokens."

# ドラフトPRとして作成
gh pr create --draft

# ベースブランチを指定
gh pr create --base develop

PR作成前の確認事項:

CI/CDが実行されているか
適切なラベルやレビュアーの指定
PRテンプレートの内容確認

5. Clean Up Worktree

PR作成成功後、worktreeを削除:

# 現在のworktreeパスを取得
WORKTREE_PATH=$(git worktree list | grep "$(git branch --show-current)" | awk '{print $1}')

# メインブランチに戻る前に、ベースディレクトリ（リポジトリルート）を確認
REPO_ROOT=$(git rev-parse --show-toplevel)

# メインブランチ（または指定されたブランチ）にチェックアウト
cd "$REPO_ROOT"
git checkout main  # または develop など

# worktreeを削除
git worktree remove "$WORKTREE_PATH"

6. Report Status

完了後、以下の情報をユーザーに提供:

✅ PR作成とクリーンアップが完了しました

**PR URL:** <pr-url>
**削除したworktree:** <worktree-path>
**現在のブランチ:** main

**次のステップ:**
1. PRのレビューを依頼
2. CI/CDの結果を確認
3. レビューコメントに対応
4. マージ準備が整ったらマージ

**便利なコマンド:**
- `gh pr view` - 現在のブランチのPRを表示
- `gh pr checks` - CI/CDステータスを確認
- `gh pr merge` - PRをマージ（承認後）

7. Handle Edge Cases

Case 1: PR作成のみ（worktreeは残す）

# --pr-only オプションを使用
./pr_and_cleanup.sh --pr-only

Case 2: クリーンアップのみ（PRは作成済み）

# --cleanup-only オプションを使用
./pr_and_cleanup.sh --cleanup-only

Case 3: 強制実行（未コミット変更を無視）

# --force オプション（非推奨）
./pr_and_cleanup.sh --force

Key Principles

安全性優先: 未コミット変更がある場合は警告
柔軟性: PR作成とクリーンアップを個別に実行可能
透明性: すべての操作を明示的にユーザーに報告
可逆性: ブランチは削除せず、必要に応じて復元可能

Customization Options

ユーザーが以下をカスタマイズしたい場合は質問して確認:

ベースブランチ: PRのマージ先（main, develop, staging など）
戻り先ブランチ: クリーンアップ後にチェックアウトするブランチ
PRテンプレート: カスタムテンプレートの使用
ブランチ削除: リモートブランチも削除するかどうか

Dependencies

Git 2.5+ (worktree機能のサポート)

GitHub CLI (gh) - PR作成に必須

# インストール
brew install gh

# 認証
gh auth login

Integration with Other Skills

create-worktree: このスキルで作成したworktreeのクリーンアップ
code-review: PR作成後のコードレビュー実施

Best Practices

作業の完了確認: PR作成前にすべての変更がコミット済みか確認
CI/CDの確認: PR作成後、すぐにCI/CDステータスを確認
ブランチの整理: マージ済みのブランチは定期的に削除
ドラフトPRの活用: 作業中はドラフトPRで進捗を共有

Common Issues and Solutions

Issue 1: GitHub CLIが未認証

error: authentication required

Solution: GitHub CLIで認証を実行

gh auth login
# ブラウザまたはトークンで認証

Issue 2: worktreeディレクトリ内からの実行に失敗

fatal: cannot remove path when it is in the current directory

Solution: スクリプトが自動的にリポジトリルートに移動してから削除

# スクリプト内で処理済み
cd "$REPO_ROOT"
git worktree remove "$WORKTREE_PATH"

Issue 3: リモートブランチが存在しない

error: branch 'feature/xxx' has no upstream branch

Solution: 最初にリモートにプッシュ

git push -u origin $(git branch --show-current)

Issue 4: PR作成時にベースブランチが見つからない

Solution: ベースブランチを明示的に指定

gh pr create --base develop

Advanced Options

ブランチも削除する場合

PR作成とクリーンアップ後、ローカル・リモートブランチも削除:

# PRマージ後に実行
gh pr merge --auto --squash
git worktree remove <worktree-path>
git branch -D <branch-name>
git push origin --delete <branch-name>

複数worktreeの一括クリーンアップ

# すべてのworktreeを一覧表示
git worktree list

# 不要なworktreeを削除
git worktree remove <path1>
git worktree remove <path2>

# staleなworktreeをクリーンアップ
git worktree prune

Notes

worktreeを削除してもブランチは残るため、必要に応じて再度worktreeを作成可能
PRをマージした後、ブランチを削除するのはGitHub側の設定で自動化可能
gh pr create はリポジトリのPRテンプレートを自動的に使用
ドラフトPRは通常のPRに後から変換可能

pr-and-cleanup

When & Why to Use This Skill

Use Cases