用途:该技能让 Claude 掌握 Power BI Enhanced Report(PBIR)JSON 格式,以便读取、创建和修改 PBIR 报表。不支持旧版 report.json 或布局报表元数据;从旧格式转换需在 Power BI Desktop 中打开并保存报表。
主要能力:覆盖报表结构(version.json、report.json、pages、visuals、bookmarks、StaticResources、主题、definition.pbir 等);visual.json 的表达式、字段引用、查询角色、位置、格式化、选择器、排序、筛选与钻取;主题继承、通配符与 visualType 覆盖;筛选器(7 种类型);条件格式;扩展度量值与 visual 计算;分页、工具提示页、钻取页;自定义视觉对象注册;标注与元数据;字段重命名修复;旧格式转换。
使用方式:在本地 .Report 文件夹(PBIR 格式)上工作,修改前先备份。通过 pbir new 创建报表,pbir add filter 添加筛选器,pbir report convert 转换受支持的格式,pbir validate 校验,pbir theme push-visual 将视觉格式推送到主题。使用 definition.pbir 的 byPath(本地厚报表)或 byConnection(远程薄报表)连接语义模型。
限制与规则:PBIR JSON 视为实现细节,所有报表、视觉、页面、书签、筛选器、移动布局和主题变更都通过 pbir 完成,禁止手工编辑或文本替换报表 JSON;若 pbir 无法表达所需变更,应报告能力缺口而非自行写原始 JSON。PBIR 是严格 JSON,不允许注释。不要解压或打补丁 PBIX 内部,不要直接处理 PBIT 文件。合法 JSON 不保证渲染,需依赖 Power BI Desktop 或浏览器检查。
适用场景:报表格式化、页面布局、主题、筛选、书签、扩展度量值、图片与 SVG、文本框、排序、切片器同步、视觉交互、表格列宽、分组、隐藏元素、移动端布局及 Git 卫生等 PBIR 开发任务。