Frappe Insights 技能用于在 Frappe 站点上管理 Insights 工作簿，涵盖创建、读取、更新和删除工作簿及其内部的查询、图表和仪表板。工作簿是一组文档：Insights Workbook 包含 Insights Query v3（操作管道）、Insights Chart v3（基于查询的配置）和 Insights Dashboard v3（图表与过滤器）。所有操作通过文档读写或白名单方法完成，因此可在站点助手、MCP 或 frappectl 中一致使用。
该技能仅支持 Insights 4（develop）站点。开始前需调用 insights.api.get_app_version 检查版本，若主版本低于 4 则停止。站点需已安装 Insights，无需其他依赖。用户以连接用户身份操作，所见即所得。MCP 服务器要求用户具有 System User 角色，否则需通过 frappectl 访问。所有站点交互必须通过 API 调用，禁止直接读写站点文件、数据库或日志。
使用流程包括：首先读取站点信息（版本、数据源、工作簿列表），然后将业务需求翻译为站点词汇，通过搜索工作簿、查询、图表标题或内容来复用已有定义，必要时搜索表标签和列。跨数据源查询需使用数据存储（data store），并确保所有表已存储。技能提供了错误处理指南，如 UnknownColumn、NotPermitted、QueryRefused 等异常类型的修复方法，以及无原因错误的重试、二分和报告步骤。
适用场景包括：用户需要创建或修改 Insights 工作簿、查询、图表或仪表板；需要基于现有定义构建分析；需要跨数据源整合数据。限制：仅支持 Insights 4 develop 站点；部分端点可能缺失，需探测后使用；MCP 仅限 System User；权限受连接用户限制。