序言
为什么要写这本小册
Claude Code 的官方文档会告诉你有什么功能：CLAUDE.md 是什么文件、hook 有几种 event、skill 怎么定义。
但它不会告诉你：
- 同一条规则，放 CLAUDE.md、auto-memory、skill、还是 hook？
- 为什么 Claude "总是记不住"某些事？
- 开子 Agent 是加速还是添堵？怎么判断？
- Claude 说"已完成"，你该不该信？
这些不是"功能问题"，是协作经验问题。功能手册讲不清，只有反复踩坑后才能总结。
这本小册就是来填这块空白的。
这本小册不是什么
- ❌ 不是 API 参考。API / 工具细节查官方文档。
- ❌ 不是安装指南。假设你已经装好 Claude Code 能用了。
- ❌ 不是功能巡游。不会逐个介绍每个 slash command。
- ❌ 不是 Prompt Engineering 101。更偏"协作架构"，不偏"怎么写 prompt"。
这本小册是什么
- ✅ 日常协作的最佳实践：节奏、分工、纪律
- ✅ 配置层的选择决策：什么该放哪、什么不该
- ✅ 翻车案例合集：从失败里提炼模式
前置要求
- 至少用过 Claude Code 做过几次真实任务
- 了解基础概念：CLAUDE.md、会话、工具调用
- 有一份自己的项目可以随时对照实践
八篇之间的关系
八篇分为四个层次，对应"Claude 协作"的四个维度：
- 配置层（1-3）：把规则、知识、流程摆到该在的位置
- 协作层（4-5）：日常对话和任务分发的节奏
- 纪律层（6-7）：强制保证和工作流规范
- 复盘层（8）：前面所有篇的反面教材整合
读完这本小册你会得到
- 识别力：看到一条需求，能判断它该进 CLAUDE.md、auto-memory、skill 还是 hook
- 设计力：能写出精准的 CLAUDE.md、合理分层的记忆、有效的 skill、靠谱的 hook
- 协作力：知道 Plan / Execute / Review 的节奏、子 Agent 的成本账、commit / PR 的纪律
- 防御力：看到 12 个反模式的名字就能对号入座避开
一句话总纲：
把 Claude 当成一个有工具权限的、记忆力不稳定的、需要明确指令的合作者。你会用得好。