Communitygithub.com

SailRain/科学绘图技能

将现有的时域数值数据绘制为纯时间序列或成对的相轨迹与波形图,或将MAT分类平面渲染为剪切切片;可对图形进行排版、导出和验证,以适配目标版面。

科学绘图技能 是什么?

该技能(SailRain/scientific-plotting-skill)专为在AI智能体工作流(如Claude Code、Cursor、Codex等)中对现有科学数据进行可视化而设计。它支持三种核心图形类型:纯时间序列(数据通道随时间变化的曲线)、成对的相轨迹与波形(相轨迹在左,波形在右),以及MAT分类平面的剪切切片(用于显示分类边界或分岔结构)。 技能会基于用户指令和项目中的AGENTS.md文件自动路由到对应的图形类型和版面放置(例如单栏全宽、双栏单列或双栏跨列)。项目默认为SailRain配色方案,但用户可覆盖。输入配置集中管理,原始数据保持只读,确保真实性。 所有可见文本强制使用Time New Roman字体,默认为8磅,支持斜体变量与直立单位。脚本基于MATLAB生成,且可完全复现。最终输出前会进行严格验证,包括精准的物理尺寸(毫米精度0.1 mm)、字体渲染和图形完整性检查,确保可靠交付。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SailRain/scientific-plotting-skill/tree/HEAD/scientific-plotting

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

科学绘图工作流

用户在当前对话中的指令和设置优先级高于本技能的默认值。阅读并遵循用户当前工作项目中适用的 AGENTS.md 指令,使用宿主环境确立的项目与目录范围。从工作项目而非已安装的技能目录中解析这些指令。若不存在适用的项目指令文件,则依照其他适用指令和本技能的默认值进行。当前支持的图形类型包括纯时间序列、成对的相轨迹与波形,以及MAT分类平面的剪切切片。在使用其他图形类型前,需先建立对应的工作流;不得套用相似图形类型的规则。

1. 图形类型与版面路由

对于每个任务,首先确定图形类型,然后确定最终版面,并按需分别读取以下文件:

  1. 图形类型
  2. 版面
  3. 用户当前请求中明确提供的物理尺寸将覆盖版面文件中对应的默认字段;未覆盖的字段保留原有预设。若所选版面没有默认尺寸,请确认缺失的尺寸。不得借用其他版面的值。

配色方案是跨上述两个维度的共享配置。选择曲线或分类颜色时,请阅读 配色方案参考。使用选定方案,或默认使用 SailRain,除非用户指定颜色或确认的任务配置覆盖。方案仅更改颜色;不更改字体排印、几何形状、颜色条位置或导出要求。

2. 通用配置与输入原则

  1. 检查用户直接指定的原始文件、元数据和适用的现有程序。不得使用截图、历史输出或名称相似的旧数据。输入字段、列、矩阵方向、变量、单位、图形数量与顺序,需基于实际来源或已确认的指令进行配置。
  2. 集中管理输入及其顺序、图形类型、版面、显示语义、范围、布局、尺寸、颜色、文本和输出位置。首先从原始数据、现有程序和当前对话中确定这些信息。仅对无法验证且会影响结果的信息进行提问。
  3. 将原始数据视为只读:不得覆盖、重新排序、重新格式化或删除。默认情况下,忠实使用原始样本或分类单元,不进行插值、降采样、平滑或数值更改。对选定图形类型文件的文件进行有效性与方向检查。
  4. 不得从文件名、数值大小、代码或示例颜色中推断变量、单位、周期、吸引子或分类。识别冲突来源之间的差异。若语义无法验证,需先确认;或者,若用户接受,则忠实使用原始代码作为标签。
  5. 保留用户指定或当前对话中确认的文件与图形顺序。不得按文件名或数值自动重新排序。

3. 通用图形与实现规则

  1. 所有可见文本,包括刻度标签、坐标轴标签、面板标签、参数文本、颜色条文本以及用户要求的标题或图例,必须使用 Times New Roman。主文本默认使用 8 pt;下标可根据布局使用更小的字号。用户明确指定时使用其他字号。渲染前检查字体可用性;报告缺失字体并解决后方可声称字体排印符合要求。不得静默替换字体。
  2. 默认使用白色画布。变量和表示变量的下标使用斜体;单位和描述性下标使用直立字形。遵循用户对特定符号、大小写和字形的要求。
  3. 使用 共享配色方案规则 和选定的图形类型文件解析颜色。保留用户指定的颜色和已确认的任务映射;否则使用选定方案或 SailRain 默认值。在任务配置中记录所用方案和实际颜色分配。不得将历史图形、方案来源标签或其他数据集中的语义含义迁移过来。
  4. 保留可重现的 MATLAB 脚本。使用 mfilename('fullpath') 和显式配置构建路径,而非依赖手动目录切换。新文件、函数和变量使用英文名称。新的或修改后的注释、提示、图形标题和标签使用美式英语,并根据任务要求保留数学符号。
  5. 使用用户指定的输出名称;否则使用描述图形内容的英文 snake_case 名称。不得覆盖同名的无关文件;需先报告冲突。不得将实际数据或生成的结果写入已安装的技能目录。

4. 验证与交付

  1. 运行 MATLAB 直至完成。检查输入源、显示映射、样本或分类单元数量以及范围,确认图形忠实代表原始数据。
  2. 根据当前图形类型、版面及用户配置验证位置与物理尺寸。明确指定的毫米尺寸精度需在 0.1 mm 以内。执行选定图形类型文件要求的所有输出、数据与视觉检查;不得替换成其他图形类型的导出格式。
  3. 检查最终验收文件的高分辨率渲染效果,包括字体、字号、颜色、线宽、标签、边界、裁剪、重叠以及多余空白。修正所有问题,然后再次导出并检查。
  4. 交付可重现程序及选定图形类型所需的最终文件。简要描述图形类型、版面、输入与显示映射、用户覆盖项及输出位置。报告 MATLAB 是否成功运行,以及完成了哪些尺寸、文件和视觉检查。清晰披露任何未完成的验证项。

相关技能