CommunityEscrita e Ediçãogithub.com

Dev-PGVAA/skills

Escreva alterações de código focadas e verificáveis, ou realize uma revisão baseada em defeitos de um diff, commit ou pull request. Use para disciplina de implementação, refatoração e revisão de código; escolha o modo de revisão apenas quando solicitado. Novos nomes permanecem curtos e legíveis; comentários explicam o porquê, não o quê.

O que é skills?

A skill 'Code Quality' do repositório Dev-PGVAA/skills é uma diretriz para desenvolvedores e agentes de IA que busca impor disciplina na implementação e revisão de código. Ela oferece dois modos principais: **Implementar/Refatorar**, onde se deve definir critérios de aceitação observáveis e usar as ferramentas reais do repositório para fazer mudanças focadas e corretas; e **Revisar**, que exige a leitura de um guia específico e permanece apenas leitura, a menos que correções também sejam solicitadas, confirmando a comparação antes de tirar conclusões. A skill promove a delegação inteligente para subagentes em tarefas independentes que reduzam incertezas, como um 'scout de contrato' para ler chamadores e interfaces durante a implementação, e um 'verificador' para exercitar o comportamento alterado. Para revisões, a delegação pode ser por risco (ex.: autorização vs. concorrência) ou por módulos separados. É útil para times que usam agentes como Claude Code, Cursor ou Codex, pois padroniza a forma de fazer mudanças pequenas, verificáveis e com foco em evidências, evitando planos ou abstrações desnecessárias.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Dev-PGVAA/skills/tree/HEAD/code-quality

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Qualidade de Código

Torne o comportamento solicitado correto com uma alteração focada; revise defeitos usando evidências concretas. Respeite as instruções do repositório, a arquitetura existente, as edições do usuário e o escopo de leitura/escrita solicitado.

Selecione o modo

  • Implementar / refatorar: leia as diretrizes. Defina critérios de aceitação observáveis e use as ferramentas reais do repositório.
  • Revisar: leia revisão. Permaneça apenas leitura, a menos que correções também sejam solicitadas. Confirme a comparação antes de tirar conclusões.
  • Uma pequena edição precisa de um pequeno fluxo de trabalho. Não crie planos, abstrações, testes ou arquivos extras apenas para satisfazer esta skill.

Delegação útil

Use subagentes disponíveis para trabalhos independentes que reduzam materialmente a incerteza. Pule a delegação quando o custo de transferência de contexto for maior que a tarefa; use as mesmas funções sequencialmente se os agentes não estiverem disponíveis.

  • Implementação: um "scout de contrato" lê chamadores, interfaces e testes existentes enquanto o pai implementa; um verificador exercita o comportamento alterado após um patch estável. Divida a implementação apenas entre arquivos genuinamente independentes, com um proprietário por arquivo e o pai sendo o proprietário dos arquivos de integração.
  • Revisão: particione por risco, como autorização/tratamento de dados e estado/concorrência, ou módulos desconexos. Dê a cada revisor a mesma base/head e o comportamento de usuário solicitado. O pai rastreia caminhos entre módulos, verifica cada descoberta proposta, remove duplicatas e atribui a gravidade final.
  • Uma tarefa delegada nomeia o objetivo, caminhos permitidos, escopo de leitura/escrita, suposições, ponto de parada e evidências esperadas. Retorne arquivos alterados ou descobertas path:line, um reprodutor/resultado de teste real e perguntas não resolvidas. Não delegue recursivamente sem um motivo útil e limitado.

Conclusão

Relate comportamento alterado ou descobertas acionáveis, verificações realmente executadas e limitações materiais. "Nenhuma descoberta" é válido; passar na verificação de tipo não é prova de comportamento em tempo de execução ou implantação.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Habilidades Relacionadas