让 AI 读懂你的项目

刚弄明白 .claude/ 这个目录是干嘛的——说白了，就是给 Claude 准备的入职手册加工具箱。

它让 AI 一进项目就懂规矩。核心就俩文件：CLAUDE.md 交代项目是啥，settings.json 划权限。前者建议压在 200 行内，越具体越好；后者管你能不能跑测试、能不能删文件，Claude 绕不过去。

项目大了再往上堆模块。规则拆进 rules/ 按需加载，常用流程塞进 skills/ 一键调用。遇到代码审查这种重活，就拉个专家子代理出来，独立上下文不干扰主会话。多代理怎么配合，交给 workflows/ 编排。

最坑的几个误区也清楚了：别把规则全塞进 CLAUDE.md，别手动改 agent-memory/，也别给所有代理开满权限。这东西得慢慢来，先配最小配置，团队用顺了再加流程，项目复杂了才上代理。

投入产出挺实在：花半小时写 CLAUDE.md，以后每次会话省下 5–10 分钟解释；花两小时封装 skills/，复杂流程就能一键跑起来。