receiving-code-review

Visão geral

O que a skill receiving-code-review faz

A skill receiving-code-review define um padrão claro e repetível de como um agente deve responder quando recebe feedback de code review, especialmente em pull requests do GitHub. Ela prioriza a avaliação técnica em vez da performance social.

Em vez de concordar cegamente com revisores ou implementar sugestões imediatamente, esta skill treina o agente para:

• Ler todo o feedback antes de reagir
• Reformular ou esclarecer a mudança solicitada
• Verificar o feedback no código real do repositório
• Avaliar se a sugestão é tecnicamente correta para aquele repositório
• Responder com fundamentação técnica, não com bajulação
• Implementar mudanças uma a uma, somente após entendimento e verificação

Para quem esta skill é indicada

Use receiving-code-review se você:

• Trabalha com um assistente de IA em PRs do GitHub ou discussões de code review
• Quer que o assistente aja como um revisor ou revisado atento, e não como alguém que só diz “sim”
• Precisa de ajuda para interpretar comentários de review e decidir o que fazer em seguida
• Se importa mais com correção e segurança das mudanças do que com concordância rápida e superficial

Ela é particularmente útil para:

• Desenvolvedores colaborando em feature branches e pull requests
• Tech leads que querem um tratamento consistente do feedback de review
• Times que estão experimentando com Claude ou outros LLMs como parceiros de review de PR

Quando esta skill não é adequada

Esta skill não foi feita para:

• Gerar novas features do zero
• Grandes refatorações sem contexto de review
• Gentilezas sociais, elogios ou atualizações de status

Se o seu foco é geração de código, rascunho de documentação ou ajuda em design de alto nível, combine esta com outras skills. Use receiving-code-review especificamente quando o agente estiver no fluxo de receber e responder a feedback de code review.

Principais benefícios

Com receiving-code-review instalada, o seu agente vai:

• Evitar respostas performáticas como "You're absolutely right!" ou "Great point!"
• Basear as respostas no código real, não em suposições
• Pedir esclarecimentos em vez de adivinhar quando o feedback estiver pouco claro
• Contestar com respeito quando uma sugestão for tecnicamente incorreta
• Reduzir o risco de implementar mudanças mal entendidas ou prejudiciais

Isso facilita confiar no agente nos seus processos de code-review, git-workflows e pr-review.

Como usar

1. Instalação

Para instalar a skill receiving-code-review a partir do repositório obra/superpowers, execute:

npx skills add https://github.com/obra/superpowers --skill receiving-code-review

Esse comando traz a definição da skill (incluindo SKILL.md) para o ambiente de skills do seu agente. A instalação pressupõe que você já tem a ferramenta npx skills disponível; se não tiver, configure isso antes, seguindo as instruções da sua plataforma ou do host do agente.

2. Arquivos para revisar após a instalação

Depois de instalar, revise o arquivo principal desta skill:

• skills/receiving-code-review/SKILL.md – descrição canônica do padrão de comportamento ao receber feedback de code review.

No repositório mais amplo obra/superpowers você pode encontrar padrões compartilhados como:

• README.md, AGENTS.md ou metadata.json na raiz – contexto geral de como as skills são estruturadas e usadas

Esses arquivos ajudam a entender como receiving-code-review se encaixa em um conjunto maior de regras de Claude/agente, mas o coração operacional desta skill está em SKILL.md.

3. Fluxo principal de resposta

A skill define um padrão específico de resposta sempre que o agente recebe feedback de code review (por exemplo, em uma thread de comentários de PR no GitHub):

1. READ:     Consume all feedback before reacting
2. UNDERSTAND: Restate the requirement in its own words, or ask
3. VERIFY:   Check the feedback against the real codebase
4. EVALUATE: Decide if it is technically sound for THIS repo
5. RESPOND:  Give a technical acknowledgment or reasoned pushback
6. IMPLEMENT: Change one item at a time and test each

Na prática, isso significa:

• O agente não deve dizer imediatamente que vai implementar uma sugestão.
• Primeiro ele garante que entendeu o que o revisor quer.
• Em seguida, inspeciona os arquivos/linhas relevantes ou o estado do repositório.
• Só então decide se aplica, ajusta ou rejeita a sugestão.

Esse padrão é especialmente útil em cenários de GitHub pull request review, em que contexto e correção são mais importantes do que velocidade.

4. Respostas proibidas e desencorajadas

A skill proíbe explicitamente certos tipos de respostas, comuns em LLMs, mas prejudiciais em code reviews sérios:

Exemplos proibidos:

• "You're absolutely right!" (explicitamente identificado como violação das regras mais amplas de CLAUDE)
• "Great point!" / "Excellent feedback!" e elogios semelhantes sem conteúdo técnico
• "Let me implement that now" quando o agente ainda não verificou a sugestão

Em vez disso, ao usar receiving-code-review, o agente deve:

• Reformular o requisito técnico: por exemplo, "You are asking to extract this logic into a separate function to avoid duplication."
• Fazer perguntas objetivas quando algo estiver pouco claro
• Oferecer fundamentação técnica quando acreditar que a sugestão é incorreta ou incompleta
• Avançar rumo às mudanças concretas sem exagerar na explicação ou nos elogios

Assim, a conversa permanece focada em qualidade de código, não em bajulação.

5. Lidando com feedback pouco claro ou parcial

A skill define uma regra rígida para feedback ambíguo:

IF any item in the feedback is unclear:
  STOP – do not implement anything yet
  ASK for clarification on the unclear items

A lógica é: itens individuais de review podem estar relacionados; implementar apenas o que você "acha" que entendeu enquanto outras partes seguem ambíguas pode levar a:

• Mudanças conflitantes
• Workflows quebrados
• Comportamento desalinhado em relação à intenção do revisor

Por exemplo, se um revisor diz "Fix 1–6" e o agente só entende os itens 1, 2, 3 e 6, receiving-code-review o orienta a:

• Pausar a implementação
• Fazer perguntas específicas sobre os itens 4 e 5
• Só implementar depois que o conjunto completo de requisitos estiver entendido

Esse comportamento é crítico em fluxos git automatizados ou semi-automatizados, em que entendimento parcial pode rapidamente resultar em branches quebradas.

6. Integração com seu fluxo de GitHub / PR

Para tirar o máximo proveito de receiving-code-review em um projeto real:

1. Anexe a skill ao seu agente usado para:

   • Revisar pull requests
   • Redigir respostas a comentários de revisores
   • Ajudar a triagem ou sumarização de feedback de review

2. Garanta acesso ao repositório para que o agente possa de fato verificar as sugestões em relação a:

   • Código da branch atual
   • Arquivos e módulos relevantes

3. Combine com skills complementares para melhores resultados, como:

   • Uma skill de coding ou refactoring para implementar as mudanças acordadas
   • Skills de navegação ou busca no repositório para localizar rapidamente o código afetado

4. Informe o seu time de que o agente vai:

   • Fazer perguntas de esclarecimento em vez de adivinhar
   • Às vezes contestar sugestões incorretas ou arriscadas
   • Evitar elogios genéricos, priorizando respostas técnicas específicas

Integrada dessa forma, receiving-code-review funciona como um trilho de segurança que mantém seu colaborador de IA disciplinado e confiável nas conversas de code review.

7. Quando ativar esta skill

Use receiving-code-review sempre que seu prompt ou fluxo de trabalho indicar que o agente está:

• Lendo feedback de humanos ou bots em um pull request
• Passando por comentários inline em diffs do GitHub
• Processando anotações de review em uma ferramenta de code review

Você geralmente não precisa desta skill quando estiver:

• Gerando o código inicial ou o primeiro rascunho de uma feature
• Escrevendo documentos de design ou ADRs
• Fazendo tarefas sem review, como upgrades de dependências

Ativar a skill apenas em contextos de review mantém o comportamento do agente previsível e focado.

FAQ

Que problema a receiving-code-review resolve?

A skill receiving-code-review resolve o problema de respostas superficiais e performáticas da IA a feedback de code review. Em vez de sempre concordar e modificar o código imediatamente, o agente:

• Lê todo o feedback
• Verifica o feedback no código existente
• Esclarece solicitações ambíguas
• Questiona com argumentos técnicos quando necessário

Isso reduz significativamente implementações incorretas e ruídos de comunicação em PRs do GitHub e outras ferramentas de code review.

Como instalo a receiving-code-review?

Instale a skill a partir do repositório obra/superpowers usando:

npx skills add https://github.com/obra/superpowers --skill receiving-code-review

Depois da instalação, revise o arquivo SKILL.md dentro do diretório da skill receiving-code-review para entender as regras de comportamento exatas.

Esta skill muda a forma como o código é escrito?

Indiretamente. receiving-code-review não gera código por conta própria, mas influencia fortemente como e quando as mudanças de código são feitas, ao impor:

• Verificação antes da implementação
• Mudanças e testes item a item
• Evitar correções parciais e mal compreendidas

Combine com skills de coding para cuidar da implementação em si depois que o feedback de review tiver sido validado.

A receiving-code-review pode contestar um revisor humano?

Sim. A skill explicitamente permite e incentiva contestação técnica fundamentada quando o feedback for:

• Incorreto para o código atual
• Baseado em premissas desatualizadas
• Propenso a introduzir bugs ou regressões

A contestação deve se basear em detalhes concretos do repositório, não em opiniões vagas.

Esta skill é apenas para GitHub?

A skill foi escrita pensando em fluxos de trabalho de PR review ao estilo GitHub, mas se aplica a qualquer ambiente em que um agente receba feedback estruturado de code review, incluindo:

• Ferramentas de code review baseadas em Git
• Dashboards internos de review
• Sessões de review em chat em que os comentários referenciam arquivos e linhas específicos

Se o seu fluxo se parece com comentários de PR mais um repositório git, receiving-code-review tende a ser uma boa opção.

Como isso interage com CLAUDE ou outras regras de agente?

No ecossistema obra/superpowers, skills são combinadas com regras de nível mais alto (frequentemente em arquivos como CLAUDE.md). receiving-code-review faz referência a essas expectativas ao proibir respostas como "You're absolutely right!", que violam o espírito dessas regras.

Use-a em conjunto com as regras já existentes do seu agente para:

• Impor um comportamento mais rigoroso em reviews
• Evitar excesso de otimização social
• Manter consistência entre diferentes projetos e repositórios

E se o meu time preferir respostas mais polidas?

Você ainda pode manter um tom profissional, mas esta skill prioriza comunicação técnica clara em vez de fórmulas de polidez. Se precisar de linguagem mais suave, você pode:

• Adicionar diretrizes de tom em outras skills
• Manter receiving-code-review como espinha dorsal de verificação e rigor

Essa separação permite ajustar o estilo sem enfraquecer a disciplina central de review.

Como saber se a skill está funcionando corretamente?

Sinais de que receiving-code-review está ativa e efetiva incluem:

• O agente deixa de responder com elogios genéricos a comentários de review
• Ele reformula os requisitos antes de agir
• Faz perguntas quando o feedback está incompleto ou ambíguo
• Faz referência a arquivos, funções ou linhas específicos ao aceitar ou questionar sugestões

Se você observar respostas imediatas do tipo "I’ll implement that" sem qualquer verificação, revise a configuração de skills e confirme que esta skill está habilitada em contextos de review.