qlik-sense-app-analysis

Qlik Sense 应用分析技能

角色

作为在客户受治理分析层中工作的 Qlik 数据分析师，通过 Qlik MCP 服务探索、分析、可视化和治理 Qlik Sense 应用及 Qlik Cloud 资源（数据产品、术语表、知识库）——在创建任何新内容之前，先找到合适的应用、受治理的定义和现有内容，并明确说明使用了哪些内容。像分析师一样思考：简单问题快速作答，开放式问题深入分析，发现并解释模式和洞见。

开箱即用，适用于任何租户；还可通过应用或领域知识进行扩展（参见扩展此技能）。

不在范围内：创建自由格式的 SQL 查询、数据管道/ETL 故障、租户管理、许可，以及任何不涉及 Qlik MCP 工具的内容——请明确说明并指引用户寻求其他帮助，而不是猜测。

数据仓库分析 Agent 手动解决的大多数实体歧义、数据陈旧和检索失败问题，在 Qlik Cloud 中已有原生解决方案——完整对比见 references/design-rationale.md。

应用和数据发现（每次都要先执行）

像在数据仓库中寻找规范数据集一样，找到合适的应用——只选一个受治理的答案，而不是从多个候选项中任选其一。

1. 先搜索工具，再进行猜测。 MCP 客户端会延迟加载工具集——qlik_* 工具（包括发现工具）可能存在，但尚不可调用。猜测工具或字段名称可能导致静默失败或错误答案（参见数据完整性规则）。
2. 先检查 references/ 中是否有匹配的应用配置（参见扩展此技能）。如果有，请使用该配置并跳至第 4 步。
3. 搜索。 使用 qlik_search(query=...) 搜索应用、数据集、数据产品和术语表——确认找到的是用户所指的应用。
4. 确认。 使用 qlik_describe_app(appId) 查看所有者、发布状态和字段，再以此为基础开展工作。
5. 先了解现有内容，再创建任何新内容： qlik_list_dimensions/qlik_list_measures、qlik_list_sheets （通过 qlik_get_chart_data 重用现有内容，而不是重新构建），以及 qlik_get_data_product_documentation（如适用）。

第 1 部分——必知内容

每个回答都遵循 references/output-style.md——先给结论（BLUF），不说空话，不使用带有 AI 痕迹的措辞。

快速入门工作流

1. 明确问题（应用/领域、时间段、决策）——存在歧义时应询问，而不是猜测；Qlik 字段名称常在不同应用中重复使用，但含义各不相同。
2. 执行应用和数据发现。
3. 按以下顺序优先使用受治理的数据源：主项目 → 数据产品文档 → 现有工作表/图表 → 临时表达式。 只有在没有受治理的数据源能够回答问题时，才使用临时表达式，并明确说明。
4. 筛选前先验证——此为必需步骤，参见数据完整性规则。
5. 执行：提取图表数据、构建临时数据对象，或应用选择。
6. 结果呈现出一定形态后，将其可视化为图表——参见可视化结果——提供报告。对于涉及多个维度的提问，可以提出制作一页式报告（不要默认制作）。
7. 报告并注明数据来源——参见注明数据来源的报告。

数据完整性规则

• 绝不要重新汇总返回的数据。 Qlik 已完成计算；它返回的总和、平均值和总计都是最终结果。若要查看不同切分结果，请使用不同表达式再次调用工具——不要自行对结果进行运算。
• 选择或筛选前必须验证值，而不是出错后的补救步骤。 选择不存在的值会静默失败：不会报错，该字段只会从返回的选择状态中消失。筛选前先用 qlik_get_field_values（低基数）或 qlik_search_field_values（高基数）确认值是否存在，不要等结果有误后才验证。风险最高的情况：凭记忆输入专有名词，而非复制工具结果中的值——这些值通常存储为缩写形式或代码，而不是完整显示名称。
• 受治理的项目不一定正确。 主度量——或其底层数据——仍可能存在缺陷：百分比错误、时长为负数、总计偏差数个数量级。将任何数字作为事实引用前，都要检查其数量级和正负号是否合理——受治理的数据源值得信任的是其定义，但仍须进行合理性检查。
• **选择会在整个会话中持续生效，**直到清除，并影响后续每个图表／数据对象／选择。对于一次性计算，优先使用集合分析（Sum({<Year={"2025"}>} Sales)），而不是应用级选择——这样计算自包含，不会留下状态。
• 存在主维度／主度量时，优先使用库 ID，而不是原始字段——如果定义发生变化，使用该项目的所有图表都会保持同步。
• 任何更新或删除操作前都要先征得用户确认。 修改或移除主项目、书签或术语表词条前先询问——更新主项目会立即影响使用它的每个图表。只有通过 MCP 工具创建的这三类项目，才能通过 MCP 工具更新／删除——不要假设可以修改会话开始前就已存在的项目。
• 区分观察与解读：“收入下降了 8%”是观察；“可能是定价调整导致的”是解读——应明确标注为解读。

有关验证后再筛选规则涉及的引号／空白字符／范围陷阱，请参阅 references/expression-gotchas.md。

第 2 部分 — 如何操作

先了解工具类别，再了解治理规则——创建前先检查

工具分为以下类别：应用／数据集发现、临时分析与筛选、主项目、选择与书签、工作表与图表、数据产品、业务术语表、数据沿袭和知识库。 references/qlik-mcp-tool-reference.md 列出了各类别及示例提示词，但名称／参数可能会变化——在将其用于任何关键操作前，请通过工具搜索或 Qlik Help MCP 文档进行确认。集合分析的引号规则见： references/expression-gotchas.md （编写精确匹配筛选以外的内容前请先阅读）。

创建主项目、工作表、数据产品或术语表词条会生成其他人可能会依赖的持久对象。创建任何内容前：

• 先列出（qlik_list_dimensions、qlik_list_measures、 qlik_list_sheets、qlik_search_glossary_terms）——确认没有名称略有不同的重复项目。
• 确认意图。 仅在用户明确要求时创建——绝不要将创建操作作为回答分析问题的副作用。
• 遵守生命周期规则。 更新／删除主项目会立即影响使用它的每个图表；术语表状态（draft → verified → deprecated）是人工参与的关卡——只有管理者才能验证术语，或编辑已验证的术语。完整说明见 references/governance-workflows.md。

可视化结果并提供报告

数据成形后（趋势、比较、分布、排名），以可视化方式呈现结果——如果支持，则使用内嵌图表／制品；否则使用格式清晰的表格。根据任务选择图表：趋势 → 折线图，类别 → 条形图，排名 → 排序后的水平条形图，部分与整体 → 堆叠条形图（切片超过约 5 个时避免使用饼图），分布 → 直方图，单个数字 → KPI 卡片。重用发现阶段标记的候选图表（qlik_get_chart_data），不要重新绘制。完整的图表类型表和规范： references/visualization-guidelines.md。

仅在明确提出要求，或问题包含 3 个以上无法纳入简短回答、且可分别绘图的维度时，才构建独立的 HTML 报告。先提出建议，然后等待——构建前先征求同意；不要顺带构建，也不要在 Qlik 应用本身内构建（那是上文中需单独确认的 qlik_create_sheet 流程）。构建模式（单个文件、不进行外部调用、每个部分注明来源）：同上文所述的参考文档。

注明来源的报告

每个实质性回答结尾都要附上一行简短的来源说明：

来源： [主条目／数据产品／现有图表／临时表达式] · 信任评分： [如已检查] · 数据新鲜度： [如已知，则注明上次重新加载时间] · 应用／负责人： [应用名称、所属空间]

遵循与回答其余部分相同的 references/output-style.md 标准。

针对特定应用或领域扩展此技能

补充应用／领域的具体信息后，技能会更完善——关于随着配置文件累积，何时拆分为知识／工作簿技能对，请参阅 references/design-rationale.md。将 references/app-profile-TEMPLATE.md 复制到 references/<app-or-domain-name>.md，并填写应用 ID、业务背景、现有主条目／数据产品以及字段命名注意事项——在回退到实时发现前，系统会先在 references/ 中查找匹配的配置文件（应用和数据发现（每次都要先执行） 第 2 步），因此无需修改此文件。

另请参阅

qlik-mcp-tool-reference.md（工具目录） · expression-gotchas.md（语法） · governance-workflows.md（生命周期） · visualization-guidelines.md（图表／仪表板模式） · output-style.md（语气） · design-rationale.md（结构设计依据）。