mcpField
A
academic-figure-draft-analyzer

academic-figure-draft-analyzer

github.com/azhi-ss设计与 UI17746 次安装2 周前更新
代码仓库

关于 academic-figure-draft-analyzer

将论文草稿或完整稿件转化为图示策略和结构化的 Figure Plan v1。它根据材料完整度调整规划范围:草稿聚焦一张总览图,完整论文则规划与论点相关的图组。

主要功能

  1. 01草稿与完整论文规划模式
  2. 02围绕论点推荐图示
  3. 03定义必要节点与连接
  4. 04提供出版版面尺寸建议
  5. 05输出结构化 Figure Plan v1

适用场景

  1. 01根据早期笔记规划总览图
  2. 02将稿件论点映射到图示
  3. 03沿用参考图的风格配置

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/azhi-ss/academic-figure-skills --skill academic-figure-draft-analyzer

安装后在 Claude Code 中输入/academic-figure-draft-analyzer确认已加载。

附带文件references/missing-info-policy.mdreferences/palettes.md

详细介绍

学术草稿与论文分析器(图示规划器)

生成易于阅读的图示策略和机器可读的 Figure Plan v1。围绕论文的主张和读者的问题规划图示,而非围绕固定数量或通用流程模板。

如果论文内容不完整,请阅读 references/missing-info-policy.md。如果存在仓库交接信息或提取出的参考风格配置文件,请沿用,不要重命名字段。

双轨规划工作流

分析器根据输入采用以下两种模式之一:

  1. 草稿到图示快速通道(草稿敏捷直出):
    • 触发条件:输入为笔记、大纲或早期草稿(Markdown、文本或草稿章节),且不含完整的实验/分析结果。
    • 目标:仅关注 图 1:总体框架/方法概览。
    • 策略:不要强行制定多图规划(消融/数据行为)。不要警告缺少实验/分析章节。
  2. 定稿多图规划(完整定稿多图规划):
    • 触发条件:输入为包含实验结果的完整稿件(Markdown、LaTeX、PDF 或全文)。
    • 目标:系统规划整套图示,并核验主张和出版限制。

输入约定

  • 优先使用:论文文本或源文件、摘要、方法、实验、目标刊会/页数限制、语义架构交接信息,以及任何参考图。
  • 接受:Markdown(.md)草稿或笔记、大纲、标题加摘要、本地 PDF、论文 URL/HTML、Word/LaTeX。
  • 只有在检查了 URL 内容后,才能将其视为论文来源;不要把所有 URL 都归类为代码仓库。
  • 如果当前环境无法读取 PDF 或网页,请报告这一限制,而不是臆造论文结构。

输出约定

包括:

  1. 论文概述:问题、贡献、证据和预期投稿场所的限制。
  2. 完整性说明:实际检查过的章节和材料。
  3. 逐图建议,使用受控类型和 must、strong 或 nice 优先级(草稿模式下,恰好输出一个主要图 1)。
  4. 一句话沟通目标:读者看完图后应该理解什么。
  5. 必需节点、边、权威边界及禁止暗示的内容。
  6. 宽高比和最终出版宽度建议。
  7. Figure Plan v1 JSON。

受控图示类型:Overall Framework、Network Architecture、Module Detail、Comparison/Ablation、Data Behavior、Concept/Motivation、Protocol/Sequence、Timeline/Lifecycle。

工作流

1. 识别输入模式和结构
  • 草稿模式(.md 笔记/大纲/非结构化文本/草稿):
    • 结构化 Markdown:
      • 标题(#、##):主要语义容器区域(例如,输入上下文、核心框架、优化目标)。
      • 列表(1. 2. 3.、- )和箭头(->):顺序阶段、数据流和流程步骤。
      • 粗体术语(**Name**):规范的节点/模块标签(visible_text)。
      • 行内代码(`B x C x H x W`):张量维度或数据说明。
    • 非结构化/纯文本笔记:
      • 沿着语法中的主语—谓语—宾语顺序(例如,“输入 X 由 Y 编码,并由损失 Z 监督”)提取实体、变换和数据流。
      • 归纳为 3 个规范面板:输入/上下文 -> 核心方法/交互 -> 输出/监督。
    • 跳过正式的主张核验,直接进入图 1 的叙事拓扑规划。
  • 完整论文模式:
    • 梳理引言、方法、实验、分析和局限性。对于每项声称的贡献,记录其来源段落和可支持视觉陈述的证据。
2. 分配视觉任务

仅当视觉内容能实质性地提升理解时,才建议使用图示:

读者问题/目标常见类型典型优先级
端到端的构想以及权限/数据流是什么?整体框架必须(草稿默认)
概念动机或问题设定是什么?概念/动机高或必须
内部可执行结构是什么?网络架构必须或高
核心机制如何运作?模块细节必须或高
哪些选择会影响实验结果?对比/消融高
行为如何随数据、时间或条件变化?数据行为高或适宜
组件如何随时间或协议交互?协议/序列/时间线高

不要将会议刻板印象或固定数量作为要求。对于草稿笔记,生成一张高影响力的图 1。

3. 设计叙事拓扑

为每张图指定:

  • communication_goal 和 claim_scope;
  • hero_element:主导视觉叙事的元素,而不只是最大的方框;
  • 源材料证据或草稿结构中支持的 required_nodes 和 required_connections;
  • 空间紧张时可删减的 secondary_context;
  • forbidden_claims 和 forbidden_connections;
  • 涉及 Agent、工具或外部预言机时的 authority_boundaries;
  • text_budget:标签应简短,细节留给图注;
  • 用户提供参考图时的 reference_style_profile。

整体框架不必采用从左到右的链式结构。应根据科学叙事选择循环、分镜、不对称模块拼贴、分层权限图、带卫星模块的核心机制或流水线。

4. 设定出版版式
  • 整体框架:通常采用双栏宽度(183 mm)下的 16:9 或 3:2。
  • 网络架构/流水线:采用 16:9、3:2,或在拓扑需要时使用纵向版式。
  • 模块细节/概念:通常采用 4:3 或 1:1。
  • 对比/消融:根据面板数量和阅读顺序设定。
  • 数据行为/时间线:根据坐标轴和序列确定版式。
5. 输出 Figure Plan v1
{
  "schema": "academic-figure/FigurePlan@1",
  "source_revision": "<paper-or-repo-revision>",
  "venue": null,
  "sources": [],
  "figures": [
    {
      "figure_id": "fig1",
      "figure_type": "Overall Framework",
      "priority": "must",
      "communication_goal": "<one sentence>",
      "claim_scope": ["<evidence-backed claim or draft objective>"],
      "hero_element": "<loop|mechanism|modular collage|pipeline|other>",
      "required_nodes": ["<component-id>"],
      "required_connections": ["<from-id> -> <to-id>: <kind>"],
      "authority_boundaries": [],
      "secondary_context": [],
      "forbidden_claims": [],
      "forbidden_connections": [],
      "aspect_ratio": "16:9",
      "final_width_mm": 183,
      "style_profile_hint": null,
      "reference_assets": [],
      "open_questions": [],
      "confidence": "high|partial|sparse",
      "review_status": "pending|confirmed|waived"
    }
  ]
}

此示例仅定义字段。将每个占位符替换为源材料中提取的内容,或明确的 null/空值。

稀疏输入与草稿处理

  • 仅有单个 .md 草稿或笔记:直接从标题和项目符号中提取流程;立即规划图 1。
  • 仅有标题和摘要:规划高层次的视觉任务;不要编造子模块。
  • 有方法但无实验:规划方法框架;不要阻止流程或报告不必要的错误。
  • 仅提供仓库移交材料:生成以系统为中心的规划,并标记需要叙事审查。
  • 仅有参考图:分析视觉表达方式,但在规划拓扑前,先请求或查找目标系统内容。

停止

交付策略和 Figure Plan v1 后即停止。除非用户要求后续工作流,否则不要生成提示词或图像。

评论

支持 Markdown