Skip to content
Back to search

academic-figure-skills

两个 skill 画论文图:先看 6 种风格预览再出图,接受成图后可以把字换成可编辑 PPT。npx skills add Azhi-ss/academic-figure-skills

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/azhi-ss--academic-figure-skills/badge.svg)](/listings/azhi-ss--academic-figure-skills)

HTML

<a href="/listings/azhi-ss--academic-figure-skills"><img src="/api/listings/azhi-ss--academic-figure-skills/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.

方式 1:npx skills(推荐)

仓库已公开,`npx skills` 从 GitHub 拉取;**push 到 `main` 即更新分发**,无需 npm publish。

# 全局安装全部 skill(推荐)
npx skills add Azhi-ss/academic-figure-skills -g --all

# 仅列出仓库内 skill(不安装)
npx skills add Azhi-ss/academic-figure-skills -l

# 只装其中一个
npx skills add Azhi-ss/academic-figure-skills -g -s academic-figure-workflow -y

# 更新到 main 最新
npx skills update Azhi-ss/academic-figure-skills -g -y

# 查看已安装
npx skills list -g

也可用完整 URL:

npx skills add https://github.com/Azhi-ss/academic-figure-skills -g --all

发现页(skills.sh):搜索 `academic-figure-skills` 或 owner `azhi-ss`。

方式 2:手动(开发调试)

git clone https://github.com/Azhi-ss/academic-figure-skills.git
# 将各个 skill 目录链到 agent skills 路径,例如:
# ln -s "$PWD/academic-figure-workflow" ~/.claude/skills/academic-figure-workflow

更推荐始终用 `npx skills add`,避免把整个 monorepo 误拷进 skills 目录。

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 · 360 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Academic Figure Skills
  2. ![Version](https://img.shields.io/badge/version-4.3.0-blue)
  3. ![License](https://img.shields.io/badge/License-MIT-green)
  4. ![Stars](https://img.shields.io/github/stars/Azhi-ss/academic-figure-skills?style=social)
  5. **Academic paper figure skills for Claude Code, Cursor, Codex & Gemini CLI.**
  6. AI 驱动的学术论文配图技能包:看材料 → 第一次出图前选定风格 → 设计并生图 → 对照原图检查。图交出去之后,会问你要不要把这张示意图做成可编辑 PPT。你同意之后,`fig-pptx` 才做:干净背景、透明框架、透明图标,文字是真文本框。
  7. > **是什么?** 3 个可独立安装的 agent skill。`fig-analyze` 看仓库、论文、草稿和参考图。`fig-draw` 定风格、写规格、生图、检查。交付后会问要不要做成可编辑 PPT,你同意之后 `fig-pptx` 才做。第一次出图若还没点名风格、也没有要跟随的参考图,会先展示 6 张预览并停下。「直接画」只跳过提示词展示,不代替选风格。三个画面是 `classic-technical`、`pastel-airy-ui`、`illustrated-modular`;`reference-led` 是照着你给的参考图走,不会自动变成手绘风。互不相关的来源或互不相关的图可以分开做;一张图从设计画到检查仍由同一次流程做完。
  8. **3 skills · 3 core style profiles · native Codex rendering · reference-aware revision** · Install: `npx skills add Azhi-ss/academic-figure-skills -g --all`
  9. ## 快速开始(30 秒)
  10. ```bash
  11. # 全局安装全部技能(推荐)
  12. npx skills add Azhi-ss/academic-figure-skills -g --all
  13. ```
  14. 然后对 agent 说:
  15. 1. `"分析这个仓库再出图。还没定风格就先给我看预览,选定后再画,不用展示 prompt"`
  16. 2. `"参考这篇论文 Figure 2 的画法重画我的框架;保留风格,不复制内容"`
  17. 先看有哪些 skill(不安装):
  18. ```bash
  19. npx skills add Azhi-ss/academic-figure-skills -l
  20. ```
  21. ## 构造、诊断与修订画图提示词
  22. 直接调用 `fig-draw`,不另建第二套 prompt 编译器:
  23. | 你可以这样说 | 交付 |
  24. |---|---|
  25. | “根据这些机制构造英文画图 prompt,先不要生图” | 设计简报、完整 prompt、待核实项 |
  26. | “诊断这个 prompt 为什么容易画乱,不改文件” | 问题位置、影响和最小修正建议 |
  27. | “颜色丰富一些,但节点、文字、连线不动,修改 prompt” | 改动与保留清单、完整新 prompt |
  28. | “按照这个 prompt 直接画图,不用返回提示词” | 校验后的内部 prompt、图片和逐版本审核 |
  29. 设计顺序是:读者要看懂什么 → 有证据的结构 → 选定风格或参考图 → 再定布局、锚点和文字 → 把每条边写死 → 出图 → 对照原图检查。风格在布局定稿前就定下,不是写完提示词后补一句形容词。已经选过的风格直接沿用,改图时不再弹菜单。箭头画错时只改端点,不把已定的主区和机制行收成一排等大图标。手绘角色、公式卡和微型图都可以用,但不是每个格子都必须有。多 agent 讨论必须来自材料里的真实交互。
  30. 具体见 [提示词设计逻辑](fig-draw/references/prompt-design-logic.md)、[可填充模板](fig-draw/references/prompt-templates.md) 和 [案例与迁移测试](fig-draw/references/prompt-design-cases.md)。本次提炼参考 Nuwa 的主题框架方法;成品技能没有 Nuwa 运行时依赖。
  31. ### 审核记录与图片正确性分开
  32. 新 RenderAudit v2 将记录绑定到实际 image/spec SHA-256,并逐节点、逐边记录 `pass / fail / unverified`。局部修箭头或只调颜色后也重新检查全图;不把旧图的 PASS 移植到新图。
  33. ```bash
  34. python3 fig-draw/scripts/validate_render_audit.py \
  35. --spec figure.spec.json --image figure.png figure.audit.json
  36. ```
  37. 返回码:0 是记录完整且全部断言通过;1 是记录有效但未通过验收;2 是记录缺项、版本绑定不符或状态矛盾。它不能看图,不能证明审核者的断言真实;FigureSpec 校验与记录校验都不能代替实际图片目检。旧 v1 审核只保留为历史,新图重新生成 v2 审核。
  38. ## 顶会级配图风格全景展示 (Style Showcase Gallery)
  39. 本技能包内置多种面向学术论文的标准化配图风格。所有提示词均归一化为**结构化紧凑段落(Compact Prose)**,严禁 Markdown 字符泄漏。默认不在画布顶部重复论文 caption;当用户或参考图明确要求时,可保留一个短小、非横幅式的总标题:
  40. <table>
  41. <tr>
  42. <td align="center" width="50%">
  43. <img src="docs/gallery/modern_technical_vector_deepseek_mla.jpg" alt="现代前沿技术框线风" />
  44. <br/><b>现代前沿技术框线风 (Modern Technical Vector)</b>
  45. <br/><sub><b>对标论文:</b><a href="https://arxiv.org/abs/2412.19437">DeepSeek-V3 (arXiv:2412.19437)</a> Fig 2 MLA & MoE</sub>
  46. <br/><sub><b>核心特征:</b>彩色张量维度条 ($h_t, c_t^{KV}$)、Attention 多层热力图矩阵、Top-K 门控概率柱状图、微米级正交走线</sub>
  47. <br/><sub><a href="docs/prompts/modern_technical_vector_deepseek_mla.spec.json">📄 查看实测 FigureSpec 与提示词</a></sub>
  48. </td>
  49. <td align="center" width="50%">
  50. <img src="docs/gallery/illustrated_modular_agentic_matribo.jpg" alt="Agentic-MatriBO 手绘架构图:Agentic Reasoning、Deterministic BO Harness 与 Memory, Provenance & Recovery 三分区闭环" title="Agentic-MatriBO:智能体推理、确定性贝叶斯优化执行与可恢复记忆闭环" />
  51. <br/><b>编辑手绘模块风 (Illustrated Modular)</b>
  52. <br/><sub><b>风格参考:</b><a href="https://arxiv.org/abs/2606.06473">MLEvolve (arXiv:2606.06473)</a> Fig 1–2(仅参考手绘科学信息图语法;架构内容为 Agentic-MatriBO)</sub>
  53. <br/><sub><b>核心特征:</b>奶油白底与深墨蓝手绘描边,蓝/桃/绿三大语义区;左侧 Agentic Reasoning 主区与右侧执行/记忆堆叠区通过实线执行流、紫色虚线建议/反馈和珊瑚 STOP 例外组成可恢复闭环</sub>
  54. <br/><sub><a href="docs/prompts/illustrated_modular_agentic_matribo.spec.json">📄 查看实测 FigureSpec 与提示词</a></sub>
  55. </td>
  56. </tr>
  57. <tr>
  58. <td align="center" width="50%">
  59. <img src="docs/gallery/pastel_airy_ui_agentic_bo.jpg" alt="现代柔彩空气风" />
  60. <br/><b>现代柔彩空气风 (Pastel Airy UI / Modern Pastel Airy)</b>
  61. <br/><sub><b>对标论文:</b><a href="https://arxiv.org/abs/2608.00316">Brunzema et al. (arXiv:2608.00316)</a> Fig 1 / <a href="https://arxiv.org/abs/2405.15793">SWE-agent (ICML 2024)</a> Fig 2</sub>
  62. <br/><sub><b>核心特征:</b>纯白高留白画布、柔杏数学代理卡片、柔雾冰蓝 Agent 中枢、深灰高对比评估锚点、虚线作用域容器与叠层演进上下文</sub>
  63. <br/><sub><a href="docs/prompts/pastel_airy_ui_agentic_bo.spec.json">📄 查看实测 FigureSpec 与提示词</a></sub>
  64. </td>
  65. <td align="center" width="50%">
  66. <img src="docs/gallery/contrast_ablation_kan.jpg" alt="对比消融实验风" />
  67. <br/><b>对比消融实验风 (Purple-Green Contrast & Ablation)</b>
  68. <br/><sub><b>对标论文:</b><a href="https://arxiv.org/abs/2404.19756">KAN (arXiv:2404.19756)</a> Fig 1 / <a href="https://arxiv.org/abs/2405.14734">SimPO (arXiv:2405.14734)</a> Fig 1</sub>
  69. <br/><sub><b>核心特征:</b>左右高对比分栏、Baseline 固定权重 vs Ours 边上可学习 B-样条非线性曲线 $\phi(x)$ 与节点纯求和 $\sum$</sub>
  70. <br/><sub><a href="docs/prompts/contrast_ablation_kan.spec.json">📄 查看实测 FigureSpec 与提示词</a></sub>
  71. </td>
  72. </tr>
  73. <tr>
  74. <td align="center" width="50%">
  75. <img src="docs/gallery/paired_semantic_zones_dash.jpg" alt="有色语义分区图示风" />
  76. <br/><b>有色语义分区图示风 (Paired Semantic Zones)</b>
  77. <br/><sub><b>对标论文:</b><a href="https://arxiv.org/abs/2608.00641">DASH (arXiv:2608.00641)</a> Fig 1 / Agentic-MatriBO Fig 1</sub>
  78. <br/><sub><b>核心特征:</b>蜜桃/薄荷/薰衣草 Paired Tokens、2px 同色暗边框、清晰色区语义绑定与闭环数据流</sub>
  79. <br/><sub><a href="docs/prompts/paired_semantic_zones_dash.spec.json">📄 查看实测 FigureSpec 与提示词</a></sub>
  80. </td>
  81. <td align="center" width="50%">
  82. <img src="docs/gallery/dual_fidelity_loop_labo.jpg" alt="双保真度引导闭环风" />
  83. <br/><b>双保真度引导闭环风 (Dual-Fidelity Loop & Bayesian Optimization)</b>
  84. <br/><sub><b>对标论文:</b><a href="https://arxiv.org/abs/2605.22054">LABO (arXiv:2605.22054)</a> Fig 1 Prior-Guided Initialization & Optimization Loop</sub>
  85. <br/><sub><b>核心特征:</b>上下双宏观容器、双保真度色彩配对(珊瑚红真机实验/残差 vs 板岩蓝大模型代理)、门禁判定菱形 $p_\Delta(x^*) < \tau?$、3D 高斯过程响应曲面与极值搜索闭环</sub>
  86. <br/><sub><a href="docs/prompts/dual_fidelity_loop_labo.spec.json">📄 查看实测 FigureSpec 与提示词</a></sub>
  87. </td>
  88. </tr>
  89. </table>
  90. 旧版真实仓库基准覆盖 [stable-diffusion / nanoGPT / ESM / AlphaFold / GraphCast / transformers / CycleGAN / NeRF / DETR / Whisper + sparse fixture](examples/benchmarks/README.md)。它是结构与关键词 smoke test,只检查分析文档的基本形状;**不代表语义正确率,也不是图像质量、风格还原或 RenderAudit 的证据**。
  91. ## 技能列表
  92. | 技能 | 功能 | 触发词示例 |
  93. |-----|------|-----------|
  94. | **fig-draw** | 风格、配色与 prompt 构造/诊断/修订,FigureSpec、原生生图、审图与定向修图;仓库、论文、草稿或参考图先交给 fig-analyze | 设计论文配图、构造画图提示词、完整论文配图工作流、使用 Codex 生图 |
  95. | **fig-analyze** | 分析仓库、论文草稿与参考图,产出 SemanticArchitecture@1、FigurePlan@1、ReferenceAnalysis@1;不写 prompt、不生图 | 分析代码仓库、分析草稿配图、提取论文架构图 |
  96. | **fig-pptx** | 接受示意图后,按背景、框架、图标、文本框四层做成可编辑 PPT;不改源 PNG | 把 AI 图做成可编辑 PPTX、fig-pptx |
  97. `fig-pptx` 单独安装就能跑,参考和脚本都在技能目录里。流程、提示词和 `layout.json` 在 [fig-pptx/references/layers.md](fig-pptx/references/layers.md)。脚本按这个顺序用:`probe_palette.py` 定抠图底色,`pick_font.py` 按字的样子选字体,`chroma_key.py` 去底,`slice_grid.py` 切图标,`layout_guard.py` 校验坐标,`compose_pptx.py` 合成 pptx。依赖是 `python-pptx`、`pillow`、`numpy`。
  98. ## 完整工作流
  99. 你把仓库、论文、链接、参考图,或已经说清的结构交给它。材料需要核对时先分析;结构已经由你说清时直接设计。
  100. 第一次出图有一道固定停点:还没点名风格、也没有「就照这张图」的参考时,先看 6 张预览,等你选完再画。你说「直接画」只表示不用看提示词。科学内容还有会改变图意的缺口,或者你要求先看方案时,也会停下来问。
  101. ```
  102. 材料或你口述的结构
  103. ↓
  104. 需要时先分析
  105. ↓
  106. 第一次出图:看 6 张风格预览,等你选定
  107. (已点名风格,或给出要跟随的参考图,则跳过)
  108. ↓
  109. 写成规格并校验 → 生图
  110. ↓
  111. 对照原图检查 → 最多改两轮
  112. (不把图收成等大图标条)
  113. ↓
  114. 把图交给你,并询问要不要做成可编辑 PPT
  115. ↓
  116. 你同意之后,fig-pptx 才做成可编辑 PPT
  117. (要改图就先改,改完再问)
  118. ```
  119. 参考图可以交给生图工具。匹配的是构图、笔触、分区、字体和强调方式,不复制原图的文字、拓扑和结论。几张互不相关的图可以分开做;一张图的设计、出图和检查不拆开。
  120. ### Codex 直接生成与返修
  121. 在 Codex 中,workflow 优先直接调用当前会话暴露的
  122. `image_gen.imagegen`(部分运行时显示为 `image_gen__imagegen`)。`prompt` 只是
  123. 内部工具参数;用户说“直接画 / 不要返回 prompt”时,不会把它返给用户复制。
  124. 返修对着当前这张图改已看见的问题,不换一套更简单的版式:
  125. 1. 以 original detail 查看当前最佳版本并生成绑定 image/spec 哈希的 RenderAudit v2;
  126. 2. 将该图作为 `referenced_image_paths` 的第一张图;
  127. 3. 只描述已观察缺陷、精确修复与必须保持的正确区域;
  128. 4. 保存 `r0/r1/r2` 版本,每次编辑后重新查看与审计;
  129. 5. 首图后最多两轮语义返修,瞬态传输重试不占额度。
  130. 若密集文字一次定向修复后仍不可靠,改用 SVG、drawio、Typst 或混合文字,不让图像模型无限重画。图交出去之后询问要不要做成可编辑 PPT,你同意后再交给 [fig-pptx](fig-pptx/SKILL.md)。图片层会按源图重画,文字写成文本框。源 PNG 不改。结果图的数据点要保持原样时不要走这一步。
  131. ## 三个 surface profile + reference-led 模式
  132. | profile | 核心视觉特征 | 适用场景 |
  133. |---|---|---|
  134. | **classic-technical** | 精确节点/边、克制线条、明确拓扑;可搭配 Okabe-Ito、蓝调或灰度 | 网络、机制、比较图、印刷约束 |
  135. | **pastel-airy-ui** | 白色或轻色 panel、柔彩 token/pill、较轻的连接与 UI 感 | token flow、界面式系统说明 |
  136. | **illustrated-modular** | 不等大语义区、深色圆润描边、区内开放线稿;子卡只用于真实的一层分组 | agent 系统、AI4Science 闭环、编辑式科学信息图 |
  137. | **reference-led** | 直接保留参考图观察到的构图、表面、笔触与强调语法;可落在前三类任一类或其相干组合 | 用户提供参考图且 preset 不能忠实概括时 |
  138. 不知道从哪开始时直接说:
  139. - `帮我从仓库到配图走一遍`
  140. - `完整论文配图工作流`
  141. - `which skill should I use first`
  142. ## 安装
  143. ### 方式 1:npx skills(推荐)
  144. 仓库已公开,`npx skills` 从 GitHub 拉取;**push 到 `main` 即更新分发**,无需 npm publish。
  145. ```bash
  146. # 全局安装全部 skill(推荐)
  147. npx skills add Azhi-ss/academic-figure-skills -g --all
  148. # 仅列出仓库内 skill(不安装)
  149. npx skills add Azhi-ss/academic-figure-skills -l
  150. # 只装其中一个
  151. npx skills add Azhi-ss/academic-figure-skills -g -s fig-draw -y
  152. # 更新到 main 最新
  153. npx skills update Azhi-ss/academic-figure-skills -g -y
  154. # 查看已安装
  155. npx skills list -g
  156. ```
  157. 也可用完整 URL:
  158. ```bash
  159. npx skills add https://github.com/Azhi-ss/academic-figure-skills -g --all
  160. ```
  161. 发现页(skills.sh):搜索 `academic-figure-skills` 或 owner `azhi-ss`。
  162. ### 方式 2:手动(开发调试)
  163. ```bash
  164. git clone https://github.com/Azhi-ss/academic-figure-skills.git
  165. # 将各个 skill 目录链到 agent skills 路径,例如:
  166. # ln -s "$PWD/fig-draw" ~/.claude/skills/fig-draw
  167. ```
  168. 更推荐始终用 `npx skills add`,避免把整个 monorepo 误拷进 skills 目录。
  169. ## 从 3.x 升级
  170. 旧的 `academic-figure-designer`、`academic-repo-analyzer`、`academic-figure-draft-analyzer`、`academic-figure-architecture-extractor` 已并入现在的 `fig-draw` 与 `fig-analyze`。先卸掉旧 skill,再安装当前包:
  171. ```bash
  172. npx skills remove --global academic-figure-designer academic-repo-analyzer academic-figure-draft-analyzer academic-figure-architecture-extractor
  173. npx skills add Azhi-ss/academic-figure-skills -g --all
  174. ```
  175. ## 使用示例
  176. ```
  177. # 场景 1: 从代码仓库出图
  178. You: 分析这个仓库并直接生图,不要展示 prompt
  179. AI: [先看仓库 → 若你还没选风格,展示 6 张预览并停下
  180. → 你选定后写规格、校验、生图、对照原图检查
  181. → 把图交给你,并询问要不要做成可编辑 PPT]
  182. ```
  183. ```
  184. # 场景 2: 用论文图作风格参考
  185. You: 参考这个 arXiv 页面 Figure 2 的画法,重画我的框架,不复制内容
  186. AI: [解析论文 URL 与原图 → ReferenceAnalysis v1 → style grammar
  187. → reference-conditioned generation]
  188. ```
  189. ```
  190. # 场景 3: 基于首图做定向修订
  191. You: 保持布局,只修复乱码、透明背景和多余节点
  192. AI: [view_image(original) → RenderAudit v2 → 当前最佳图作第一引用
  193. → targeted image edit → 再审计;最多两轮]
  194. ```
  195. ## 风格 profile 与配色变量
  196. 单一事实源:[`fig-draw/references/styles/`](fig-draw/references/styles/) 与 [`fig-draw/references/palettes.md`](fig-draw/references/palettes.md)。[`docs/styles.md`](docs/styles.md) 仍是风格总览。
  197. 内置样式文件可以提供更细的变体;workflow 先选择三个 surface profile,必要时再启用 `reference-led` 覆盖模式:
  198. | profile | 何时用 | 核心表现 | 对标代表论文 |
  199. |--------|--------|---------|---|
  200. | **classic-technical**<br>*(现代前沿技术框线风 / Modern Technical Vector)* | 深度学习大模型架构、算法张量流、精确技术拓扑与顶会工程架构 | 彩色张量条、多层注意力热力图、门控概率柱状图、正交微米走线 | **DeepSeek-V3** (2024) Fig 2<br>**DiT** (ICCV 2023) Fig 2<br>**Mamba** (ICML 2024) Fig 1 |
  201. | **illustrated-modular** | 科学工作流、AI4Science、多智能体闭环、需要图示化叙事 | 不等大色区、区内开放线稿和短机制行、手绘标题;子卡只框真实的一层分组 | **MLEvolve** (2026) Fig 1–2(风格参考)<br>**Agentic-MatriBO** Fig 1 |
  202. | **pastel-airy-ui** | LLM Token 流、Agent 交互界面、概念决策循环 | 纯白浮动卡片、CLI 终端仿真视窗、悬浮柔彩 Token/Pill、高留白比率 | **SWE-agent** (ICML 2024) Fig 2<br>**ReAct** (ICLR 2023) Fig 1<br>**Reflexion** (NeurIPS 2023) Fig 1 |
  203. | **reference-led** | 用户给出参考图且其语法不应被 preset 覆盖 | 如实继承观察到的 surface/composition,不自动转成手绘柔彩 | 用户提供的任意顶刊/顶会论文原图 |
  204. 内容关系、用户偏好、参考图、可访问性与黑白印刷配方见 [`fig-draw/references/palettes.md`](fig-draw/references/palettes.md) 的 **Scene → palette decision** 与 **Worked decision recipes**。venue/domain 名称本身不选择颜色。
  205. | 经典配色方案 | 适用场景 |
  206. |-----|---------|
  207. | Okabe-Ito | 默认分类色起点;需结合形状/线型并按实际背景验证 |
  208. | Nature Blue | 需要单色层级、打印稳定或用户明确偏好时 |
  209. | Blue Monochrome | 模块详解、灰度友好 |
  210. | Warm Earth | 用户/参考明确要求的暖土色语法 |
  211. | Purple-Green | 两类对比或消融;不得默认某色代表 ours |
  212. | Grayscale | 纯灰度 |
  213. | Teal-Coral | 用户/参考明确要求的两类冷暖对比 |
  214. | ML TopConf Tab10 | 对齐 Matplotlib 实验色 |
  215. | ML TopConf Colorblind | colorblind-aware 起点,仍需双重编码与实图校验 |
  216. | ML TopConf Deep | 多面板消融 |
  217. | Print-Safe Gray | 严格黑白印刷 |
  218. | Journal Standard | 经验证确需较多类别色的图;不由期刊名触发 |
  219. 决策顺序:`用户要求 → 参考图 style grammar → 生产约束 → 语义角色 → 安全默认`。模块数量本身不触发某个色板。
  220. ## 文档与资源
  221. | 文档 | 说明 |
  222. |-----|------|
  223. | **[fig-draw/references/palettes.md](fig-draw/references/palettes.md)** | 12 套经典 preset、I1 paired semantic tokens 与四种路由模式 |
  224. | **[docs/styles.md](docs/styles.md)** | 风格总览;定义文件在 `fig-draw/references/styles/` |
  225. | **[fig-draw/references/codex-image-workflow.md](fig-draw/references/codex-image-workflow.md)** | Codex 原生生成、参考图编辑与安全调用 |
  226. | **[fig-draw/references/render-audit.md](fig-draw/references/render-audit.md)** | RenderAudit v2:图片/spec 绑定、逐边检查与定向修订 |
  227. | **[fig-analyze/references/missing-info-policy.md](fig-analyze/references/missing-info-policy.md)** | 缺信息时的统一策略 |
  228. | **[CHANGELOG.md](CHANGELOG.md)** | 版本历史 |
  229. | **[CONTRIBUTING.md](CONTRIBUTING.md)** | 贡献指南 |
  230. | **[docs/academic-references.md](docs/academic-references.md)** | 学术引用 |
  231. | **[fig-pptx/SKILL.md](fig-pptx/SKILL.md)** | 可编辑 PPT 的入口 |
  232. | **[fig-pptx/references/layers.md](fig-pptx/references/layers.md)** | 四层顺序、出图提示词、字体和 layout 字段 |
  233. | **[fig-pptx/scripts/](fig-pptx/scripts/)** | 探色、选字体、抠图、切片、坐标校验、合成 |
  234. | **[docs/best-practices.md](docs/best-practices.md)** | 参考驱动、可读性与生成后审计实践 |
  235. | **[examples/](examples/)** | 端到端 handoff 示例 |
  236. ## 常见问题 FAQ
  237. ### Q: 生成的是英文还是中文?
  238. A: 给图片模型的 JSON / prompt 用英文;对用户的说明可用中文。
  239. ### Q: 默认 JSON 还是纯文本 prompt?
  240. A: 所有路径都先形成可校验的 FigureSpec/渲染包;`classic-technical` 的拓扑约束更强,`pastel-airy-ui` 和 `illustrated-modular` 额外描述 surface/illustration grammar。prompt 是内部渲染输入,只有用户明确索要时才展示;出图后仍必须执行 RenderAudit。
  241. ### Q: 三个风格 profile 怎么选?
  242. A: 精确拓扑用 `classic-technical`;轻量 token/card 叙事用 `pastel-airy-ui`;agent-drawn、柔彩语义分区用 `illustrated-modular`。有参考图时先分析其真实语法;只有 preset 无法忠实概括时才用 `reference-led`,且不会自动变成 illustrated modular。
  243. ### Q: 可以直接用 Codex 生图而不看 prompt 吗?
  244. A: 可以跳过 prompt 展示。明确说“直接生成 / 不展示 prompt / 使用本地模型”即可 waive prompt review。若这次请求没有点名风格、也没有给出要跟随的参考图,`fig-draw` 会先展示 6 张风格预览并停下,不调用生图。正式生成前仍会运行 render-ready 校验;缺 `style_selection` 或值为 `pending` 时不能出图。
  245. ### Q: 必须按顺序跑完整流水线吗?
  246. A: 不需要。不必跑完整流水线,可只做分析(`fig-analyze`)或只做设计、prompt 和生图(`fig-draw`)。
  247. ### Q: 4.4.0 有什么变化?
  248. A: `fig1-text` 换成 `fig-pptx`。接受示意图并要求可编辑 PPT 之后,按背景、框架、图标、文本框四层重画;文字是唯一的文本,不再用色块盖旧字。源 PNG 不改。
  249. ### Q: 4.3.0 有什么变化?
  250. A: 可编辑 PPT 文字从 `fig-draw` 拆出,单独安装 `fig1-text`。4.4.0 已改为 `fig-pptx`。
  251. ### Q: 4.2.0 有什么变化?
  252. A: 可编辑 PPT 文字当时并进 `fig-draw`。4.3.0 已把它拆回独立 skill。
  253. ### Q: 4.1.0 有什么变化?
  254. A: 第一次出图前,没指定风格时必须先看 6 张预览并等用户选择。「直接画」只跳过 prompt 展示,不代替选风格。修图、已点名风格或有参考图时不再弹菜单。
  255. ### Q: 4.0.0 有什么变化?
  256. A: 4.0.0 是结构合并、行为不变:原先 5 个 skill 并入现在的 `fig-draw` 与 `fig-analyze`。3.3.0 的校验仍然有效:FigureSpec 校验器直接读取 `figure-spec.schema.json`;`fig-draw` 自带校验器与元数据清理脚本,单独安装也能完成 render-ready 校验和交付前清理。可先构造、诊断或修订 prompt,也可直接调用 Codex `image_gen.imagegen`;生成遵守 prompt-review/hash 与可信工作区校验,每张新图执行 RenderAudit v2,最多两次定向编辑。未版本化旧 spec 与风格别名不再被接受,`--strict-v1` 保留但已不起作用。
  257. ## 引用
  258. 如果本技能包帮助了你的工作,可以这样引用:
  259. ```bibtex
  260. @software{academic-figure-skills,
  261. author = {Azhi-ss},
  262. title = {Academic Figure Skills: AI-powered academic figure generation skill pack},
  263. year = {2026},
  264. url = {https://github.com/Azhi-ss/academic-figure-skills},
  265. version = {4.3.0}
  266. }
  267. ```
  268. ## 许可证
  269. MIT License
  270. ## 致谢
  271. 本项目受到 [LINUX DO](https://linux.do/) 社区的启发和支持。

Ratings and comments

Sign in to rate this skill.

Sign in

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