安装
pnpm dlx @codeharbor/agent-playbook init适合谁
当你希望给编码 Agent 加上本地优先的 Behavior CI，也就是行为持续集成时，使用 Agent Playbook。官方一句话定位是 Local-first Behavior CI for coding agents。它会为 Claude Code、Codex、Gemini 和 DeepSeek Harness 配置技能。适合已经在用这四类宿主、并且接受 init 会往仓库写入配置的人。摘要还写到它把反复纠正变成可逆的行为改动，但页面那句介绍没有展开机制，因此不要把未写出的收件箱或自我改进流程当成已证实能力。若你不能接受任何 hooks 采集，应保持默认：新安装会关掉 Claude hooks。
3 分钟完成第一次尝试
推荐只走官方首选初始化：
pnpm dlx @codeharbor/agent-playbook init
同一页也给出 npm 写法：
npm exec -- @codeharbor/agent-playbook init
第一次用 pnpm 这条。这会写文件，不属于只读。先让 Agent 复述：将在当前仓库执行 init、为 Claude Code、Codex、Gemini、DeepSeek Harness 配置技能、默认不启用 Claude hooks。你确认工作区路径后，再允许运行。不要改成未出现的 skills add，也不要臆造技能目录。
成功信号：初始化结束，并且 hooks 仍保持关闭，除非你当时明确要求加 --hooks。官方写明 apb 是 agent-playbook 的短别名；第一次不要发明 apb 子命令，页面只保证别名本身。初始化后做一次只读提问，让 Agent 说明 Behavior CI 在本仓库意味着什么，先不改行为规则。
使用案例
案例一：为四类宿主初始化技能。在项目根目录运行 init，让 Claude Code、Codex、Gemini 或 DeepSeek Harness 读到 Playbook 技能。适合想把行为约束留在本地仓库的人。说明没有列出将生成的文件名，因此执行前只能确认“会写配置”，不能预填路径。
案例二：显式打开 Claude hooks。官方写明新安装默认禁用；只有加上 --hooks 才会启用有边界、经脱敏的私有会话摘要和失败捕获。适合需要回顾失败会话、并且接受摘要采集的人。打开前必须让 Agent 复述：将启用 bounded、redacted 的私有摘要与失败捕获，而不是默认安装。不要把 --hooks 加到未记载的其他客户端开关上。摘要提到的行为收件箱与自我改进，页面没有给出命令，缺了就不要编。
使用边界
默认命令是 pnpm dlx @codeharbor/agent-playbook init。npm exec 是并列写法，不是第三条安装器。宿主名单是 Claude Code、Codex、Gemini、DeepSeek Harness，这是会配置技能的范围，不是“只有这四家能读 SKILL.md”的全球断言。新安装默认关 hooks；--hooks 才采集脱敏摘要。apb 只被写成别名。未写明的子命令、目录和市场安装都不要补。仓库页：
https://github.com/zhaono1/agent-playbook