CLAUDE.md（llm/claude 目录）

本目录存放「Claude 深度解读」系列文章（解读 Anthropic / Claude 官方博客等）。本文件是子目录级规则，自动叠加在仓库根 CLAUDE.md 之上，根目录的写作规范、配图规范全部继续生效，这里只补充本目录的特殊约定。

文章篇幅：控制在 markdown 100 行左右

本系列文章篇幅以 markdown 100 行左右为最佳，不要超过 150 行——超过读者很容易看不下去。解读类文章贵在「捞出最值钱的几点 + Carl 的观点」，不要把原文每一段都翻译复述。内容多时优先做减法、做取舍，而不是堆长。

文末必须给参考链接

本系列每篇文章末尾都要有一个「参考链接」小节，列出解读所依据的来源——通常就是对应的 Claude / Anthropic 官方博客原文。格式固定为「来源（括号标简短主题）+ 中文冒号 + 裸 URL」，不用 markdown 链接语法：

## 参考链接

- Anthropic 官方博客（How we use skills）：https://claude.com/blog/lessons-from-building-claude-code-how-we-use-skills

有多个来源就列多条。注意这里外部原文用裸 URL，和正文里「站内互引用相对 .md 链接」是两回事。

drawio 源文件位置

• 本系列文章的 drawio 源文件统一放在 llm/claude/drawio/，不要放回 llm/drawio/。
• 导出的临时 PNG 仍走 /tmp，压缩上传图床后删除本地 PNG（同根 CLAUDE.md 流程）。

配图要可视化「原理」，不要堆文字

图的价值是把对应段落的原理/结构/关系/流程可视化，让读者一眼看懂文字讲了半天的东西。不要把图当成「文字的另一种排版」——满图都是文字框、要点罗列，那还不如不画。

• 画图前先问：这一段的原理是什么？哪个结构、对比、流程、数据变化值得画出来？围绕它设计图。
• 用图形语言表达：框的层次、箭头的方向、改前/改后的对比、数值的升降，而不是把段落原话搬进框里。
• 框里只放短标签 + 关键词，解释性的话留给正文。一张图讲清一个核心点即可。
• 反例：把「四个收益」各写一大段塞进四个框 → 那是排版不是可视化；正例：用「同容器三宗罪 vs 拆开 + session 连接」的结构对比图把解耦原理画出来。

每张图必须带「三件套」：logo + 水印 + 网址

本系列所有 drawio 配图，除正文内容外，必须固定带上以下三个元素（防盗用 + 引流）：

1. 右上角 K logo（base64 图片，约 79×79，放画布右上角）
2. 中间斜向半透明水印：公众号：卡码大模型
3. 底部网址：卡码笔记：https://notes.kamacoder.com/

三件套的 mxCell 样式如下（坐标按每张图的 pageWidth/pageHeight 调整，logo 放右上、水印放中央、网址放底部居中）：

<!-- 水印：斜向、半透明、居中 -->
<mxCell id="wm" parent="1" vertex="1"
  style="text;html=1;fontSize=16;textOpacity=35;rotation=-20;align=center;fillColor=none;strokeColor=none;fontColor=#666666;"
  value="公众号：卡码大模型">
  <mxGeometry height="30" width="260" x="100" y="274" as="geometry" />
</mxCell>

<!-- 网址：底部居中 -->
<mxCell id="site" parent="1" vertex="1"
  style="text;html=1;fontSize=15;align=center;fillColor=none;strokeColor=none;fontColor=#333333;"
  value="卡码笔记：https://notes.kamacoder.com/">
  <mxGeometry height="20" width="400" x="350" y="470" as="geometry" />
</mxCell>

<!-- logo：右上角，shape=image，image=data:image/png,<base64> -->
<mxCell id="logo" parent="1" vertex="1"
  style="shape=image;aspect=fixed;image=data:image/png,<这里是logo的base64>;"
  value="">
  <mxGeometry height="79" width="79" x="631" y="24" as="geometry" />
</mxCell>

实操建议：logo 的 base64 很长，新建图时直接从本目录已有的 drawio 复制这三个 cell（推荐 drawio/skill_anatomy.drawio），改一下坐标即可，不用重新找 logo、不用手敲 base64。

注意

• 画完图按根 CLAUDE.md 流程：CLI 导出 PNG → 发用户确认 → pngquant 压缩 → 上传图床 → 插入文章。
• 用户可能会在 draw.io 桌面版里手动重排版、补三件套，导出/上传前以 llm/claude/drawio/ 下的最新文件为准，不要用旧的 /tmp 导出。