Fluxo de Commit
Use quando o usuário pedir para commitar, preparar ou preparar alterações para um commit.
Passos
- Executar doc-gen — ativar/executar a skill
gen-docsprimeiro para atualizar a documentação com base nas alterações de código. - Verificar alterações atuais — executar
git statusegit diff(ougit diff --cached) para ver exatamente o que mudou. - Revisar código — ler os arquivos modificados/adicionados para entender o que é realmente necessário.
- Preparar apenas o código necessário — ler arquivos diretamente; adicionar arquivos que contenham mudanças reais e necessárias. Para qualquer arquivo que pareça não relacionado, temporário ou pouco claro, pergunte ao usuário: "Devo preparar
<file>? Ele contém<breve resumo>" — não assuma. - Baseie a mensagem na alteração de código — derivar a mensagem de commit do diff/conteúdo real (por exemplo,
feat: add docs for skills a). - Confirmar com o usuário — mostrar a mensagem proposta, o resultado do doc-gen e os arquivos preparados; pedir aprovação (
sim/aprovar) antes de commitar. - Commiter o código — executar
git commitcom a mensagem aprovada e, em seguida, mostrar um breve resumo do que foi commitado. - Perguntar sobre push — perguntar ao usuário se deseja fazer push (
git push).
Regras
- Use
git,read_file,write_filee ferramentas de arquivo diretamente neste fluxo — não peça permissão para cada chamada de ferramenta. - Se não tiver certeza se uma alteração é necessária, pergunte: "Devo preparar
<file>? Ele contém<breve resumo>" - Execute
gen-docsantes de commitar. - Sugira uma mensagem de commit derivada do diff real (exemplo de formato:
feat: add docs for skills a). - Confirme com o usuário (
sim/aprovar) antes degit commite antes degit push; os outros passos prossigam diretamente.