AgentSkillsCN

worktree-kit

管理git工作树（创建/列出/切换/清理）并复制.env文件。用于并行功能开发、隔离审查、清理工作区，或当用户提及工作树时使用。

SKILL.md
--- frontmatter
name: worktree-kit
description: Manage git worktrees (create/list/switch/cleanup) and copy .env files. Use for parallel feature work, isolated review, clean workspace, or when user mentions worktrees.

Worktree kit

Use the manager script for all worktree actions.

bash
bash .factory/skills/worktree-kit/scripts/worktree.sh <command> [args]

Commands:

  • •create <name> [base]
  • •list
  • •switch <name> (prints path)
  • •cleanup
  • •copy-env <name>

Safety notes:

  • •create does not change the current branch
  • •cleanup does not force-remove worktrees and does not delete branches
  • •cleanup deletes the worktree directory (including ignored files); removal fails if the worktree is not clean
  • •.env* is copied with no overwrite (symlinks skipped)
  • •refuses to operate if .worktrees/ or any worktree path component is a symlink
  • •copy-env only targets registered worktrees
  • •origin fetch is optional; local base refs are allowed
  • •fetch from origin only when base looks like a branch
  • •Worktrees live under .worktrees/