chart-assistant
图表助手
为大模型提供图表助手产品契约。模型负责理解业务语义、识别字段、选择模板和生成配置;运行时负责鉴权、读取数据、同步和写入飞书;本 Skill 负责说明什么结构合法、什么能力真实存在、如何安全交付。
建图入口与首答交付
用户明确要求“图表助手”“可编辑图表/配置”“图表助手卡片”或数据源同步等产品能力时,即使没有写出技能名,也按图表助手建图请求处理。仅要求“做成图表”“建趋势图”“画条形图”而未要求这些能力时,不主动接管。进入本 Skill 后,首次建图生成可编辑的 commonOption;最终按用户选择交付 DSL、可编辑卡片、PNG 或飞书文档内的图片。需要写飞书卡片时再按宿主接口包装为 record。普通 ECharts、HTML 预览或静态图片不能替代用户要的图表助手配置。若同时要求简短分析和建图,两项都完成,分析句数遵从用户限制;用户限定“只给”指定产物时,不另加验证过程、后续邀约或其他正文。少量时间点只描述已观察到的升降,不推断稳定状态或长期趋势。明确只要文字解释、不要求建图时,只回答解释。
首答先核对用户是否给了单位和来源。明确说“没有单位”时,标题、轴、数据标签、正文和预览均不得补“人”“次”等单位;未给出单位时也不从指标名猜测。可以使用原字段名“报名人数”“访问量”,但不要把其中的字推断为独立的单位声明。未给来源链接时不生成来源 URL。
标注的新生成默认
新建智能标注统一使用编辑器作者语义:直接 DSL 写 options.config.marker 中的 target 与样式;通过图表助手 API、CLI 或 MCP 调用时,默认 markerFormat: "editor-marker-authoring/v1"、markerCapabilityVersion: "core-semantic-v1",不需要开发 query 或 opt-in。LLM 输出编辑器接受的 record,server 校验,Core 在渲染时解析位置与动态值;不生成 generatedMarkers.spec、generatedQuadrantMarker 或预计算坐标。保存作者记录,重开仍由 Core 解析。
该 API 能力包含 point、reference、area、total、growth、hierarchy;显式旧 S1/S2 能力只收窄作者种类,不恢复旧生成路线。普通 Core DSL 的其它已有语义结构按各章节能力说明使用,不能借旧响应字段绕过 API 校验。用户明确要求原生 spec 导出时由 Core 对当前作者态实际渲染并导出,不让模型拼接坐标;历史保存态读取与原生导出不等于旧标注生成。
执行边界
所有任务先保证配置正确,最终产物按用户选择交付:检查数据、模板能力、字段、业务 target、标注边界和配置结构;写入时执行 readback。仅交付 DSL/卡片时默认不运行本地渲染、截图、视觉验收、保存重开测试或循环调整布局,也不为预览搜索运行时、安装 canvas/系统依赖或修复编译环境。用户要求图片时必须执行 图片交付:使用随包客户端调用托管渲染,默认透明背景;成功保存真实 PNG 后才可称图片交付完成。以参考图片还原图表是视觉复刻任务:必须按 参考图片还原 生成并查看实际图面;没有可用渲染能力时只能交付“待视觉核验”的配置,不能宣称复刻完成。普通建图和配置编辑仅在用户明确要求查看效果、或排查视觉问题时,使用已有图面或工具处理;不把它附加为默认要求。