Skip to content

Nathanielguo/medtech-visuals-skill

Repository files navigation

create-medtech-visuals

一条指令生成可复制到 PowerPoint、Word 或 PDF 工作流中的医疗科技数据控件与专业图片。核心为厂商中立设计:14 个数据控件稳定输出 SVG;安装可选依赖后输出 PNG/PPTX;图片分支使用 imagegen 生成五类专业视觉。

本项目与任何医疗器械、科技公司、医院或品牌不存在隶属、授权、认证或背书关系。它不是医疗建议,也不能替代临床、法规、法务或品牌审批。

14 个控件总览

30 秒安装

要求 Node.js 20+。把仓库中的 Skill 目录复制到 Codex Skills 目录即可使用 SVG 核心:

git clone https://github.com/Nathanielguo/medtech-visuals-skill.git
cp -R medtech-visuals-skill/create-medtech-visuals "${CODEX_HOME:-$HOME/.codex}/skills/"
node "${CODEX_HOME:-$HOME/.codex}/skills/create-medtech-visuals/scripts/render_data_visual.mjs" --check

如需 PNG/PPTX,在已安装的 Skill 目录中安装可选依赖:

cd "${CODEX_HOME:-$HOME/.codex}/skills/create-medtech-visuals"
npm install

也可下载 dist/create-medtech-visuals-v1.0.0.zip,校验 SHA-256 后解压到 Skills 目录。GitHub 路径安装时使用仓库路径 create-medtech-visuals/

三条一句话示例

  • 把实际 1260 万、目标 1120 万做成目标达成小组件,主色 #0072EF。
  • 把区域销售数据做成右半页横向排名控件,输出 SVG 和 PNG。
  • 生成医疗培训场景横图,人物在左,右侧留标题区,避免可识别设备和 Logo。

14 个数据控件

# 类型 变体 适用表达
01 KPI hero 单一核心数字与结论
02 KPI compact 半页、侧栏和多指标并排
03 目标 progress 实际、目标和达成率
04 目标 gap 实际、目标与差距/超额
05 增长 comparison 前后期叙事比较
06 增长 columns 从零开始的绝对规模比较
07 趋势 area 6–12 个连续周期
08 趋势 sparkline 紧凑摘要趋势
09 排名 bars 精确类别规模比较
10 排名 dots 轻量多类别排名
11 占比 stacked 100% 横向组成关系
12 占比 donut 单一组合结构
13 表格 grid 多字段精确查阅
14 表格 cards 前三名重点对象

全部 SVG、PNG 和总览见 examples/controls/

5 类图片风格

风格 适用场景
editorial-people 对外宣传、领导汇报、协作与培训
clinical-workflow 临床使用语境、客户培训、模拟工作流
technical-detail 工程、服务、制造、产品原理
scientific-educational 代理商/客户培训、概念流程解释
abstract-precision 封面、章节页、创新、连接与精密科技

低分辨率示例和最终提示词见 examples/images/。示例均标注为 AI 概念,不是真实人员、设备、医院或临床证据。

换色

只提供一个主色即可,渲染器会派生可读深色、浅色背景、上下文色和组成色板:

{
  "type": "target",
  "variant": "progress",
  "title": "季度目标达成率 112.5%",
  "actual": 1260,
  "target": 1120,
  "theme": { "primary": "#0072EF" }
}

它不会自动宣称符合任何官方品牌规范。只有检测到兼容品牌 Skill 或用户提供明确品牌 token 时才应用;否则使用中立医疗科技风格。

直接使用渲染器

node create-medtech-visuals/scripts/render_data_visual.mjs \
  --spec examples/spec.json \
  --out-dir outputs \
  --formats svg,png,pptx

正常结果保持稳定结构:

{
  "ok": true,
  "outputs": [".../target.svg", ".../target.png"],
  "skipped": [{ "format": "pptx", "reason": "..." }]
}

命令行支持 --help--version--check。未知类型、变体、格式、缺失数组、长度不一致、非法颜色或零输出会返回非零状态和可操作错误。

输出格式

  • SVG:零依赖核心,适合 PowerPoint/Word 插入和矢量缩放。
  • PNG:需 sharp 0.34.x,用于预览和兼容性插入。
  • PPTX:需 sharp 0.34.x + pptxgenjs 4.x,生成单页 16:9 包装文件。
  • 图片:由调用环境的 imagegen 能力生成;若能力缺失,只返回最终提示词和明确说明。

应用场景

覆盖内部汇报、领导评审、销售运营、对外宣传、代理商培训、客户培训、临床使用沟通、会议活动和产品/服务培训。外宣或临床使用数据若缺少来源、周期、单位或真实性依据,Skill 会先询问;真实设备、Logo、医院、患者、程序和临床结果只能使用授权素材。

已知限制与安全边界

  • 数据渲染器不联网,也不验证业务数据真伪;使用者必须确认来源和口径。
  • PPTX 是跨渲染器优先的整页图片包装,不是逐元素可编辑图表;编辑优先使用配套 SVG。
  • 生成式图片可能出现人物、手部、PPE、透视或设备关系错误,发布前必须人工审核。
  • 不生成或仿制真实品牌设备、Logo、界面、病例、临床结果或监管证据。
  • 不把 AI 概念图表述为纪实照片、真实医院或临床证据。

架构、流程、权限、依赖、测试和安装验证见 documentation/installation-verification.md。许可和免责声明见 LICENSENOTICE.md

English summary

create-medtech-visuals is a vendor-neutral Codex Skill for producing 14 copy-ready medical-technology data controls and five professional image families from one instruction. SVG is dependency-free; optional Sharp and PptxGenJS enable PNG/PPTX. The image route uses imagegen when available and otherwise returns only a production-ready prompt with an explicit capability notice. See README.en.md for the concise English guide.

About

Vendor-neutral Codex Skill for medical-technology data controls and professional image workflows.

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors