Worktree Management with gtr
gtr (git-worktree-runner) を使用して git worktree を管理するスキル。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-git:worktree - Worktree Management with gtr
概要:
gtr を使用して worktree の作成・一覧・削除・クリーンアップを行う。
使用方法:
/shiiman-git:worktree [オプション]
オプション:
--help このヘルプを表示
対応コマンド:
new 現在のブランチから worktree を作成
list worktree の一覧を表示
rm worktree をブランチごと削除
clean 不要な worktree をクリーンアップ
前提条件
- gtr (git-worktree-runner) がインストール済み
- 未インストールの場合は
git-worktree-setupスキルを案内する
- 未インストールの場合は
機能
ユーザーの発話内容から以下の 3 パターンを判定して実行する。
1. worktree 作成
トリガー: 「worktree 作成」「gtr new」「新しい worktree」「ワークツリー作成」
現在のブランチをベースに worktree を作成する。
git gtr new <branch> --from-current
処理フロー:
- ブランチ名を確認(指定がない場合はユーザーに質問)
git gtr new <branch> --from-currentを実行- 成功メッセージを表示
2. worktree 一覧
トリガー: 「worktree 一覧」「gtr list」「ワークツリー一覧」「worktree 確認」
git gtr list
結果をテーブル形式に整形して表示:
## Worktree 一覧
| ブランチ | パス |
|----------|------|
| main | /path/to/main |
| feature/A | /path/to/feature-A |
3. worktree 削除 + クリーンアップ
個別削除
トリガー: 「worktree 削除」「gtr rm」「ワークツリー削除」「worktree を消す」
ブランチごと複数 worktree をまとめて削除する。
git gtr rm <branch1> <branch2> --delete-branch
処理フロー:
- 削除対象のブランチ名を確認(
git gtr listで一覧を提示) - ユーザー確認後に
--delete-branch付きで削除実行 - 成功メッセージを表示
クリーンアップ
トリガー: 「クリーンアップ」「マージ済み削除」「不要な worktree を整理」
不要な worktree を一括削除する。
git gtr clean
処理フロー:
- まず
git gtr clean --dry-runでプレビューを表示 - ユーザー確認後に
git gtr cleanを実行 - 成功メッセージを表示
エラーハンドリング
gtr がインストールされていない場合
gtr がインストールされていません。
`/shiiman-git:worktree-setup` でインストールと設定ができます。
worktree 削除時に未コミット変更がある場合
警告を表示し、--force オプションの使用を提案する。
関連リソース
- gtr 公式リポジトリ: https://github.com/coderabbitai/git-worktree-runner
- 関連スキル:
worktree-setup- gtr のインストールと .gtrconfig 設定