القائمة
在 TeX 项目中创建或修复 TikZ 图，当任务需要复用样式、在隔离的 scratch 文件中渲染、基于单张图片做可视化检查，并在集成回主文档前反复迭代修正时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
当用户要“学懂”概念、论文、方法、指标或推导时使用。适合容易出现“抽象先于理解”的场景：符号、矩阵、概率、递推式、参数或公式如果直接抛出，用户大概率会继续追问“这是什么”“这一步为什么这样来”。
先由记忆继承 subagent 产出 `plan.md` 和 `verify.md`，再按文件 ownership 串并行派发 worker，最后由主 agent 亲自复核验收门禁的多阶段执行技能。适用于用户明确要求“先计划、后门禁、再由 workers 执行”的任务。
创建或修改 TeX/LaTeX 文档。适用于新建中文笔记、讲义、报告、幻灯片，或整理 TeX 目录结构，特别是需要把 tex、pdf、build 分开的任务。
在 TeX 文档里把数学推导写成 Lean4 风格的逐步改写。适用于用户希望把长串连等式改成“文字说明 + 改写后的公式 + 高亮本次变化块”的场景。
| name | tikz-diagram-loop |
| description | 在 TeX 项目中创建或修复 TikZ 图，当任务需要复用样式、在隔离的 scratch 文件中渲染、基于单张图片做可视化检查，并在集成回主文档前反复迭代修正时使用。 |
当你需要创建或修复一个 TikZ 图，而且“渲染出来的图像本身”才是真正的验收标准时，使用这个 skill。
在图形设计和调试阶段，不要编译主 PDF。
main.tex、main_zh-cn.tex、幻灯片源文件或论文主文件里反复迭代。rg -n "tikzpicture|tikzset|usetikzlibrary|node\\[" <target-dir>。--preamble-file 让 scratch 工作区指向真实 preamble。典型结果：
scratch/
└── gru-figure/
├── figure.tex
├── build/
├── artifacts/
└── NOTES.md
figure.tex 使用 scripts/render_tikz.py。重复这个过程，直到隔离生成的 PNG 在不放大的情况下也清晰可读。
tikzpicture 拷回真实的 TeX 源文件。创建 scratch 工作区：
python3 .agents/skills/tikz-diagram-loop/scripts/init_tikz_scratch.py \
--dir /tmp/gru-figure \
--title "GRU Figure" \
--preamble-file /abs/path/preamble.tex
渲染 scratch 图：
python3 .agents/skills/tikz-diagram-loop/scripts/render_tikz.py \
--input /tmp/gru-figure/figure.tex \
--output-dir /tmp/gru-figure/artifacts
可选：对最终集成后的某一页 PDF 做检查：
python3 .agents/skills/tikz-diagram-loop/scripts/render_pdf_page.py \
--pdf /abs/path/main.pdf \
--page 3 \
--output /tmp/page-3.png