powerbi-modeling

Power BI 建模

技术栈目标 / 版本：Power BI Desktop 当前版本、Tabular Editor、DAX Studio 和 Fabric 语义模型工作流。

当工作涉及 Power BI 语义模型，而非通用 SQL 架构或电子表格时，请使用此技能。

• 在条件允许时，利用原生并行子 Agent 调度和 200k+ 上下文窗口。

激活条件

使用“症状 -> 操作”触发条件：当符合以下任一条件时，应用此技能并按照下方协议进行验证。

• 设计或清理星型架构
• 创建或审查 DAX 度量值
• 配置关系和交叉筛选方向
• 实现行级安全性
• 审核模型运行状况和性能

实用工作流

1. 修改前先检查当前模型。
2. 将表分类为维度表、事实表、桥接表或辅助表。
3. 优先使用显式度量值，而非隐式聚合。
4. 除非已证明具体用例需要，否则应保持关系简单且为单向。
5. 对报表作者隐藏技术字段。

MCP 现状

Power BI 建模工具因宿主而异。如果客户端提供 Power BI 建模 MCP 服务，请先检查可用操作，再将其对应到所需的模型区域：连接、表、列、度量值、关系、DAX 查询和安全角色。

对于 Microsoft 文档，Microsoft Learn MCP 服务是很好的搭配。优先使用：

• microsoft_docs_search_by_product，并指定 power-bi
• microsoft_docs_fetch 获取最终页面

跨客户端可移植性

此技能旨在适用于 GitHub Copilot、Claude Code 和 Codex。

• GitHub Copilot：将文件夹放在 Copilot 可见的技能路径中；如果无法发现文件夹，则将工作流封装在项目说明中。
• Claude Code：将文件夹放在本地技能目录或兼容的插件源中。
• Codex：将文件夹安装或同步到 $CODEX_HOME/skills/powerbi-modeling，并在重大更改后重启 Codex。

MCP 可用性与回退方案

首选 MCP 服务：Power BI MCP

• 回退提示词：“不使用 MCP，改用 Power BI Modeling 技能。遵循文档说明的本地或手动回退方案，展示所选工具界面，并报告验证证据。”
• 如果 MCP 界面不可用，请使用 Power BI Desktop、Tabular Editor、DAX Studio 和导出的模型元数据。
• 完成前，使用本地模型工具验证度量值、关系和性能。
• 如果当前宿主未提供 MCP 操作，不要声称使用了该操作。

反模式

• 将源内容视为已经清理：格式自动化会原样保留有问题或不一致的输入。
• 跳过打开文件验证：文档和电子表格往往是在目标应用中出错，而不是在脚本输出中出错。
• 在没有检查点的情况下自动执行不可逆编辑：一个小小的映射错误就可能影响整个工作簿或文档。

验证协议

在声称“技能已成功应用”之前：

1. 通过/未通过：Powerbi Modeling 实现明确说明目标运行时、框架版本和受影响文件。
2. 通过/未通过：已对更改涉及的部分运行构建、Lint、测试或等效的本地验证。
3. 通过/未通过：已处理错误、依赖漂移和环境差异等边界情况，或明确说明其不在范围内。
4. 压力测试场景：将工作流应用于一种能通过正常路径测试、却会在某个边界条件下失败的更改。
5. 成功指标：零未经测试的成功声明；每项实现声明都对应一条命令或一个产物。

参考资料与资源

文档

• 星型架构 - 维度和事实建模指南
• 关系 - 关系模式和交叉筛选权衡
• 度量值-DAX - DAX 命名和度量值设计
• 性能 - 高影响优化思路
• RLS - 行级安全模式

脚本

• Power BI 模型审计 - 用于检查命名、文档和建模问题的本地辅助工具

示例

• 模型示例 - 建模模式和 DAX 结构示例

相关技能

• documentation-authoring：当工作流还需要起草结构化技术或产品文档时使用。
• notion-docs：当工作流还需要发布 Notion 页面和数据库时使用。
• pdf：当工作流还需要提取、生成 PDF 并根据版面进行审阅时使用。
• word-document：当工作流还需要编写和格式化 Word 文档时使用。