Revisão de Código Aberta — Modo de Delegação

Esta habilidade do plugin Codex espelha intencionalmente a habilidade canônica em skills/open-code-review-delegate/SKILL.md. Mantenha ambos os arquivos sincronizados ao atualizar as instruções de delegação do OCR; um link simbólico é evitado porque as instalações de plugins podem materializar apenas a subárvore do plugin.

Uma habilidade para realizar revisão de código por IA onde o OCR fornece engenharia determinística (filtragem de arquivos, resolução de regras) e o agente host realiza a revisão real usando sua própria inteligência e ferramentas.

Fluxo de Trabalho

Etapa 1: Pré-visualização — Determinar o Que Revisar

ocr delegate preview --format json [--from <ref> --to <ref>] [--commit <hash>] [--exclude <patterns>]

Isso gera:

• modo (workspace / range / commit)
• from / to / commit / merge_base — metadados de referência para construir comandos git
• Lista de arquivos revisáveis — caminhos, status, inserções/exclusões
• Arquivos excluídos — com motivo da exclusão

Invocações comuns:

Etapa 2: Obter Regras para Arquivos

ocr delegate rule --format json <path1> <path2> ...

Passe os caminhos dos arquivos revisáveis da Etapa 1. A saída é agrupada por conteúdo de regra — arquivos que compartilham a mesma regra aparecem sob um grupo, evitando repetição.

Etapa 3: Obter Diffs

Escolha o comando diff usando o modo e as referências da Etapa 1. Use git --no-pager para cada chamada Git durante a revisão.

Os comandos diff desativam programas de diff externos, conversão de texto e cores para produzir patches simples.

Modo de intervalo (merge_base fornecido na saída de pré-visualização):

git --no-pager diff --no-ext-diff --no-textconv --no-color <merge_base>..<to> -- "<path>"

Modo de commit:

git --no-pager show --no-ext-diff --no-textconv --no-color <commit> -- "<path>"

Modo de espaço de trabalho:

# Tracked files
git --no-pager diff --no-ext-diff --no-textconv --no-color HEAD -- "<path>"
# New untracked files — read directly (entire file is new code)
cat "<path>"

Para ler o contexto:

git --no-pager log --no-color --oneline -- "<path>"
git --no-pager blame --no-textconv -- "<path>"
git --no-pager show --no-ext-diff --no-textconv --no-color "<ref>:<path>"

Para diffs grandes, adicione --output="<absolute-diff-file>" ao comando para o modo selecionado. Escolha um caminho absoluto exclusivo fora do repositório e crie seu diretório pai. Use o mesmo caminho nas chamadas da ferramenta de leitura de arquivos:

git --no-pager diff --no-ext-diff --no-textconv --no-color --output="<absolute-diff-file>" <merge_base>..<to> -- "<path>"

Após o Git sair com código 0, leia e revise o arquivo inteiro em partes, depois remova-o. Se o Git falhar ou atingir o tempo limite, tente novamente ou registre skipped com o erro. Verifique a saída inesperadamente vazia em relação a uma pré-visualização recente.

Etapa 4: Revisar Cada Arquivo

Crie uma lista de verificação contendo cada entrada reviewable_files. Para cada arquivo revisável:

Use (path, status) como identidade da lista de verificação. O modo de espaço de trabalho pode relatar o mesmo caminho duas vezes quando uma exclusão preparada é seguida por uma recriação não rastreada.

1. Obtenha seu diff (Etapa 3)
2. Consulte seu Grupo de Regras (da Etapa 2) para a lista de verificação de revisão
3. Realize uma revisão completa, usando ferramentas de contexto apropriadas conforme necessário
4. Marque o arquivo reviewed, ou skipped com um motivo concreto

Para alterações grandes, revise em lotes limitados agrupados por regras compartilhadas e tamanho do diff. Não pare após encontrar o primeiro problema de alta gravidade.

Etapa 5: Formatar Saída

Cada comentário deve seguir esta estrutura:

Etapa 6: Classificar e Relatar

Antes de relatar, verifique se todos os arquivos pré-visualizados foram contabilizados. Inclua total_files, reviewed_files, skipped_files e coverage_rate no resumo. Um arquivo pulado deve incluir seu motivo.

Agrupe as descobertas por gravidade:

• Crítico/Alto: Bugs, problemas de segurança, riscos de perda de dados — sempre relate

…