Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/venhdev/zenforge --skill worktreeAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
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.