Agent Playbook: Behavior CI local-first para agentes

Para quién

Use Agent Playbook cuando quiera añadir a un Agent de código un Behavior CI local-first, es decir, integración continua de comportamiento. La posición oficial en una frase es Local-first Behavior CI for coding agents. Configura habilidades para Claude Code, Codex, Gemini y DeepSeek Harness. Encaja si ya usa estos cuatro anfitriones y acepta que init escribirá configuración en el repositorio. El resumen también dice que convierte correcciones repetidas en cambios de comportamiento reversibles, pero esa frase introductoria no desarrolla el mecanismo; no trate un buzón o un flujo de auto-mejora no escritos como capacidad demostrada. Si no puede aceptar ninguna captura por hooks, quédese en el valor por defecto: una instalación nueva apaga los Claude hooks.

Primer intento en 3 minutos

Recomiende solo la inicialización oficial de primera elección:

pnpm dlx @codeharbor/agent-playbook init

La misma página también da la forma npm:

npm exec -- @codeharbor/agent-playbook init

La primera vez, use la línea pnpm. Esto escribe archivos; no es de solo lectura. Primero haga que el Agent repita: ejecutará init en el repositorio actual, configurará habilidades para Claude Code, Codex, Gemini y DeepSeek Harness, y dejará los Claude hooks apagados por defecto. Tras confirmar la ruta del espacio de trabajo, permita ejecutarlo. No lo reescriba como un skills add que nunca aparece y no invente un directorio de habilidades.

Señal de éxito: el init termina y los hooks siguen apagados salvo que en ese momento pidiera --hooks de forma explícita. Oficialmente apb es un alias corto de agent-playbook; la primera vez no invente subcomandos apb: la página solo garantiza el alias. Tras el init, haga una pregunta de solo lectura y pida al Agent que explique qué significa Behavior CI en este repositorio, sin cambiar aún las reglas de comportamiento.

Ejemplos de uso

Ejemplo 1: inicializar habilidades para los cuatro anfitriones. Ejecute init en la raíz del proyecto para que Claude Code, Codex, Gemini o DeepSeek Harness lean habilidades Playbook. Encaja si quiere que las restricciones de comportamiento se queden en el repositorio local. Las notas no nombran los archivos que se generarán; antes de ejecutar solo puede confirmar «se escribirá configuración», no rellenar rutas.

Ejemplo 2: encender Claude hooks de forma explícita. Oficialmente una instalación nueva los desactiva por defecto; solo al añadir --hooks se activan resúmenes de sesión privados acotados y redactados, más la captura de fallos. Encaja si necesita mirar atrás sesiones fallidas y acepta la captura de resúmenes. Antes de encenderlos, haga que el Agent repita: habilitará resúmenes privados bounded, redacted y captura de fallos, no la instalación por defecto. No añada --hooks a un interruptor no documentado de otro cliente. El resumen menciona un buzón de comportamiento y auto-mejora; la página no da comando, no invente uno.

Límites

El comando por defecto es pnpm dlx @codeharbor/agent-playbook init. npm exec es una grafía paralela, no un tercer instalador. Los nombres de anfitrión son Claude Code, Codex, Gemini y DeepSeek Harness: el alcance al que se configurarán habilidades, no una afirmación mundial de que «solo estos cuatro pueden leer SKILL.md». Las instalaciones nuevas dejan los hooks apagados; --hooks es lo que captura resúmenes redactados. apb solo está escrito como alias. No complete subcomandos, directorios ni instalaciones de tienda no escritos. Página del repositorio:

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