🧪 Skills no OpenAI Codex

O OpenAI Codex (tambem chamado de Codex CLI) e o agente de codificacao da OpenAI. Ele executa tarefas de desenvolvimento em um sandbox seguro, podendo ler e editar codigo, rodar testes e interagir com repositorios Git. Alimentado pelo GPT-4o, o Codex foi projetado para ser um assistente de codigo robusto e seguro.

O Codex se diferencia por rodar cada tarefa em um container sandbox isolado - similar ao Manus, mas focado exclusivamente em tarefas de desenvolvimento. Ele clona o repositorio, executa as mudancas e apresenta um diff para revisao.

O Codex busca skills no diretorio .agents/skills/ na raiz do repositorio. Cada arquivo Markdown neste diretorio e tratado como uma skill disponivel para o agente. O nome do arquivo determina o identificador da skill.

meu-projeto/
├── .agents/
│   ├── skills/
│   │   ├── code-review.md    # Skill de code review
│   │   ├── testing.md        # Skill de testes
│   │   └── refactoring.md    # Skill de refatoracao
│   └── AGENTS.md              # Instrucoes gerais do agente
├── AGENTS.md                  # Instrucoes raiz (tambem lido)
├── src/
│   └── AGENTS.md              # Instrucoes para /src
└── package.json

O Codex compartilha o formato AGENTS.md com o GitHub Copilot. Isso e intencional - ambos sao produtos do ecossistema GitHub/OpenAI e visam compatibilidade cruzada. Um AGENTS.md escrito para o Copilot funciona automaticamente no Codex e vice-versa.

# Agent Instructions

## Project Setup
This is a Next.js 14 project with TypeScript.
- Package manager: pnpm
- Test framework: Vitest
- Linter: ESLint + Prettier

## Code Standards
- Always use TypeScript strict mode
- Components in src/components/ as .tsx
- API routes in app/api/ using Route Handlers
- Database queries via Prisma ORM

## Before Submitting
- Run: pnpm lint
- Run: pnpm test
- Ensure no TypeScript errors: pnpm tsc --noEmit

A OpenAI mantem o repositorio openai/skills no GitHub como catalogo oficial de skills curadas. Este repositorio contem skills de referencia que demonstram melhores praticas e cobrem cenarios comuns de desenvolvimento.

As skills do catalogo oficial sao uteis de duas formas: como skills prontas para adicionar ao seu projeto, e como referencia de qualidade para criar suas proprias skills. A OpenAI mantem o catalogo atualizado e aceita contribuicoes da comunidade via Pull Requests.

A compatibilidade entre Codex e outras plataformas e facilitada pelo uso do formato AGENTS.md, que o Copilot tambem adota. Para maximizar portabilidade, o ideal e manter tanto AGENTS.md (para Copilot/Codex) quanto SKILL.md (para Claude Code/padrao universal).

meu-projeto/
├── SKILL.md                    # Universal (Claude Code, AgentSkills.io)
├── AGENTS.md                   # Copilot + Codex
├── .cursor/
│   └── rules/
│       └── main.mdc            # Cursor
├── .github/
│   └── copilot/
│       └── instructions.md     # Copilot repo-level
├── .agents/
│   └── skills/
│       └── coding.md           # Codex skills
└── src/

Criar skills otimizadas para o Codex envolve entender como o agente processa instrucoes no sandbox. Diferente de agentes em editores, o Codex executa tarefas inteiras e entrega resultados prontos, entao skills devem ser focadas em resultado final.

# Testing Skill

Quando solicitado a escrever testes:

## Framework
- Use Vitest para unit tests
- Use Playwright para E2E tests
- Coverage minima: 80%

## Padrao de Teste
```typescript
describe('NomeDaFuncao', () => {
  it('should handle happy path', () => {
    // Arrange
    // Act
    // Assert
  });

  it('should handle edge cases', () => {
    // Test boundary conditions
  });

  it('should handle errors', () => {
    // Test error scenarios
  });
});
```

## Validacao
Antes de finalizar, execute:
- pnpm test
- pnpm test:coverage
Garanta que todos os testes passam.