安裝
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