Fluxo de Trabalho do Git Push

Faça o stage apenas das alterações pretendidas, crie um commit convencional e envie para o branch remoto.

Quando Usar

Ativa automaticamente quando o usuário:

• Pede explicitamente para enviar alterações ("enviar isto", "fazer commit e enviar")
• Menciona salvar o trabalho no remoto ("salvar no github", "enviar para o remoto")
• Conclui uma funcionalidade e quer compartilhá-la
• Diz frases como "vamos enviar isto" ou "fazer commit destas alterações"

Portões de Segurança

Antes de fazer o stage, inspecione git status --short --branch, confirme os arquivos pretendidos e busque o branch upstream quando um push concorrente for plausível. Não absorva arquivos sujos não relacionados.

Leia a política do repositório antes de escolher o branch de destino. Se main ou master estiver protegido, ou se o repositório definir um comando de mantenedor como merge:batch, crie ou use um branch de tópico e finalize através das verificações de pull-request necessárias. Um pedido do usuário para "enviar para main" descreve o estado final desejado; não autoriza a ignorar a proteção do lado do servidor. Nunca continue tentando um push direto após uma rejeição de branch protegido.

O auxiliar requer um índice ativo vazio e uma mensagem de commit convencional antes de fazer o stage de qualquer coisa. Ele bloqueia o índice ativo, constrói e valida o commit em um índice temporário isolado, rejeita -- sem caminhos e atualiza atomicamente o branch apenas se seu pai não for alterado.

O auxiliar respeita branch.<name>.pushRemote, remote.pushDefault e o upstream configurado do branch, nessa ordem. Para um novo branch sem essas configurações, ele requer origin e estabelece origin/<branch>. Ele rejeita HEAD destacado e configurações remotas inválidas antes de fazer o stage.

Não use esta habilidade para um lote de merge de mantenedor, sincronização canônica, release de repositório versionado, publicação de tag ou um repositório com um fluxo merge:batch, release:prepare ou release:publish explícito. Use o fluxo de mantenedor/release desse repositório em vez disso; ele é responsável pelas evidências de pull-request, verificações de branch protegido, arquivos gerados, tags e verificação de publicação.

Fluxo de Trabalho

Use o auxiliar apenas após a passagem dos portões de segurança. Resolva o diretório instalado que contém esta SKILL.md e substitua seu caminho absoluto por <skill-directory> abaixo; não presuma que o diretório de trabalho atual é o repositório do catálogo. Sem caminhos, o auxiliar faz o stage de todas as alterações atuais, portanto, use essa forma apenas quando todos os arquivos sujos pertencerem ao commit solicitado:

bash "<skill-directory>/scripts/smart_commit.sh"

Com mensagem personalizada:

bash "<skill-directory>/scripts/smart_commit.sh" "feat: add feature"

Para fazer o stage apenas de arquivos nomeados, passe-os após --:

bash "<skill-directory>/scripts/smart_commit.sh" "fix: scope change" -- path/to/file

O auxiliar lida com o stage isolado, criação de commit e push; ele não substitui a validação, ferramentas de release ou um rebase exigido por um branch upstream avançado.

Limitações

• O auxiliar atualmente requer o backend de ref files do Git; ele rejeita repositórios reftable antes de criar um commit porque seus refs não podem usar o protocolo de bloqueio de sistema de arquivos.
• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs, permissões, limites de segurança ou critérios de sucesso necessários estiverem faltando.