kairyou/agent-tooling

Habilidades reutilizáveis para agentes, hooks, ferramentas de statusline e auxiliares de instalação para Codex, Claude Code e opencode.

O que é agent-tooling?

Esta skill, 'kairyou/agent-tooling', fornece um conjunto de habilidades reutilizáveis para agentes de IA como Claude Code, Codex e opencode, simplificando tarefas como geração de mensagens de commit padronizadas, hooks e ferramentas de statusline. O coração da skill é um gerador de mensagens de commit, que age como uma fonte única de verdade, consultando o diff staged e aplicando regras estritas de formatação baseadas no Conventional Commits, focando em clareza e precisão. É útil para desenvolvedores que desejam automatizar mensagens de commit com qualidade, evitando ambiguidades e garantindo consistência entre projetos. A skill funciona através de um processo claro: analisa o diff, gera sugestões no formato `tipo(escopo): descrição` (sempre em chinês), exibe para o usuário confirmar e só então executa o commit, respeitando limites de caracteres e sem push automático. Além disso, impõe uma disciplina de conteúdo que prioriza informações objetivas do código sobre suposições ou documentação, garantindo mensagens factuais e acionáveis para revisão e rastreamento de mudanças.

Funciona com✓Claude Code✓Codex CLI~Cursor✓OpenCode
npx skills add kairyou/agent-tooling

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

Gerador de Mensagens de Commit

Este arquivo é a única fonte da verdade; cada agente (Claude / opencode / codex) o referencia por meio de seus respectivos shims finos.

Fluxo

  1. Execute git diff --staged para ver as alterações em staged; se estiver vazio, avise "adicione com git add" e pare.
  2. Gere a mensagem de acordo com as regras abaixo, exiba para o usuário confirmar, não faça commit diretamente; quando o usuário precisar escolher, dê as opções diretamente, não apenas pergunte.
  3. Execute git commit -m apenas quando o usuário confirmar (por exemplo, responder "confirmado" ou "ok"). A menos que o usuário solicite explicitamente, não execute git push.

Regras

Leia git diff --staged e gere de acordo com o Conventional Commits, explicando o QUE (WHAT) e o PORQUÊ (WHY).

  • Título tipo(escopo): descrição, comprimento total ≤ 74 caracteres, sem ponto final no final, sem qualquer prefixo/aspas/bloco de código
  • tipo escolha o mais adequado:
    • feat nova funcionalidade · fix correção de bug
    • refactor refatoração que não altera o comportamento externo (nem nova funcionalidade nem correção) · perf otimização de performance
    • docs apenas documentação · style ajustes de formatação que não afetam a semântica (espaços/formatação/ponto e vírgula etc.)
    • test adição ou correção de testes · build alterações no sistema de build ou dependências externas · ci configuração e scripts de CI
    • chore outras tarefas que não mexem em src/test · revert reversão de commit anterior
  • escopo (opcional) nome do módulo afetado, de acordo com a convenção do repositório — em monorepo, use o nome do diretório app/package; se abranger vários ou não tiver certeza, omita diretamente
  • Descrição deve estar em chinês: frase de ação curta que explique claramente "o que foi feito", sem escrever frases vazias como "modificou vários arquivos", "este commit", "esta modificação"; identificadores (nomes de funções/arquivos/pacotes) permaneçam em inglês
  • Apenas linha única: em qualquer circunstância, a mensagem de commit tem apenas uma linha de título, sem corpo/rodapé; o WHY necessário deve ser encapsulado nesta única linha
  • Breaking change use tipo(escopo)!: descrição com !, mantendo linha única, sem usar BREAKING CHANGE no rodapé
  • Pontuação use pontuação meia-largura em inglês, não use largura inteira ,。:()

Estratégia de Geração

Antes de escrever, pense claramente "qual problema este conjunto de alterações resolve / qual é o fio condutor", depois escreva de acordo com o formato acima:

  • Agarre o fio condutor: escreva apenas as informações essenciais para entender este commit, não empilhe nomes de arquivos/nomes de funções/nomes de configuração (a menos que eles sejam críticos por si só).
  • Varra mudanças significativas: há alterações de lógica, contrato, build, portões de qualidade ou comportamento visível ao usuário — com base nisso, escolha o tipo correto e decida se usa ! para marcar breaking.

Disciplina de Conteúdo (De Onde Vem o WHAT)

Acima está o formato; abaixo trata da veracidade do conteúdo — a mensagem declara apenas fatos do código já confirmados, não adivinha intenções, não inventa com base em documentação:

  • Priorize mudanças de comportamento em src/test: docs servem apenas como contexto auxiliar, não use docs para inferir WHAT (a documentação frequentemente está adiantada/atrasada em relação ao código).
  • Contexto de diálogo tem prioridade sobre documentação: metas explicitamente mencionadas nos prompts recentes do usuário podem ser usadas para definir WHY e escolher uma redação mais precisa (por exemplo, "corrigir check/typecheck completo"); no entanto, WHAT/escopo ainda devem basear-se no diff staged — se o contexto mencionar algo que o diff não mostra, não escreva na mensagem; em caso de conflito, priorize o diff e peça confirmação.
  • Diffs de exclusão / renomeação: quando não for possível confirmar o propósito pela relação de chamadas do código, declare objetivamente (Excluir X / X renomeado para Y), não escreva causalidade forte como "substituir / migrar para / mudar para".
  • Múltiplos pontos de alteração com o mesmo objetivo (por exemplo, uma correção de qualidade de código/build) → forneça diretamente uma mensagem resumida; divisão em partes menores deve ser oferecida apenas como sugestão opcional anexa se melhorar significativamente a revisão/reversão, sem bloquear por padrão.
  • Mistura clara de múltiplos objetivos independentes de funcionalidade/correção → forneça tudo de uma vez: uma mensagem resumida para cada unidade + uma mensagem resumida conservadora, permitindo que o usuário escolha diretamente entre dividir ou resumir; não deixe o resumo para a próxima rodada; apenas quando o WHAT geral não puder ser objetivamente resumido é que se lista apenas as unidades, sem forçar.
  • Mudanças com pertencimento/intenção incertos (entradas paralelas, sem razão aparente para a alteração) → produza "Estes arquivos precisam de confirmação de pertencimento/intenção", em vez de forçar uma mensagem; quando incerto, evite palavras vagas como "organizar / ajustar", priorize pedir confirmação do usuário ou divisão.

Habilidades Relacionadas