Solicitar Revisão de Código

Superpoderes do agente: subagente code-reviewer para capturar problemas antes que eles se espalhem.

Princípio central: Revise cedo, revise frequentemente.

Quando Solicitar Revisão

Obrigatório:

• Após cada tarefa no desenvolvimento guiado por subagente
• Após a conclusão de uma funcionalidade importante
• Antes de mesclar para o branch principal (main)

Opcional, mas valioso:

• Quando estiver travado (perspectiva nova)
• Antes de refatorar (verificação de linha de base)
• Após corrigir um bug complexo

Como Solicitar

1. Obtenha os SHAs do Git:

BASE_SHA=$(git rev-parse HEAD~1)  # or origin/main
HEAD_SHA=$(git rev-parse HEAD)

2. Despache o subagente code-reviewer:

Use a ferramenta de Tarefas com o tipo de superpoderes code-reviewer, preencha o modelo em code-reviewer.md

Espaços reservados:

• {WHAT_WAS_IMPLEMENTED} - O que você acabou de construir
• {PLAN_OR_REQUIREMENTS} - O que deveria fazer
• {BASE_SHA} - Commit inicial
• {HEAD_SHA} - Commit final
• {DESCRIPTION} - Resumo breve

3. Aja com base no feedback:

• Corrija problemas Críticos imediatamente
• Corrija problemas Importantes antes de prosseguir
• Anote problemas Menores para depois
• Conteste se o revisor estiver errado (com justificativa)

Exemplo

[Just completed Task 2: Add verification function]

You: Let me request code review before proceeding.

BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 | awk '{print $1}')
HEAD_SHA=$(git rev-parse HEAD)

[Dispatch superpowers:code-reviewer subagent]
  WHAT_WAS_IMPLEMENTED: Verification and repair functions for conversation index
  PLAN_OR_REQUIREMENTS: Task 2 from docs/plans/deployment-plan.md
  BASE_SHA: a7981ec
  HEAD_SHA: 3df7661
  DESCRIPTION: Added verifyIndex() and repairIndex() with 4 issue types

[Subagent returns]:
  Strengths: Clean architecture, real tests
  Issues:
    Important: Missing progress indicators
    Minor: Magic number (100) for reporting interval
  Assessment: Ready to proceed

You: [Fix progress indicators]
[Continue to Task 3]

Integração com Fluxos de Trabalho

Desenvolvimento Guiado por Subagente:

• Revise após CADA tarefa
• Capture problemas antes que eles se acumulem
• Corrija antes de passar para a próxima tarefa

Execução de Planos:

• Revise após cada lote (3 tarefas)
• Obtenha feedback, aplique, continue

Desenvolvimento Ad-Hoc:

• Revise antes de mesclar
• Revise quando estiver travado

Sinais de Alerta

Nunca:

• Pule a revisão porque "é simples"
• Ignore problemas Críticos
• Prossiga com problemas Importantes não corrigidos
• Discuta com feedback técnico válido

Se o revisor estiver errado:

• Conteste com justificativa técnica
• Mostre código/testes que comprovem que funciona
• Peça esclarecimentos

Veja o modelo em: requesting-code-review/code-reviewer.md

Quando Usar

Esta habilidade é aplicável para executar o fluxo de trabalho ou as ações descritas na visão geral.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialista.
• Pare e peça esclarecimentos se as entradas, permissões, limites de segurança ou critérios de sucesso necessários estiverem ausentes.