Skip to content
Back to search

Intelligrapher

科研绘图智能助手/Intelligent Assistant for Scientific Research Illustration — Claude Code Skill

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mrlee2r--intelligrapher/badge.svg)](/listings/mrlee2r--intelligrapher)

HTML

<a href="/listings/mrlee2r--intelligrapher"><img src="/api/listings/mrlee2r--intelligrapher/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

克隆到项目根目录就行:

cd your-project/
git clone https://github.com/MrLee2R/Intelligrapher.git .claude/

或者手动把 `.claude/skills/` 下的两个目录复制到你的项目里。重启 Claude Code 对话后生效。

\---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 394 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Intelligrapher
  2. > 搞科研的都知道,画一张能直接往论文里塞的图,比跑实验还折腾。配色丑了审稿人不乐意,坐标轴单位标错了被打回来重画,更崩溃的是每次都要从零写 matplotlib 代码——时间都花在调 `plt.rcParams` 上了。
  3. >
  4. > 这个项目就是想解决这个痛点。
  5. Intelligrapher 是一套给 Claude Code 用的科研绘图 Skill。它内置了三套东西:知识库(告诉你这个领域图该怎么画)、审美库(顶刊配色直接拿来用)、模板库(不用从零写代码)。三样东西配合,你的需求进去,可运行的 Python 脚本出来。
  6. ![example/comparison.png](https://github.com/MrLee2R/Intelligrapher/blob/main/example/comparison.png)
  7. 上图就是用 Intelligrapher 生成的实际效果——从数据到成图,一句话的事。深蓝实线是机器 A,砖红虚线是机器 B,阴影带表示方差范围,配色来自 Engineering Structures 的风格库。
  8. \---
  9. ## 这玩意到底能干啥
  10. 一句话:**你描述需求,它给你代码**。
  11. 比如你跟 Claude 说:
  12. ```
  13. /intelligrapher 画一张分组柱状图,对比三组材料的抗压强度,
  14. 风格用 Geotechnique 的配色,误差棒标上,保存为 PDF
  15. ```
  16. Claude 会:
  17. 1. 从知识库里查出"材料强度对比"该用什么单位(MPa)、坐标轴怎么标
  18. 2. 从审美库里捞出 Geotechnique 风格的色板(蓝、橙、灰那套)
  19. 3. 从模板库里取出 `bar-chart.py` 的骨架
  20. 4. 把色板和规范填进占位符,吐出一整段可直接运行的 Python 代码
  21. 全程你不用碰 matplotlib 文档。
  22. \---
  23. ## 这个项目中的三个库是怎么配合的
  24. ```
  25. 你的一句话需求
  26. │
  27. ▼
  28. ┌──────────────────────────────────────┐
  29. │ 1. 解析需求 → domain + figure\_type │
  30. │ 2. 查知识库 → 坐标轴规范、标注符号 │
  31. │ 3. 查审美库 → 色板、字体、线宽 │
  32. │ 4. 取模板 → matplotlib 代码骨架 │
  33. │ 5. 填空 → 注入参数 → 完整脚本 │
  34. └──────────────────────────────────────┘
  35. │
  36. ▼
  37. 直接运行的 .py 文件
  38. ```
  39. 三个库各司其职:
  40. * **知识库**(`references/knowledge/`):每个领域一份 markdown,告诉你这个圈子里图该怎么画。土木工程默认自带,医学也有一份示例。内容包括常用图表类型、坐标轴规范、领域特殊要求(比如滞回曲线必须闭合、生存曲线要标 n=...)。
  41. * **审美库**(`references/aesthetic/`):每份对应一个领域的主流顶刊,配色方案从论文里提取的。比如土木工程这套,主色 `#1f4e79` 深蓝、`#c55a11` 砖红,来自 Engineering Structures 的实际用色统计。
  42. * **模板库**(`assets/templates/`):5 份 `.py` 文件,顶部带 `CONFIG` 字典和 `{{...}}` 占位符。Claude 生成代码时会把占位符替换成具体值。模板本身就能直接跑,自带示例数据。
  43. \---
  44. ## 安装
  45. 克隆到项目根目录就行:
  46. ```bash
  47. cd your-project/
  48. git clone https://github.com/MrLee2R/Intelligrapher.git .claude/
  49. ```
  50. 或者手动把 `.claude/skills/` 下的两个目录复制到你的项目里。重启 Claude Code 对话后生效。
  51. \---
  52. ## 使用方式
  53. 装上之后,直接跟 Claude 说话就行,不用记命令。
  54. |你想干什么|怎么说|
  55. |-|-|
  56. |画图|`/intelligrapher 帮我画一张...`|
  57. |换领域|`/intelligrapher-updater 切换到医学领域`|
  58. |加新领域|`/intelligrapher-updater 初始化 materials-science 材料科学`|
  59. |换配色|`/intelligrapher-updater 更新 aesthetic 为 Nature 风格`|
  60. 两个 Skill 是联动的。Claude 会根据你说的话自动判断该调用主 Skill 还是 Updater,不需要你指定。
  61. \---
  62. ## 目前内置了什么
  63. **知识库(领域规范)**
  64. |领域|覆盖内容|状态|
  65. |-|-|-|
  66. |土木工程|滞回曲线、骨架曲线、应力-应变、弯矩图、固结曲线等|默认|
  67. |医学|Kaplan-Meier、ROC、森林图、热图、瀑布图|示例|
  68. **审美库(顶刊配色)**
  69. |领域|参考期刊|主色板|
  70. |-|-|-|
  71. |土木工程|Engineering Structures, J. Struct. Eng., Geotechnique|`#1f4e79`, `#c55a11`, `#70ad47`|
  72. |医学|The Lancet, NEJM, Nature Medicine, JAMA, BMJ|`#004b87`, `#b8321a`, `#287c37`|
  73. **模板库(代码骨架)**
  74. |模板|图表|适用场景|
  75. |-|-|-|
  76. |`line-plot.py`|折线图 + 误差带|时间序列、机器对比、滞回骨架|
  77. |`bar-chart.py`|分组柱状图 + 误差棒|材料强度对比、分类数据|
  78. |`heatmap.py`|热图|相关性矩阵、基因表达|
  79. |`scatter-plot.py`|散点图 + 回归线|相关性分析、预测验证|
  80. |`box-plot.py`|箱线图|统计分布、异常值|
  81. \---
  82. ## 🎓 提示词教程:怎么跟 Intelligrapher 说话最有效
  83. 很多人用 AI 画图,提示词写得不好,出来的东西总差点意思。这里整理了一套基于 Intelligrapher 内部机制的提示词写法,照着来,一次到位。
  84. ### 1\. 基础公式
  85. 一个完整的绘图请求,最好包含这 5 个要素:
  86. ```
  87. 画一张 \[图表类型],\[数据描述],\[坐标轴/标签要求],\[风格要求],\[输出要求]
  88. ```
  89. **✅ 好的示例:**
  90. ```
  91. /intelligrapher 画一张折线图,对比两台机器在 20-120 次试验中的平均完成时间,
  92. 带误差阴影带,x轴标 Number of Trials,y轴标 Average Time (s),
  93. Engineering Structures 风格,深蓝和砖红配色,保存为 300 DPI 的 PNG
  94. ```
  95. **❌ 不太好的示例:**
  96. ```
  97. 帮我画个图
  98. ```
  99. 太模糊了,Claude 不知道你想要什么,只能猜。猜错了你得来回改,浪费 token。
  100. ### 2\. 领域指定技巧
  101. Intelligrapher 默认走土木工程的规范。如果你做别的领域,有三种方式切换:
  102. **方式 A:临时覆盖(一句话)**
  103. ```
  104. /intelligrapher 用医学领域的规范画一张 Kaplan-Meier 生存曲线...
  105. ```
  106. **方式 B:切换默认领域(持久)**
  107. ```
  108. /intelligrapher-updater 切换到医学领域
  109. ```
  110. 之后所有请求默认走医学规范,直到你再次切换。
  111. **方式 C:初始化新领域**
  112. ```
  113. /intelligrapher-updater 初始化 materials-science 材料科学
  114. ```
  115. 会在知识库和审美库下生成骨架文件,你自己填内容。
  116. ### 3\. 风格控制技巧
  117. 配色方案来自审美库,有几种调用方式:
  118. |你的说法|Intelligrapher 怎么做|
  119. |-|-|
  120. |"Engineering Structures 风格"|读取 `aesthetic/civil-engineering.md`|
  121. |"Lancet 风格"|读取 `aesthetic/medicine.md`|
  122. |"Nature 风格"|如果存在 `aesthetic/nature.md` 就读,否则临时构造|
  123. |"用蓝色和橙色"|临时构造色板,不读审美库|
  124. |"配色要色盲友好"|读取 `guidelines/color-theory.md`,避开红绿组合|
  125. **技巧:** 如果你常投某个期刊,建议直接初始化该期刊的审美库文件,以后直接说期刊名就行。
  126. ### 4\. 数据相关技巧
  127. **有数据文件的情况:**
  128. ```
  129. /intelligrapher 数据在 D:\\\\data\\\\results.xlsx,第一列是时间,第二列是温度,
  130. 画一张折线图...
  131. ```
  132. Claude 会读取实际数据,确保代码里的数据路径正确。
  133. **没数据文件、需要示例数据的情况:**
  134. ```
  135. /intelligrapher 画一张箱线图,假设有 4 组数据,每组 200 个样本...
  136. ```
  137. 模板自带随机数据,你可以直接跑起来看效果,再替换成自己的。
  138. **数据格式检查:**
  139. Intelligrapher 内置了 `validate\_data.py`,会根据你选的图表类型检查数据列是否齐全。比如选 `bar-chart` 需要 `category` 和 `value` 列,如果缺少会提示你。
  140. ### 5\. 输出格式控制
  141. ```
  142. 保存为 SVG ← 矢量图,适合论文插图
  143. 保存为 PDF ← 矢量图,适合 LaTeX
  144. 保存为 PNG,300 DPI ← 位图,适合 PPT
  145. 保存为 TIFF,600 DPI ← 高位图,适合印刷
  146. 同时输出 SVG + PNG ← 两种格式各一份
  147. ```
  148. ### 6\. 进阶:直接修改模板
  149. 如果你发现某个图表类型 Intelligrapher 没有覆盖,可以:
  150. 1. 找一个最接近的模板复制一份
  151. 2. 改名叫 `your-figure.py`
  152. 3. 顶部保留 `CONFIG` 字典和 `{{...}}` 占位符
  153. 4. 更新 `templates/README.md`
  154. 下次就能直接调用:
  155. ```
  156. /intelligrapher 用 your-figure 模板画一张...
  157. ```
  158. ### 7\. 常见踩坑
  159. |坑|原因|解决|
  160. |-|-|-|
  161. |中文乱码|字体不支持中文|在提示词里加"用 SimHei 字体"或直接说"中文标签"|
  162. |颜色太艳|用了默认 matplotlib 色板|明确说"顶刊配色"或指定审美库|
  163. |图太大/太小|figsize 不合适|说"单栏图宽"或"双栏图宽",Intelligrapher 会自动换算|
  164. |坐标轴单位不对|知识库没加载|明确指定领域,如"土木工程的规范"|
  165. \---
  166. ## 目录结构速览
  167. ```
  168. .claude/skills/
  169. ├── intelligrapher/
  170. │ ├── skill.md # 核心入口
  171. │ ├── .current-domain # 当前领域标记
  172. │ ├── assets/
  173. │ │ └── templates/ # 5 份 .py 模板
  174. │ │ ├── line-plot.py
  175. │ │ ├── bar-chart.py
  176. │ │ ├── heatmap.py
  177. │ │ ├── scatter-plot.py
  178. │ │ └── box-plot.py
  179. │ ├── references/
  180. │ │ ├── knowledge/ # 领域图表规范
  181. │ │ │ ├── civil-engineering.md
  182. │ │ │ └── medicine.md
  183. │ │ ├── aesthetic/ # 顶刊配色方案
  184. │ │ │ ├── civil-engineering.md
  185. │ │ │ └── medicine.md
  186. │ │ └── guidelines/ # 通用绘图指南
  187. │ │ ├── color-theory.md # 色盲友好、WCAG 对比度
  188. │ │ ├── journal-styles.md # Elsevier/Springer/Nature 排版
  189. │ │ └── figure-types.md # 图表类型决策树
  190. │ └── scripts/
  191. │ ├── apply\_aesthetic.py # 配色注入
  192. │ └── validate\_data.py # 数据格式检查
  193. │
  194. └── intelligrapher-updater/
  195. ├── skill.md # 更新器入口
  196. ├── assets/
  197. │ └── knowledge-skeleton.md # 新领域骨架
  198. ├── references/
  199. │ ├── update-protocol.md # 安全更新流程
  200. │ ├── domain-registry.md # 领域注册表
  201. │ └── schema-spec.md # 格式校验标准
  202. └── scripts/
  203. ├── init\_domain.py # 初始化新领域
  204. ├── switch\_domain.py # 切换默认领域
  205. └── validate\_structure.py # 结构校验
  206. ```
  207. \---
  208. ## 扩展:加一个新领域
  209. 假设你是计算机视觉方向的,想要一套 CVPR/ICCV 风格的配色和图表规范。
  210. **Step 1 — 初始化骨架:**
  211. ```
  212. /intelligrapher-updater 初始化 computer-vision 计算机视觉
  213. ```
  214. 这会生成两个空文件:`knowledge/computer-vision.md` 和 `aesthetic/computer-vision.md`。
  215. **Step 2 — 填知识库:**
  216. 打开 `knowledge/computer-vision.md`,按这四个板块填:
  217. * **常用图表类型**:PR 曲线、mAP 对比表、混淆矩阵、注意力热力图...
  218. * **坐标轴规范**:横轴一般是 epoch / iteration / 阈值,纵轴是 accuracy / mAP / IoU
  219. * **标注符号表**:IoU、mAP@0.5、AP50、F1-score 这些符号怎么写
  220. * **领域特殊要求**:比如 PR 曲线必须标 baseline、对比实验必须标星号显著性
  221. **Step 3 — 填审美库:**
  222. 打开 `aesthetic/computer-vision.md`:
  223. * **目标期刊**:CVPR、ICCV、ECCV、TPAMI
  224. * **主色板**:去 CVPR 近几年的论文里吸色,或者用这套默认的:`#1f4e79`, `#c55a11`, `#70ad47`
  225. * **辅助色板**:灰阶,用于背景和网格
  226. * **字体字号**: conferences 通常要求 sans-serif,如 Helvetica 或 Arial
  227. * **线型标记**:线宽 1.5,标记循环 `o`, `s`, `D`
  228. **Step 4 — 校验:**
  229. ```bash
  230. python .claude/skills/intelligrapher-updater/scripts/validate\_structure.py \\
  231. .claude/skills/intelligrapher/references/knowledge/computer-vision.md knowledge
  232. ```
  233. 通过了就能用了。
  234. \---
  235. ## 一些你可能想知道的
  236. **Q:修改 skill 文件后要重启 Claude Code 吗?**
  237. 项目级 Skill 是即时生效的。改完 `.claude/skills/` 下的文件,**重启当前对话**就行,不需要重新打包上传。这是比 ZIP 包方式最爽的地方。
  238. **Q:Claude 没自动触发 Intelligrapher 怎么办?**
  239. 可能是 `skill.md` 里的 `description` 写得不够像用户请求。你可以去 `intelligrapher/skill.md` 里加一些触发词,比如 "matplotlib 科研图"、"seaborn 可视化"、"顶刊配色"、"论文插图"。
  240. **Q:模板里的占位符都有哪些?**
  241. 全部列在这里:
  242. |占位符|类型|说明|
  243. |-|-|-|
  244. |`{{COLOR\_PALETTE}}`|JSON 数组|主色板,如 `\["#1f4e79", "#c55a11"]`|
  245. |`{{FONT\_FAMILY}}`|字符串|字体族|
  246. |`{{TITLE\_FONTSIZE}}`|整数|标题字号|
  247. |`{{LABEL\_FONTSIZE}}`|整数|轴标签字号|
  248. |`{{TICK\_FONTSIZE}}`|整数|刻度字号|
  249. |`{{LINE\_WIDTH}}`|浮点数|线宽|
  250. |`{{MARKER\_SIZE}}`|浮点数|标记大小|
  251. |`{{BAR\_WIDTH}}`|浮点数|柱宽|
  252. |`{{ALPHA}}`|浮点数|透明度|
  253. |`{{XLABEL}}`, `{{YLABEL}}`|字符串|坐标轴标签|
  254. |`{{TITLE}}`|字符串|图标题|
  255. |`{{LEGEND\_LOC}}`|字符串|图例位置|
  256. |`{{SAVE\_PATH}}`|字符串|保存路径|
  257. |`{{GRID}}`|布尔值|是否显示网格|
  258. |`{{ANNOT}}`|布尔值|热图是否标注数值|
  259. |`{{CMAP}}`|字符串|热图 colormap|
  260. |`{{FMT}}`|字符串|热图数值格式|
  261. **Q:怎么调试用?**
  262. 生成的代码里加一行 `print(CONFIG)`,就能看到所有占位符的最终值。
  263. \---
  264. ## 贡献
  265. 欢迎 PR 和 Issue。如果你搞了一个新领域的知识库或者一套新配色,直接提 PR 就行。有几个方向特别缺人:
  266. * **更多领域**:物理、化学、生物、经济学... 只要是发论文需要画图的领域都欢迎
  267. * **更多模板**:森林图、小提琴图、桑基图、三维图...
  268. * **更多顶刊配色**:Nature Methods、Science、Cell 等
  269. 提 PR 的时候记得更新 `domain-registry.md`。
  270. \---
  271. ## License
  272. MIT。随便用,改也行,商用也行,但出问题别找我(虽然大概率不会出问题)。
  273. \---
  274. <p align="center">
  275. <i>画好看的图,让审稿人少挑点毛病。</i>
  276. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.