Agent Playbook : Behavior CI local-first pour agents

À qui s’adresse ce guide

Utilisez Agent Playbook quand vous voulez ajouter à un Agent de code un Behavior CI local-first, c’est-à-dire une intégration continue du comportement. La position officielle en une phrase est Local-first Behavior CI for coding agents. Il configure des compétences pour Claude Code, Codex, Gemini et DeepSeek Harness. Il convient si vous utilisez déjà ces quatre hôtes et acceptez que init écrive de la configuration dans le dépôt. L’accroche dit aussi qu’il transforme des corrections répétées en changements de comportement réversibles, mais cette phrase d’introduction n’explique pas le mécanisme ; ne traitez pas une boîte de réception ou un flux d’auto-amélioration non écrits comme une capacité prouvée. Si vous ne pouvez accepter aucune capture par hooks, restez au défaut : une nouvelle installation éteint les Claude hooks.

Premier essai en 3 minutes

Ne recommandez que l’initialisation officielle de premier choix :

pnpm dlx @codeharbor/agent-playbook init

La même page donne aussi la forme npm :

npm exec -- @codeharbor/agent-playbook init

La première fois, utilisez la ligne pnpm. Cela écrit des fichiers ; ce n’est pas en lecture seule. Faites d’abord répéter à l’Agent : il exécutera init dans le dépôt actuel, configurera des compétences pour Claude Code, Codex, Gemini et DeepSeek Harness, et laissera les Claude hooks éteints par défaut. Après confirmation du chemin de l’espace de travail, autorisez l’exécution. Ne le réécrivez pas en un skills add absent, et n’inventez pas de répertoire de compétences.

Signal de succès : l’init se termine, et les hooks restent éteints sauf si vous avez explicitement demandé --hooks à ce moment. Officiellement, apb est un alias court de agent-playbook ; la première fois, n’inventez pas de sous-commandes apb — la page ne garantit que l’alias lui-même. Après l’init, posez une question en lecture seule et faites expliquer à l’Agent ce que Behavior CI signifie dans ce dépôt, sans encore changer les règles de comportement.

Exemples d’usage

Exemple 1 : initialiser les compétences pour les quatre hôtes. Exécutez init à la racine du projet pour que Claude Code, Codex, Gemini ou DeepSeek Harness lisent les compétences Playbook. Convient si vous voulez que les contraintes de comportement restent dans le dépôt local. Les notes ne nomment pas les fichiers qui seront générés ; avant d’exécuter, vous ne pouvez confirmer que « de la configuration sera écrite », pas préremplir des chemins.

Exemple 2 : allumer explicitement les Claude hooks. Officiellement, une nouvelle installation les désactive par défaut ; seulement en ajoutant --hooks s’activent des résumés de session privés bornés et expurgés, plus la capture d’échecs. Convient si vous devez relire des sessions en échec et acceptez la capture de résumés. Avant d’allumer, faites répéter à l’Agent : il activera des résumés privés bounded, redacted et la capture d’échecs, pas l’installation par défaut. N’ajoutez pas --hooks à un interrupteur non documenté d’un autre client. L’accroche mentionne une boîte de réception de comportement et une auto-amélioration ; la page ne donne pas de commande, n’en inventez pas.

Limites

La commande par défaut est pnpm dlx @codeharbor/agent-playbook init. npm exec est une graphie parallèle, pas un troisième installeur. Les noms d’hôtes sont Claude Code, Codex, Gemini et DeepSeek Harness — le périmètre qui recevra des compétences configurées, pas une assertion mondiale que « seuls ces quatre peuvent lire SKILL.md ». Les nouvelles installations laissent les hooks éteints ; --hooks capture des résumés expurgés. apb n’est écrit que comme alias. Ne complétez pas sous-commandes, répertoires ou installations boutique non écrits. Page du dépôt :

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