Makuco

Buscar na documentação

Páginas e seções

Commit pela lateral

Escolher arquivos e mandar o agente commitar e empurrar, sem abrir o terminal nem o editor.

O botão ▸ Fazer commit existe para quem acompanha o agente trabalhar e não usa git direto — o analista de negócio que validou o resultado e quer subir. Quem trabalha só no teclado, ou roda com MAKUCO_DISABLE_MOUSE, usa o comando /commit.

Como funciona

  1. Clique em ▸ Fazer commit na lateral, ou digite /commit.
  2. O diálogo abre com a lista de arquivos do git status — tudo que está sujo na árvore, não só o que o agente tocou nesta sessão. Isso é o que faz o botão funcionar numa CLI recém-aberta, depois de um /clear, e com arquivo editado fora do agente.
  3. ↑↓ andam, Espaço marca e desmarca, a marca ou desmarca todos.
  4. Tab leva ao campo de instruções. Ele é opcional — dizer como o commit deve ser feito é uma escolha, não um requisito.
  5. Enter invoca a skill makuco-commit com a lista marcada.

Esc fecha o diálogo sem cancelar o turno que estiver rodando.

Tab antes de escrever

A lista de arquivos e o campo de instruções disputam a tecla Espaço. Por isso o foco é explícito: com a lista em foco, Espaço marca arquivo; depois do Tab, Espaço escreve espaço.

O que o agente faz

A skill makuco-commit vem instalada pelo makuco init. Ela:

PassoO que faz
1Lê os últimos commits do repositório e aprende a convenção de mensagem dele — idioma, prefixo tipo(escopo):, id de ticket, tamanho típico. Não assume Conventional Commits.
2Confere se os arquivos escolhidos ainda estão modificados. Caminho que saiu da lista é reportado, não descartado em silêncio.
3Põe em stage exatamente os arquivos marcados — nunca git add -A, . ou -u.
4Lê o que está em stage e escreve a mensagem a partir disso, não do que aconteceu antes na sessão.
5Commita e empurra.
6Relata o resultado em português, sem jargão de git.

Ela pergunta antes de empurrar para main ou master

Empurrar para a branch principal atinge o time inteiro e não se desfaz com um comando local. Em qualquer outra branch, ela não pergunta nada. Com HEAD destacado ela para: criar uma branch é uma decisão sua.

Se nenhum dos arquivos escolhidos estiver mais modificado, ela para e diz — não há o que commitar. Se a lista chegar vazia, ela para em vez de commitar tudo.

Antes de commitar: conferir o que mudou

Clique num arquivo da lateral para abrir o visualizador. As linhas adicionadas ou alteradas na sessão aparecem com fundo verde; linha removida não aparece — o diff completo está na conversa.

O contador +N -N ao lado do nome é o diff líquido da sessão nas linhas marcadas com ●, e o diff contra o HEAD nas outras. Um arquivo que ganhou e perdeu a mesma linha lê +0 -0, que é onde o disco de fato está.