Code Review Operator vs API Design Operator

Diferença principal: Code Review Operator é um componente skill voltado a Revisar mudança por correção, segurança, testes e manutenção., enquanto API Design Operator é um componente skill voltado a Revisar contrato de API por consistência, evolução e falhas.. A melhor escolha depende do objetivo, da compatibilidade necessária e da menor exposição operacional suficiente.

Comparação objetiva

Quando usar Code Review Operator

Use Code Review Operator quando o trabalho central for Revisar mudança por correção, segurança, testes e manutenção.. O comando canônico é /plugin install atlas-engineering-code-review-skill@reveno. Antes de instalar, confirme a compatibilidade declarada (Claude Code) e limite o acesso ao menor conjunto necessário.

Quando usar API Design Operator

Use API Design Operator quando o objetivo estiver mais próximo de Revisar contrato de API por consistência, evolução e falhas.. O comando canônico é /plugin install atlas-engineering-api-design-skill@reveno. Se os dois componentes cobrirem partes diferentes do fluxo, monte uma stack e revise overlaps antes de instalar ambos.

Riscos e controles de Code Review Operator

Skill de instrução, sem shell, rede, credenciais ou execução automática. Risco principal: usar uma saída não revisada ou fornecer contexto insuficiente. Não afirmar vulnerabilidade ou bug sem apontar caminho reproduzível no código. Permissões declaradas: nenhuma declarada. Aprovação humana: Revisão humana obrigatória antes de enviar, publicar, aprovar ou executar a saída em ambiente real..

Riscos e controles de API Design Operator

Skill de instrução, sem shell, rede, credenciais ou execução automática. Risco principal: usar uma saída não revisada ou fornecer contexto insuficiente. Não incluir dado sensível ou campo interno sem necessidade do consumidor. Permissões declaradas: nenhuma declarada. Aprovação humana: Revisão humana obrigatória antes de enviar, publicar, aprovar ou executar a saída em ambiente real..

Trust Score e estado de confiança

Code Review Operator: not-tested: evidência insuficiente; não é reprovação e não entra como zero na nota.

API Design Operator: not-tested: evidência insuficiente; não é reprovação e não entra como zero na nota.

Estados not-tested são excluídos da nota e nunca tratados como zero. Medium ou high risk pedem contexto e revisão; não significam automaticamente “não use”.

Como decidir e combinar

Escolha primeiro o tarefa específico. Depois compare origem, manutenção, autonomia, compatibilidade, rede, shell, arquivos, credenciais e ações externas. Prefira a menor autonomia e o menor conjunto de permissões que resolvam o caso. Se a decisão exigir os dois componentes, gere uma stack com arquivo de versões, CLAUDE.md e política inicial.

Montar stack com estes componentes · Analisar outra origem · Entender Trust Score

Perguntas frequentes

Qual componente é mais seguro?

Os metadados não permitem declarar segurança absoluta. Compare os sinais observados e teste no seu contexto.

Posso instalar os dois?

Sim, quando as capacidades forem complementares. Revise comandos duplicados, dependências, permissões combinadas e pontos de aprovação humana.

Quando preciso de governança?

Quando a composição toca dados reais, múltiplas áreas, credenciais, decisões operacionais ou produção. Nesse ponto, avalie Governança e Harness.

Plano de teste comparativo

Teste cada opção separadamente com a mesma entrada, o mesmo critério de qualidade e o menor acesso possível. Registre versão, tempo, resultado, erro e necessidade de retrabalho. Depois teste a composição somente se as capacidades forem complementares. Não conecte credenciais reais durante a primeira rodada. Se uma opção exigir rede, shell, arquivos ou ação externa, documente destino, reversibilidade e responsável pela aprovação antes de decidir.