Habilidades using-git-worktrees

📦

using-git-worktrees

Name: using-git-worktrees
Author: ZhanlinCui

Seguro ⚙️ Comandos externos📁 Acesso ao sistema de arquivos

Criar Workspaces Git Isolados para Desenvolvimento Paralelo

Também disponível em: Cycleaddict,obra,davila7,Doyajin174,DYAI2025,Cygnusfear,CodingCossack

Git worktrees permitem trabalhar simultaneamente em branches sem mudança de contexto. Esta habilidade fornece seleção sistemática de diretórios e verificação de segurança para isolamento confiável de workspace.

Suporta: Claude Codex Code(CC)

🥉 73 Bronze

Baixar o ZIP da skill

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

Ative e comece a usar

Testar

A utilizar "using-git-worktrees". Create worktree for feature/auth branch

Resultado esperado:

Worktree ready at /Users/jesse/myproject/.worktrees/auth
Tests passing (47 tests, 0 failures)
Ready to implement auth feature

A utilizar "using-git-worktrees". Set up isolated workspace for code review

Resultado esperado:

Found existing .worktrees/ directory (git-ignored)
Created worktree: git worktree add .worktrees/review-pr123 -b review/pr-123
Dependencies installed (npm install)
Baseline verified: 52 tests passing

Auditoria de Segurança

Seguro

v1 • 2/24/2026

Static analyzer flagged 42 patterns but all are false positives. The skill is documentation-only (markdown file) containing bash command examples for teaching git worktrees. No executable code exists - all flagged patterns are code blocks in instructional content. External commands are git/bash examples, filesystem references are documentation paths, and crypto warnings are spurious.

Arquivos analisados

218

Linhas analisadas

achados

Total de auditorias

Auditado por: claude

Pontuação de qualidade

Arquitetura

100

Manutenibilidade

Conteúdo

Comunidade

100

Segurança

Conformidade com especificações

O Que Você Pode Construir

Isolamento de Desenvolvimento de Funcionalidades

Criar workspace isolado para nova funcionalidade sem interromper a branch principal de desenvolvimento

Preparação para Code Review

Configurar worktree limpo para revisar pull requests sem afetar o estado atual do trabalho

Paralelização de Correção de Bugs

Criar rapidamente ambiente isolado para hotfixes urgentes enquanto o trabalho na funcionalidade continua

Tente Estes Prompts

Criação Básica de Worktree

Create a new git worktree for feature branch 'feature/user-auth' using the standard directory selection process

Worktree com Localização Personalizada

Set up a worktree for 'hotfix/login-bug' in ~/.config/superpowers/worktrees/myproject/ for global access

Verificação e Setup de Worktree

Create worktree for 'feature/api-v2', verify it is properly ignored, run project setup, and confirm tests pass before I begin implementation

Reutilização de Worktree Existente

Check if worktree 'feature/payment-integration' already exists in .worktrees/, and if so switch to it instead of creating a new one

Melhores Práticas

Sempre verifique se o diretório do worktree está no git-ignore antes da criação para prevenir commits acidentais
Execute testes de linha de base imediatamente após criação do worktree para distinguir bugs novos de problemas pré-existentes
Siga a prioridade de diretórios: diretórios existentes primeiro, depois configuração CLAUDE.md, depois pergunte ao usuário

Evitar

Criar worktrees sem verificar status git-ignore causa poluição do repositório
Pular verificação de testes de linha de base torna impossível atribuição de bugs
Hardcodar caminhos de diretórios viola convenções do projeto e workflows de equipe

Perguntas Frequentes

O que é um git worktree e por que usá-lo?

Um git worktree é um diretório de trabalho vinculado que compartilha a mesma pasta .git do repositório. Permite trabalhar em múltiplas branches simultaneamente sem trocar branches no diretório principal.

Como esta habilidade escolhe onde criar worktrees?

Ordem de prioridade: 1) Diretório existente .worktrees/ ou worktrees/, 2) Configuração CLAUDE.md, 3) Perguntar ao usuário. Diretórios locais do projeto devem estar no git-ignore antes do uso.

Worktrees duplicam meu repositório em disco?

Não. Worktrees compartilham o diretório .git com o repositório principal, economizando espaço em disco. Apenas os arquivos com checkout ocupam espaço adicional.

O que acontece se testes de linha de base falharem em um novo worktree?

A habilidade reporta falhas e pergunta se deve prosseguir ou investigar. Isso distingue falhas de teste pré-existentes de bugs introduzidos durante o trabalho na funcionalidade.

Posso usar worktrees com qualquer repositório git?

Worktrees requerem git 2.5 ou posterior. Não funcionam com repositórios bare ou shallow clones. A maioria dos repositórios padrão suporta worktrees.

Como faço cleanup de um worktree quando terminado?

Use a habilidade finishing-a-development-branch que lida com cleanup de worktree, merge de branch se necessário e manutenção git adequada.

Detalhes do Desenvolvedor

Autor

ZhanlinCui

Licença

MIT

Repositório

https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection/tree/main/using-git-worktrees

Referência

main

Estrutura de arquivos

📄 SKILL.md