Pular para o conteúdo principal

Hooks de agente

Os hooks de ciclo de vida versionados no repositório apenas formatam arquivos JavaScript/TypeScript editados com sucesso, usando o oxfmt instalado. A lógica compartilhada fica em scripts/agent-hooks/format.mjs; cada wrapper nativo delega para ela.

AppConfiguração nativaEvento
Codex.codex/hooks.jsonPostToolUse, apply_patch
Claude Code.claude/settings.jsonPostToolUse, `Edit

O Claude não lê um .claude/hooks.json avulso. Cada app continua controlando a confiança no projeto e se os hooks estão habilitados; inspecione as configurações atuais em vez de contornar a confiança. .codex/config.toml é configuração do repositório, não um registro de comandos de hook.

O formatador valida o evento/payload, o sucesso da edição, a extensão do arquivo e se ele está contido no repositório, inclusive considerando symlinks. Dependências ausentes ou entradas irrelevantes não geram nenhum trabalho. Os comandos usam um array de argumentos com o acesso à rede do Corepack desativado; hooks não instalam dependências, não rodam builds/revisões e não alteram o Git.

Rode as verificações explicitamente de acordo com verification.md. Rode yarn ai-workflow:sync, yarn ai-workflow:check e yarn ai-workflow:test depois de alterar o fluxo de trabalho. As fixtures usam arquivos descartáveis e invocações simuladas do formatador; elas não provam que cada app carregou sua configuração. Recarregue o app e inspecione o catálogo dele após atualizações.

A skill de design Impeccable e seus helpers executáveis continuam disponíveis sob demanda em .agents/skills/impeccable. O antigo hook dela no Codex apontava para um diretório inexistente; o fluxo de design agora roda quando a skill é selecionada, sem nenhum hook de design sempre ativo. A skill não deve reconfigurar os hooks do projeto como um passo incidental de design.