karrot0195/agent-skills-

Fluxo de commit que executa doc-gen primeiro, prepara apenas os arquivos necessários (pedindo confirmação para os duvidosos), sugere uma mensagem a partir do diff real, faz o commit, mostra um resumo e pergunta sobre o push.

O que é agent-skills-?

Esta skill automatiza o fluxo de trabalho de commit para desenvolvedores que usam agentes de IA como Claude Code, Cursor ou Codex. Ela garante que a documentação (doc-gen) seja atualizada antes do commit, seleciona cuidadosamente apenas os arquivos relevantes para staging (pedindo confirmação do usuário quando um arquivo parece não relacionado ou incerto), e gera uma mensagem de commit significativa a partir do diff real. Após o commit, a skill exibe um resumo e pergunta ao usuário se deseja fazer push das alterações. As plataformas suportadas incluem qualquer ambiente de desenvolvimento baseado em terminal com Git, sendo projetada para agentes que podem executar comandos shell e ler arquivos diretamente. O fluxo evita suposições ao consultar o usuário sobre mudanças ambíguas e exige aprovação explícita antes de commit e push, aumentando o controle e a precisão.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/karrot0195/agent-skills-/tree/HEAD/.agents/skills/commit-flow

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Fluxo de Commit

Use quando o usuário pedir para commitar, preparar ou preparar alterações para um commit.

Passos

  1. Executar doc-gen — ativar/executar a skill gen-docs primeiro para atualizar a documentação com base nas alterações de código.
  2. Verificar alterações atuais — executar git status e git diff (ou git diff --cached) para ver exatamente o que mudou.
  3. Revisar código — ler os arquivos modificados/adicionados para entender o que é realmente necessário.
  4. 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.
  5. 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).
  6. 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.
  7. Commiter o código — executar git commit com a mensagem aprovada e, em seguida, mostrar um breve resumo do que foi commitado.
  8. Perguntar sobre push — perguntar ao usuário se deseja fazer push (git push).

Regras

  • Use git, read_file, write_file e 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-docs antes 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 de git commit e antes de git push; os outros passos prossigam diretamente.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas