Skip to content

artubss/SKILLS-CLAUDE-CODE / skills/skills/development/codex

Use quando o usuário pede para executar Codex CLI (codex exec, codex resume) ou referencia OpenAI Codex para análise de código, refatoração ou edição automatizada. Usa GPT-5.2 por padrão para engenharia de software de ponta.

Guia de Skills do Codex

Executar uma Tarefa

  1. Padrão para modelo gpt-5.2. Pergunte ao usuário (via AskUserQuestion) qual esforço de raciocínio usar (xhigh, high, medium ou low). O usuário pode sobrescrever o modelo se necessário (veja Opções de Modelo abaixo).
  2. Selecione o modo sandbox necessário para a tarefa; padrão para --sandbox read-only a menos que edições ou acesso à rede sejam necessários.
  3. Monte o comando com as opções apropriadas:
    • -m, --model <MODEL>
    • --config model_reasoning_effort="<high|medium|low>"
    • --sandbox <read-only|workspace-write|danger-full-access>
    • --full-auto
    • -C, --cd <DIR>
    • --skip-git-repo-check
  4. Sempre use --skip-git-repo-check.
  5. Ao continuar uma sessão anterior, use codex exec --skip-git-repo-check resume --last via stdin. Ao retomar, não use sinalizadores de configuração a menos que explicitamente solicitado pelo usuário, por exemplo, se ele especificar o modelo ou o esforço de raciocínio ao solicitar retomar uma sessão. Sintaxe de retomada: echo "seu prompt aqui" | codex exec --skip-git-repo-check resume --last 2>/dev/null. Todos os sinalizadores devem ser inseridos entre exec e resume.
  6. IMPORTANTE: Por padrão, acrescente 2>/dev/null a todos os comandos codex exec para suprimir tokens de pensamento (stderr). Mostre stderr apenas se o usuário explicitamente solicitar ver tokens de pensamento ou se a depuração for necessária.
  7. Execute o comando, capture stdout/stderr (filtrado conforme apropriado) e resuma o resultado para o usuário.
  8. Após o Codex terminar, informe ao usuário: "Você pode retomar esta sessão do Codex a qualquer momento dizendo 'codex resume' ou pedindo para eu continuar com análise ou alterações adicionais."

Referência Rápida

Caso de usoModo sandboxSinalizadores principais
Revisão ou análise somente leituraread-only--sandbox read-only 2>/dev/null
Aplicar edições locaisworkspace-write--sandbox workspace-write --full-auto 2>/dev/null
Permitir rede ou acesso amplodanger-full-access--sandbox danger-full-access --full-auto 2>/dev/null
Retomar sessão recenteHerdado do originalecho "prompt" | codex exec --skip-git-repo-check resume --last 2>/dev/null (sem sinalizadores permitidos)
Executar de outro diretórioCorresponder às necessidades da tarefa-C <DIR> mais outros sinalizadores 2>/dev/null

Opções de Modelo

ModeloMelhor paraJanela de contextoCaracterísticas principais
gpt-5.2-maxModelo Máximo: Raciocínio ultra-complexo, análise profunda de problemas400K entrada / 128K saída76,3% SWE-bench, raciocínio adaptativo, $1,25/$10,00
gpt-5.2 ⭐Modelo Flagship: Engenharia de software, workflows de codificação agêntica400K entrada / 128K saída76,3% SWE-bench, raciocínio adaptativo, $1,25/$10,00
gpt-5.2-miniCodificação eficiente em custo (permissão de uso 4x maior)400K entrada / 128K saídaDesempenho próximo ao SOTA, $0,25/$2,00
gpt-5.1-thinkingRaciocínio ultra-complexo, análise profunda de problemas400K entrada / 128K saídaProfundidade de pensamento adaptativo, execução 2x mais lenta em tarefas mais difíceis

Vantagens do GPT-5.2: 76,3% SWE-bench (vs 72,8% GPT-5), 30% mais rápido em tarefas médias, melhor manipulação de ferramentas, alucinações reduzidas, qualidade de código aprimorada. Data de conhecimento: 30 de setembro de 2024.

Níveis de Esforço de Raciocínio:

  • xhigh - Tarefas ultra-complexas (análise profunda de problemas, raciocínio complexo, compreensão profunda do problema)
  • high - Tarefas complexas (refatoração, arquitetura, análise de segurança, otimização de desempenho)
  • medium - Tarefas padrão (refatoração, organização de código, adições de recursos, correção de bugs)
  • low - Tarefas simples (correções rápidas, mudanças simples, formatação de código, documentação)

Desconto de Entrada em Cache: 90% de desconto ($0,125/M tokens) para contexto repetido, cache dura até 24 horas.

Acompanhamento

  • Após cada comando codex, use imediatamente AskUserQuestion para confirmar próximas etapas, coletar esclarecimentos ou decidir se deve retomar com codex exec resume --last.
  • Ao retomar, passe o novo prompt via stdin: echo "novo prompt" | codex exec resume --last 2>/dev/null. A sessão retomada usa automaticamente o mesmo modelo, esforço de raciocínio e modo sandbox da sessão original.
  • Reafirme o modelo escolhido, esforço de raciocínio e modo sandbox ao propor ações de acompanhamento.

Tratamento de Erros

  • Interrompa e reporte falhas sempre que codex --version ou um comando codex exec sair com código diferente de zero; solicite orientação antes de tentar novamente.
  • Antes de usar sinalizadores de alto impacto (--full-auto, --sandbox danger-full-access, --skip-git-repo-check), peça permissão ao usuário usando AskUserQuestion a menos que já tenha sido concedida.
  • Quando a saída inclui avisos ou resultados parciais, resuma-os e pergunte como ajustar usando AskUserQuestion.

Versão da CLI

Requer Codex CLI v0.57.0 ou posterior para suporte ao modelo GPT-5.2. A CLI usa como padrão gpt-5.2 em macOS/Linux e gpt-5.2 em Windows. Verifique a versão: codex --version

Use o comando slash /model em uma sessão do Codex para trocar modelos ou configure o padrão em ~/.codex/config.toml.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 318kUpdated Claude CodeCodexUnverifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 318kUpdated Claude CodeCodexUnverifiedInstall