Jak używać
- Skopiuj polecenie instalacji i sprawdź źródła przed instalacją we własnym środowisku agenta.
- W oryginale sprawdź wymagane narzędzia, dane dostępowe i obsługiwane środowiska.
- Opisz dane wejściowe i oczekiwany rezultat; porównaj wynik ze źródłami.
npx skills add https://github.com/venhdev/zenforge --skill worktreePrzed rozpoczęciem
- Instalacja nie obejmuje subskrypcji modelu, limitu API ani uprawnień do plików.
- Gwiazdki i instalacje pokazują aktywność, a nie niezależny test jakości lub bezpieczeństwa.
Oryginalny dokument Skill
Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.
worktree — Isolated Session & Branching Engine
Operating Invariants
- Path Isolation: Confine all branch edits, shell commands, and test executions strictly within
.agents/worktree/<branch>; forbid modifying root repository files from a worktree session. - Dirty Tree Breaker: Verify working tree cleanliness via
git status --porcelainbefore deleting a worktree; forbid deleting worktrees containing uncommitted modifications. - Pre-Mutation Gate: Stage worktree creation or removal in Canonical Changeset format and halt turn immediately; forbid executing worktree mutations on disk without affirmative human authorization.
Domain Rubric
1. Naming & Storage Conventions
<branch>: Strictly format as<type>/<slug>(feat/,fix/,refactor/,chore/,test/).<path>: Dedicated path strictly under.agents/worktree/<branch>.- Privacy Anchor: Root
.gitignoremust contain.agents/worktree/.
2. Supported Worktree Operations
[CREATE]: Add a new worktree branch checked out at target path.[DELETE]: Remove worktree directory and prune git administrative metadata.[LIST]: Inspect active worktrees and associated branches.[PRUNE]: Clean up squash-merged branches safely viascripts/prune-squashed.sh.
Canonical Output Contract
text
# Changeset: Git Worktree <Action>
`-- .agents/worktree/<branch>/
`-- [<ACTION>] <Worktree operation summary>.
Summary: 1 worktree affected (<branch>).Execution Protocol
Phase 1: Pre-flight & Collision Audit
- For create: Inspect
git worktree listand verify no branch or directory collision exists. - For delete: Inspect
git status --porcelaininside target<path>. If dirty, halt immediately and report uncommitted files. - For list: Run
git worktree listand present active worktrees, halting turn immediately.
Phase 2: Staging & Authorization Gate
- Stage the planned worktree modification in Canonical Changeset format.
- Present the staging summary and halt turn immediately for human authorization.
Phase 3: Atomic Execution & Handoff
- On approval, execute the required operation:
- Create:
git worktree add <path> -b <branch> <base_ref> - Delete:
git worktree remove <path> && git worktree prune - Prune:
bash scripts/prune-squashed.sh <target_branch>
- Report operation completed with the absolute workspace path for IDE navigation.