1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | opentikz |
| 作者/维护者 | OpenTikZ contributors（XueyanZhang 为主要维护者，另有 1 名协作者） |
| 来源链接 | https://github.com/opentikz/opentikz |
| 许可证 | 代码 MIT（LICENSE-CODE），图形内容 CC0 1.0（LICENSE-CONTENT）——GitHub API 因仓库采用双许可证文件而显示 NOASSERTION，读取两份原始文件已确认内容清晰 |
| GitHub Stars | 210（GitHub API 实测） |
| Forks | 4（GitHub API 实测） |
| 最新版本 | v0.2.0（插件清单版本号；GitHub 最新发布 tag 为 v0.1.0，“首个公开发布”） |
| 安装方式 | Claude Code 插件市场一键安装，或直接克隆仓库指向 SKILL.md |
2. 功能介绍与亮点
OpenTikZ 是一个面向学术论文作者的 TikZ 图形库 + Claude Code 技能，定位是“学术 TikZ 版的 Flaticon”。它提供三类可复用素材：图标（服务器、GPU、云、神经元等系统/机器学习图标，加上 PyTorch、Hugging Face 等品牌图标，共 61 个）、可编辑模板（前馈神经网络、编码器-解码器、LLM 服务栈、训练流水线、系统架构图等 9 个）、完整示例（LoRA、FlashAttention、GAN 等论文级组合图 3 个）。
核心亮点是每个模板都自带 edit_contract（写在 meta.json 里），明确规定可改的参数、操作步骤与不可破坏的不变量（如节点命名规则、统一配色）。技能据此把“改一下这张图”的请求锚定到真实模板上编辑，而不是让大模型凭记忆现写 TikZ——后者常见的问题是配色随意、宏包臆造、编译失败。技能还会在交付前实际跑 latexmk/pdflatex 编译验证，确保拿到手的就是能编译通过的图。
3. 适用场景
所属分类：内容创作与知识管理
适合经常写论文、技术报告或幻灯片、需要插入系统架构图/神经网络结构图/流程图的用户——机器学习论文作者画模型结构图、系统论文作者画架构图、以及任何需要“矢量、可编辑、跟论文字体统一”的图形而不想手写 TikZ 语法的初中级 Claude Code 用户。不需要写代码，用自然语言描述图形改动即可。
4. 跨 Agent 兼容性
- Claude Code：原生支持 ✅——提供正式
.claude-plugin清单，/plugin marketplace add+/plugin install两条命令即可安装，技能以/opentikz:using-opentikz触发。 - Codex / Cursor / Gemini CLI：需适配 ⚠️——README 明确说明可
git clone仓库后让 agent 读取skills/using-opentikz/SKILL.md使用，非一键安装。 - OpenClaw：未验证——未在文档中提及。
- Hermes Agent：未验证——未在文档中提及。
5. 推荐理由
它把“让 AI 画 TikZ 图”这件事从“猜一段可能编译失败的代码”变成“在一个真实的、带编辑契约的模板库里精准改字段”，显著提升了论文配图的可靠性和复现性，且编译验证内置在流程里，交付前就能保证图能用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 210 stars；2 名真实贡献者持续开发，但目前尚未发现第三方平台的独立讨论 |
| 可用性 | 9 | Claude Code 插件两条命令即装；README/SKILL.md 文档详尽、含真实编译示例；近期（12 天前）仍有提交；无需付费依赖；不用 AI 也可直接复制 .tex 使用 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
① 仅执行本地 latexmk/pdflatex 编译与仓库自带的 python3 tools/*.py（后者仅用于往库中贡献新模板的维护者模式），权限范围明确、可审计；② 无联网外发，全部为本地文件操作；③ 不涉及任何 API key 或凭据；④ 通读 SKILL.md 与工具脚本未见可疑指令或隐藏行为；⑤ 两名真实贡献者持续提交功能性改动，仓库另附品牌图标商标声明与下架政策，未见刷星或 SEO 操纵迹象；⑥ 许可证经读取原文确认清晰（MIT + CC0）；⑦ 最近一次提交为 12 天前，维护活跃。
综合评分：7.3（三项均值）
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 OpenTikZ 的差异 |
|---|---|---|
| OpenTikZ | 精选图标/模板库 + 编辑契约 | 图形来自可编译的真实模板库，通过参数化编辑保证结构正确，交付前实测编译 |
| 0xE1337/thesis-figure-skill（119★，MIT） | 直接从论文文本自由生成图 | 粘贴论文文字，由模型直接现写 TikZ/draw.io 图形，灵活但没有模板兜底，编译可靠性依赖模型当次生成质量 |
两者互补：需要快速拿到一张结构工整、配色统一、必定能编译的常见图（神经网络结构、系统架构）时更适合 OpenTikZ 的模板路线；需要贴合论文具体文字自由发挥、图形样式不在现有模板范围内时，自由生成类工具更灵活。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。GitHub 仓库自身的两条 issue 均为贡献者提交新图标/示例的 Pull Request，暂无外部使用者留下的评论。
9. 其他补充
仓库为 TikZ 图形建了配套网站 opentikz.org，可在网页上直接浏览、检索并复制图形的 .tex 源码，不使用 AI 也能用。图标素材涉及第三方品牌（PyTorch、Docker、Hugging Face 等）时，仓库附带商标声明与下架政策说明。
10. 安装使用方式
Claude Code（推荐）：分两条消息依次执行
/plugin marketplace add https://github.com/opentikz/opentikz
/plugin install opentikz@opentikz安装后用 /opentikz:using-opentikz 触发，或直接用自然语言描述需要的图形（如“画一个带交叉注意力的编码器-解码器结构”）。
其他 Agent（Codex / Cursor / Gemini CLI 等）：git clone https://github.com/opentikz/opentikz，告知 agent 读取 skills/using-opentikz/SKILL.md 后使用。
不用 AI：直接在 opentikz.org 或仓库的 templates/、icons/、examples/ 目录浏览，复制所需 .tex 文件到自己项目里 \input 即可，每个文件都是独立可编译的 standalone 文档。
11. 注意事项
- 当前素材库规模仍有限（61 个图标、9 个模板、3 个完整示例，均取自仓库
catalog.json实测），覆盖的图形类型以系统架构图、神经网络结构图、训练/推理流水线为主，不涉及数据图表（如 PGFPlots 类的统计图）。 - 修改图形颜色必须通过库内统一的五色调色板名称，不支持任意十六进制颜色，这是为保证风格一致性做出的设计约束，而非缺陷。
- OpenClaw、Hermes Agent 上的兼容性尚未有实际验证，如在这两个平台使用需自行测试 SKILL.md 是否能被正确读取执行。