chart-assistant
Installation
SKILL.md
图表助手
为大模型提供图表助手产品契约。模型负责理解业务语义、识别字段、选择模板和生成配置;运行时负责鉴权、读取数据、同步和写入飞书;本 Skill 负责说明什么结构合法、什么能力真实存在、如何安全交付。
执行边界
业务任务以生成正确配置为交付目标:检查数据、模板能力、字段、业务 target、标注边界和配置结构;写入时执行 readback。默认不运行本地渲染、截图、视觉验收、保存重开测试或循环调整布局,也不为预览搜索运行时、安装 canvas/系统依赖或修复编译环境。以参考图片还原图表是视觉复刻任务:必须按 参考图片还原 生成并查看实际图面;没有可用渲染能力时只能交付“待视觉核验”的配置,不能宣称复刻完成。普通建图和配置编辑仅在用户明确要求查看效果、或排查视觉问题时,使用已有图面或工具处理;不把它附加为默认要求。
只按当前任务读取相关 Reference,复用本会话已确认的协议和能力;环境未变化时不重复探测失败的预览能力。缺少预览不阻塞正确配置的生成或经 readback 验证的写入,不承诺自动避让或视觉验收通过。
外部能力运行前检查
本 Skill 是图表助手 DSL 与交付协议,不自带飞书写入工具、数据源插件、CLI、MCP 或凭证。加载成功只说明可以生成、解释和校验配置;不得因此声称已经创建文档、插入卡片或完成同步。
- 涉及外部数据、文档或同步时,先确认当前宿主是否实际提供所需能力:读取数据源、创建或读取 Docx、创建/更新
block_type:40卡片,以及写后 readback。缺任一能力时,继续完成可做的 DSL/record 校验,并明确标记未执行的外部操作。 - 需要创建或替换飞书卡片时,确认目标账号已可使用 ISV「图表助手」、对目标文档有相应权限,且目标 Sheet/Base/风神数据源可访问。应用安装、文档权限、数据源权限和宿主写入能力是彼此独立的门槛。
- 宿主若通过 CLI 或 MCP 提供上述能力,必须由宿主或连接器显式安装、配置和授权;不得假设运行环境预装 CLI,也不得要求用户在对话中提供 token、cookie、app secret 或签名。MCP 未接入时按无写入工具处理,不尝试伪造调用。
- 不需要外部工具的请求(生成、解释、编辑或校验 DSL/record)可直接完成。涉及参考图片复刻时仍须有实际渲染能力才可声称视觉复刻完成。