Guia de leitura localizado

using-git-worktreesFinalidade, utilização e fonte

Utilize ao iniciar o desenvolvimento de funcionalidades que necessitam de isolamento do espaço de trabalho atual ou antes de executar planos de implementação — garante a existência de um espaço de trabalho isolado por meio de ferramentas nativas ou do fallback da árvore de trabalho do Git.

Fonte recuperada: 2026-10-29

Repositório de origem: obra/superpowers
SKILL.md: skills/using-git-worktrees/SKILL.md
Estrelas do repositório: 309,479
Atualização do repositório: 2026-10-30
Classificação de Habilidades: Desenvolvimento
Última coleta: 2026-10-31 10:38 UTC+08:00

Licença: MIT

SKILL.md original

Os trechos do fluxo de trabalho são auxiliares de leitura e não instruções executáveis do Codez. Nenhuma Skill de terceiros foi executada para gerar esta página.

Os trechos abaixo, que descrevem o propósito e o fluxo de trabalho, são material original, organizado e traduzido para facilitar a leitura. Eles são distintos da análise editorial da Codez, que possui uma etiqueta separada.

O que esta habilidade faz

Como funciona o fluxo de trabalho upstream

Visão geral

Garanta que o trabalho seja realizado em um espaço de trabalho isolado. Dê preferência às ferramentas nativas de criação de árvores de trabalho da sua plataforma. Recorra a árvores de trabalho Git manuais somente quando nenhuma ferramenta nativa estiver disponível. Princípio fundamental: primeiro, detecte o isolamento existente; depois, use as ferramentas nativas; e, por fim, recorra ao Git. Nunca lute contra as regras. Anuncie no início: "Estou usando a skill using-git-worktrees para configurar um espaço de trabalho isolado."

Passagem a montante · L8 ↗

Etapa0Detectar isolamento existente

Antes de criar qualquer coisa, verifique se você já está em um espaço de trabalho isolado. Proteção de submódulo:GIT_DIR != GIT_COMMONIsso também é válido dentro de submódulos do Git. Antes de concluir "já está em uma árvore de trabalho", verifique se você não está em um submódulo: SeGIT_DIR != GIT_COMMON(e não um submódulo): Você já está em uma árvore de trabalho vinculada. Ir para a etapa2(Configuração do projeto). NÃO crie outra árvore de trabalho. Relatório com o estado da ramificação:

Passagem a montante · L16 ↗

Etapa1Criar espaço de trabalho isolado

Você tem dois mecanismos. Experimente-os nesta ordem.

Passagem a montante · L47 ↗

Passagem a montante · bash ↗

GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P)
GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P)
BRANCH=$(git branch --show-current)

Requisitos e configuração

Etapa2Configuração do projeto

Detecção automática e execução da configuração apropriada:

Passagem a montante · L102 ↗

Limites e verificações de qualidade

Verificação de segurança (somente diretórios locais do projeto)

É NECESSÁRIO verificar se o diretório está sendo ignorado antes de criar a árvore de trabalho: Se NÃO estiver sendo ignorado: Adicione ao .gitignore, confirme a alteração e prossiga.

Passagem a montante · L78 ↗

Comece com um teste seguro.

Verifique o host compatível e as instruções de instalação do repositório. Mantenha o diretório Skill e seus scripts, recursos e documentação referenciados juntos;SKILL.mdsozinho pode omitir dependências.
Forneça ao agente suas entradas reais, a saída desejada e os critérios de aceitação. A sintaxe de invocação e as ferramentas disponíveis dependem do host; este site não pressupõe um comando de instalação universal.
Teste o fluxo de trabalho original em um projeto descartável ou em uma cópia. Analise as operações que alteram arquivos, serviços remotos ou recursos faturáveis antes de permiti-las.
Valide o resultado comparando-o com as verificações de qualidade da fonte e com seus próprios requisitos. Um gatilho bem-sucedido ou uma alta contagem de estrelas no repositório não garantem um resultado correto.

Especificação de formato e diretório de habilidades ↗

Tradução e escopo

Este guia de leitura seleciona trechos do texto fixado a montante.SKILL.mdA tradução foi feita com auxílio de ferramentas. Este não é um manual completo nem garante compatibilidade comprovada. Leia o original e os arquivos referenciados antes de usar.

Esta introdução refere-se à versão fixada abaixo; a atividade atual do repositório e o tempo de coleta são mostrados separadamente.

Fonte fixada: Leia o original ↗
Fonte recuperada: 2026-10-29T09:32:23Z
Commit de origem: 2ce8aa15d05bd57213e6f746f953aafb7ded7a8b
Fonte SHA-256: 8cfb86f121269e8f7f12361e6795c4f6738828340e28964c9229d365666c9edd

Voltar ao catálogo completo de habilidades