AgentSkillsCN

git-worktree

助力使用 Git Worktree 实现并行开发。通过 git gtr 命令对工作树进行操作。 【必触发关键词】当发言中包含以下内容时，务必调用此技能： - 「worktree」「工作树」 - 「在不同分支上开展工作」「在不同仓库中进行操作」 - 「在 main 分支上进行测试」「在 main 分支上进行验证」「在 main 分支上完成构建」 - 「查看 PR #XXX」「检查 PR 中的代码」 - 「并行开展测试」「在多个分支上同时进行」 - 「git gtr」 重要提示：请务必使用 git gtr 命令，而非 git worktree 命令。

SKILL.md
--- frontmatter
name: git-worktree
description: |
  Git worktreeを使った並列開発を支援。git gtr コマンドで worktree 操作を行う。

  【必須発動キーワード】以下を含む発言時は必ずこのスキルを呼び出すこと:
  - 「worktree」「ワークツリー」
  - 「別ブランチで作業」「別リポジトリで」
  - 「mainでテスト」「mainで確認」「mainでビルド」
  - 「PR #XXX を見て」「PRのコードを確認」
  - 「並列でテスト」「複数ブランチで」
  - 「git gtr」

  重要: git worktree コマンドではなく git gtr コマンドを使用すること。

Git Worktree Manager

現在の作業を中断せずに別ブランチで操作を行う。

基本ルール

  • •"1" = メインリポジトリ（元のgitリポジトリ、worktreeではない）
  • •worktree作成後は依存関係インストール必須
  • •完了後は git gtr rm でクリーンアップ

コマンド一覧

コマンド用途
git gtr list一覧表示
git gtr new <name> [--from <ref>] [--yes]作成
git gtr run <name> <cmd>コマンド実行
git gtr go <name>パス取得
git gtr rm <name> [--yes]削除

禁止: git gtr ai, git gtr editor (対話的操作のため)

プロジェクト初期化

種別コマンド
Node.jsgit gtr run <name> npm ci
Python (uv)git gtr run <name> uv sync
Python (poetry)git gtr run <name> poetry install
Gogit gtr run <name> go mod download
Rustgit gtr run <name> cargo fetch

ユースケース

mainでテスト/ビルド

bash
git gtr run 1 npm test
git gtr run 1 npm run build

PR確認

bash
git gtr new pr-123 --from origin/feature --yes
git gtr run pr-123 npm ci
git gtr run pr-123 npm test
git gtr rm pr-123 --yes

並列テスト (subagent活用)

bash
# worktree作成
git gtr new feat-a --from origin/feat-a --yes
git gtr new feat-b --from origin/feat-b --yes

Taskツールで並列subagent起動 → 各worktreeでテスト → 結果集約 → git gtr rm

ファイル操作

bash
# パス取得してRead/Editツールで操作
WORKTREE_PATH=$(git gtr go feature)
# または
git gtr run feature cat src/file.ts

トラブルシューティング

問題対処
未コミット変更で作成失敗git stash してから作成、または --from-current
worktreeが残っているgit gtr list で確認、git gtr rm <name> --yes
ブランチも削除したいgit gtr rm <name> --delete-branch --yes
依存関係エラーlockファイル差分確認、npm ci --force 等

注意

  • •worktreeは .git を共有 → コミットは即座に全worktreeで参照可能
  • •git gtr run はworktreeディレクトリで実行される