| name | make-textbook-figure |
| description | 构建教材级别的黑白矢量插图（几何图、受力分析图、光路图、电路图、函数图像、坐标系、物理/数学示意图等），以自包含 HTML 文件呈现——所有线条用 SVG 绘制，所有公式、符号、运算符、物理/数学符号用 LaTeX 经 MathJax 渲染为矢量，支持一键导出高清 PNG。当用户说"画个教材图/教材插图/教学示意图""画受力分析图/光路图/电路图/函数图/几何图""做一张黑白矢量图/示意图""把这道题/这个原理配张图""画个坐标系/数轴"，或任何为教材、讲义、试卷、课件绘制精确黑白教学插图的需求时，必须使用本技能，即使用户没明说"教材"二字。注意：本技能与 make-infographic 不同——make-infographic 做彩色信息图/海报（给家长客户看，版式驱动），本技能做黑白精确教学插图（给师生用，准确性驱动），不要混用。 |
构建教材黑白矢量插图（SVG + LaTeX + 高清 PNG 导出）
这个技能产出什么
一张教材级别的黑白矢量插图，交付为自包含 HTML 文件（双击可在浏览器打开预览），可一键导出高清 PNG。适用于教材、讲义、试卷、课件中需要精确线条 + 数学/物理符号的示意图：几何证明图、受力分析图、光路图、电路图、函数图像、坐标系等。
硬性约束（违反即不合格）
这些约束来自教材插图的本质要求——精确、规范、可印刷。理解了"为什么"，执行时才不会走偏：
-
黑白矢量风格：仅用 #000（黑）/#fff（白）+ 1–2 级灰度（#555 / #e5e5e5）。不用彩色、渐变、阴影、彩色填充。原因：教材多为黑白印刷，彩色会印成不可控灰阶；矢量才能任意缩放不糊。用线型区分语义：实线=实体边界/已知线，虚线=辅助线/隐藏边，点划线=对称轴，箭头=力/方向。
-
所有公式、符号、运算符、物理/数学符号必须用 LaTeX 渲染：经 MathJax tex-svg.js 渲染为矢量。禁止用 Unicode 字符凑（½ ² √ θ → ≈ 等）——它们字体不统一、排版不专业、上下标错位。正确写法：$\frac{1}{2}$ $x^2$ $\sqrt{x}$ $\theta$ $\to$ $\approx$。
-
图形必须用 SVG 绘制：线条、形状、箭头都是 SVG 元素。禁止用 Canvas（位图，缩放必糊）、禁止用位图截图充当矢量。
-
教学准确性：标注、比例、符号、方向必须符合学科规范（力的箭头从作用点沿方向画出、光路图光线带方向、电路符号标准化）。这是教材插图的命脉——一张画错的受力图会直接误导学生。
工作流程
1. 明确图的内容（信息不全就问）
用 AskUserQuestion 问清：学科与图类型（几何/力学/电学/光学/函数…）、要表达什么（哪个原理/哪道题）、关键要素（哪些力、哪些点、哪些量）。宁可多问一句，不要画错重画。
2. 设计 SVG 结构与 LaTeX 标注
规划：画布尺寸（默认 720×420）、坐标系/基准线、主要几何元素（用哪类线型）、需要的数学标注（变量、符号、公式）及其大致坐标。
3. 基于 template.html 生成自包含 HTML
复制 ${CLAUDE_SKILL_DIR}/assets/template.html 为起点，替换三部分：<svg> 里的几何元素、.anno 标注的坐标（left/top = SVG 坐标）与 LaTeX 公式、.figure-title 标题与 .figure-caption 图注。
关键技术点（务必遵守）：SVG 只画线条/形状，数学标注用 <span class="anno"> 绝对定位叠加——因为 SVG <text> 不能承载 MathJax 渲染的公式。由于模板里 viewBox 与 width/height 一致，叠加标注的 left/top 直接填 SVG 坐标即可。各类图的画法见 ${CLAUDE_SKILL_DIR}/references/svg-drawing-guide.md。
4. 视觉质检（用视觉模型看截图）
生成 HTML 后，用 Playwright/webapp-testing 打开截图，用视觉模型检查：
- 公式是否全部 LaTeX 渲染（无裸 Unicode、无未渲染的
$）
- 是否黑白矢量风格（无彩色/渐变）
- 线条是否精确、线型语义是否正确
- 标注位置是否对齐、有无重叠遮挡
- 学科内容是否准确
发现问题就回到第 3 步修正。
5. 导出高清 PNG
在浏览器中打开 HTML，点右上角"导出高清 PNG"按钮，下载后存到 AI_output/（文件名与内容相符）。导出依赖网络（MathJax/html-to-image 走 CDN）。导出细节与排坑见 ${CLAUDE_SKILL_DIR}/references/export-guide.md。
参考资料
${CLAUDE_SKILL_DIR}/references/svg-drawing-guide.md —— 坐标系、箭头、线型语义，以及受力图/光路图/电路图/函数图/几何图的 SVG 画法（画图前读对应章节）${CLAUDE_SKILL_DIR}/references/latex-cheatsheet.md —— 教材常用 LaTeX（希腊字母、上下标、向量、求和积分、物理符号、矩阵）+ 禁止 Unicode 对照表${CLAUDE_SKILL_DIR}/references/export-guide.md —— 高清 PNG 导出三要素与排错表${CLAUDE_SKILL_DIR}/assets/template.html —— 复制即用的黑白矢量模板
交付前自检清单
