Agent Playbook: Behavior CI local-first para agentes

Para quem

Use o Agent Playbook quando quiser acrescentar a um Agent de código um Behavior CI local-first, ou seja, integração contínua de comportamento. A posição oficial numa frase é Local-first Behavior CI for coding agents. Configura competências para Claude Code, Codex, Gemini e DeepSeek Harness. Encaixa se já usa estes quatro anfitriões e aceita que o init escreve configuração no repositório. O resumo também diz que transforma correções repetidas em mudanças de comportamento reversíveis, mas essa frase introdutória não desdobra o mecanismo; não trate uma caixa de entrada ou um fluxo de auto-melhoria não escritos como capacidade comprovada. Se não puder aceitar qualquer captura por hooks, fique no predefinido: uma instalação nova desliga os Claude hooks.

Primeira tentativa em 3 minutos

Recomende só a inicialização oficial de primeira escolha:

pnpm dlx @codeharbor/agent-playbook init

A mesma página também dá a forma npm:

npm exec -- @codeharbor/agent-playbook init

Na primeira vez, use a linha pnpm. Isto escreve ficheiros; não é só de leitura. Primeiro faça o Agent repetir: vai executar init no repositório atual, configurar competências para Claude Code, Codex, Gemini e DeepSeek Harness, e deixar os Claude hooks desligados por omissão. Depois de confirmar o caminho do espaço de trabalho, permita a execução. Não o reescreva como um skills add que nunca aparece e não invente um diretório de competências.

Sinal de sucesso: o init termina e os hooks ficam desligados, salvo se nesse momento pediu --hooks de forma explícita. Oficialmente apb é um alias curto de agent-playbook; na primeira vez não invente subcomandos apb — a página só garante o alias. Após o init, faça uma pergunta só de leitura e peça ao Agent que explique o que Behavior CI significa neste repositório, sem ainda alterar regras de comportamento.

Exemplos de uso

Exemplo 1: inicializar competências para os quatro anfitriões. Execute init na raiz do projeto para que Claude Code, Codex, Gemini ou DeepSeek Harness leiam competências Playbook. Encaixa se quiser que as restrições de comportamento fiquem no repositório local. As notas não nomeiam os ficheiros que serão gerados; antes de executar só pode confirmar «vai escrever configuração», não pré-preencher caminhos.

Exemplo 2: ligar Claude hooks de forma explícita. Oficialmente uma instalação nova desativa-os por omissão; só ao acrescentar --hooks se ativam resumos de sessão privados limitados e redigidos, mais a captura de falhas. Encaixa se precisa de olhar para trás sessões falhadas e aceita a captura de resumos. Antes de os ligar, faça o Agent repetir: vai ativar resumos privados bounded, redacted e captura de falhas, não a instalação predefinida. Não acrescente --hooks a um interruptor não documentado de outro cliente. O resumo menciona uma caixa de entrada de comportamento e auto-melhoria; a página não dá comando, não invente um.

Limites

O comando predefinido é pnpm dlx @codeharbor/agent-playbook init. npm exec é uma grafia paralela, não um terceiro instalador. Os nomes de anfitrião são Claude Code, Codex, Gemini e DeepSeek Harness — o âmbito que receberá competências configuradas, não uma afirmação mundial de que «só estes quatro conseguem ler SKILL.md». Instalações novas deixam os hooks desligados; --hooks é o que captura resumos redigidos. apb só está escrito como alias. Não complete subcomandos, diretórios nem instalações de loja não escritos. Página do repositório:

https://github.com/zhaono1/agent-playbook