Minimal Codex Recap

Um skill minúsculo e exclusivamente manual, inspirado no /recap do Claude Code, que resume a conversa atual do Codex em exatamente três linhas.

In English · Instalação · Diferenças · Segurança

Inspiração e atribuição

O Minimal Codex Recap nasceu inspirado na experiência do /recap do Claude Code: a ideia simples e útil de se reorientar rapidamente dentro de uma sessão. Esta implementação foi escrita do zero para o Codex, com um contrato próprio de três linhas, ativação exclusivamente manual e fonte limitada à conversa atual.

Este é um projeto independente. Ele não é afiliado, endossado nem mantido pela Anthropic. O crédito acima reconhece a inspiração do produto; não indica compatibilidade oficial nem reutilização de código. Há um registro público do recurso no repositório do Claude Code.

Por quê?

Depois de uma conversa longa com um agente, três informações costumam ficar espalhadas: onde o trabalho parou, o que ainda falta e o que deve acontecer em seguida.

$recap responde somente essas três perguntas. Ele não cria memória persistente, não inspeciona o projeto, não executa comandos, não chama ferramentas e não altera estado. A única fonte é o contexto já presente na conversa atual do Codex.

Contrato de saída

Toda invocação retorna exatamente três linhas no idioma dominante da conversa. Em português:

Onde paramos: ...
Pendente: ...
Próxima ação: ...

Se não houver evidência suficiente na conversa, o skill usa respostas seguras em vez de inventar progresso:

Onde paramos: nenhum trabalho anterior foi identificado nesta conversa.
Pendente: nada identificado.
Próxima ação: aguardar nova instrução.

Em uma conversa em inglês, o skill usa os rótulos e as respostas seguras em inglês, sem misturar idiomas. Os exemplos completos estão em In English. Quando não houver contexto suficiente para identificar o idioma, o padrão é português.

Instalação

Skills CLI

npx skills add LightWolfMan/minimal-codex-recap@recap -g -y

Depois da instalação, reinicie o Codex ou abra uma tarefa nova para recarregar a lista de skills.

Instalação manual no Windows

$destination = Join-Path $HOME ".codex\skills\recap"
New-Item -ItemType Directory -Force -Path (Join-Path $destination "agents") | Out-Null
Copy-Item .\skills\recap\SKILL.md (Join-Path $destination "SKILL.md")
Copy-Item .\skills\recap\agents\openai.yaml (Join-Path $destination "agents\openai.yaml")

Instalação manual no macOS ou Linux

mkdir -p ~/.codex/skills/recap/agents
cp skills/recap/SKILL.md ~/.codex/skills/recap/SKILL.md
cp skills/recap/agents/openai.yaml ~/.codex/skills/recap/agents/openai.yaml

Uso

Abra uma tarefa nova do Codex e digite:

$recap

O $ é importante. Este é um skill invocado manualmente, não um comando /recap. A configuração policy.allow_implicit_invocation está explicitamente definida como false.

O idioma é escolhido pelas mensagens substantivas mais recentes do usuário: português para conversas em português e inglês para conversas em inglês.

O diretório global de skills é compartilhado pelo Codex App e pelo Codex CLI, portanto a mesma instalação funciona nas duas superfícies.

Segurança e escopo

Propriedade	Comportamento
Ativação	Exclusivamente manual por $recap
Fonte	Somente a conversa atual
Idioma	Português ou inglês, conforme a conversa
Leitura de arquivos	Proibida pelo skill
Ferramentas	Proibidas pelo skill
Memória persistente	Não utilizada
Rede	Não solicitada
Alterações de estado	Proibidas pelo skill
Dependências de execução	Nenhuma
Código executável incluído	Nenhum

Este é um skill composto apenas por instruções. Como ocorre com qualquer instrução para um LLM, o repositório documenta e testa o contrato pretendido; a execução final depende de o ambiente do Codex seguir o skill carregado.

Como ele se diferencia

Existem projetos excelentes com nomes próximos, mas objetivos diferentes:

Projeto	Objetivo principal	Estado persistente	Ferramentas ou scripts	Saída típica
Minimal Codex Recap	Retrato da conversa atual	Não	Não	Exatamente três linhas
AgentMemory Recap	Resumir várias sessões armazenadas	Sim	Sim	Sessões agrupadas por data
BuilderIO Quick Recap	Adicionar rodapé verde/amarelo/vermelho	Não	Instruções gerenciadas pelo instalador	Uma linha de status
Session Handoff	Salvar e retomar contexto entre sessões	Sim	Sim	Documentos de transição

Este projeto não é afiliado a esses projetos. Eles aparecem como referências e alternativas úteis para quem precisa de fluxos mais abrangentes.

Validação

A versão 1.1.0 faz a saída acompanhar o idioma da conversa sem mudar os limites de segurança nem o contrato de três linhas. O skill foi validado com:

• o quick_validate.py oficial do Codex;
• cenários em português e inglês com contexto conhecido;
• cenários em português e inglês sem contexto suficiente;
• teste rápido global em processo novo do Codex CLI e ambiente isolado somente leitura;
• inspeção de eventos confirmando ausência de ferramentas nos turnos de recap.

Execute os testes de contrato do repositório, sem dependências externas:

python tests/validate_skill.py

A integração contínua repete o teste no Windows e no Ubuntu.

Integridade

Hashes SHA-256 aprovados para a versão 1.1.0:

Arquivo	SHA-256
skills/recap/SKILL.md	3EEB98C2DED080701B4C6440641258F358745DDB65B89FF6823C3BC80073A604
skills/recap/agents/openai.yaml	43493E9963711B7F4342B6A6AB50B4F2922CE35C78CB2E9C40B7CB73FA18E756

Licença

MIT © 2026 LightWolfMan. Há uma tradução informativa em português brasileiro; em caso de divergência, prevalece o texto canônico em inglês de LICENSE.