powerbi-report-cli

Name: powerbi-report-cli
Author: microsoft

github.com/microsoft数据与数据库1.3k176 次安装3 周前更新

代码仓库

关于 powerbi-report-cli

面向 Power BI 报告生命周期的命令行技能，供 Agent 处理需求、设计、本地 PBIR/PBIP 编写、预览及 Fabric 报告项管理。它按模式分派任务，并要求新报告在实施前获得批准。

主要功能

01规划与审批工作流
02报告设计指导
03本地 PBIR/PBIP 编辑
04报告预览与验证
05Fabric 报告项管理
06按模式路由任务

适用场景

01规划新报告并在构建前取得批准
02为报告选择布局和图表类型
03编辑并预览本地 PBIR/PBIP 报告
04在 Fabric 中发布或管理报告项

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/microsoft/skills-for-fabric --skill powerbi-report-cli

安装后在 Claude Code 中输入/powerbi-report-cli确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

apm.yml

references/

authoring-part-02.md

authoring-part-03.md

authoring-part-04.md

authoring.md

references/authoring/

authoring-workflows.md

bookmark.md

button-part-02.md

button-part-03.md

button.md

card-part-02.md

card-part-03.md

card.md

cartesian-part-02.md

cartesian-part-03.md

cartesian-part-04.md

cartesian.md

color-strategy.md

conditional-formatting-part-02.md

conditional-formatting-part-03.md

conditional-formatting-part-04.md

conditional-formatting-part-05.md

conditional-formatting-part-06.md

conditional-formatting-part-07.md

conditional-formatting.md

custom-visuals.md

expressions.md

field-parameters.md

filter-pane.md

filters.md

详细介绍

遥测——强制要求。 每次调用 api.fabric.microsoft.com 都必须携带 x-ms-fabric-skill: powerbi-report-cli（az rest：--headers "x-ms-fabric-skill=powerbi-report-cli"），包括每次 LRO 轮询、fabric_lro 和重试。代码片段中省略了此项，但仍须添加。

重要说明

要通过工作区名称查找工作区详细信息（包括其 ID）：先列出所有工作区，然后使用 JMESPath 进行筛选。

要通过工作区 ID、项目类型和项目名称查找项目详细信息（包括其 ID）：先列出该工作区中所有此类型的项目，然后使用 JMESPath 进行筛选。

对于报表项目（需求、设计、PBIR/PBIP 页面和视觉对象编辑、预览和发布），请使用 powerbi-report-cli。语义模型、度量值和 DAX 工作应使用语义模型技能。关于报表数据的自然语言问题应使用 fabriciq。

Power BI 报表 - CLI 技能

此技能负责 Power BI 报表的端到端生命周期：需求和范围、视觉设计、本地 PBIR/PBIP 编写和预览，以及 Microsoft Fabric 中报表项目的传输。

它是一个模式分派器，有意不包含详细流程。请根据请求选择相应模式，然后在操作前从头到尾阅读对应的模式参考文档。模式文件包含所需的工作流、命令、有效负载、模板和故障处理规则。

模式选择

模式	适用请求...	现有流程示例	首先阅读
`planning`	创建新的报表/仪表板，并需要在实施前完成需求、模型/依赖项检查、范围界定、页面规划和审批	创建报表、构建仪表板、根据语义模型创建、先规划再实施、引导我创建报表	references/planning.md，然后阅读 references/planning-part-02.md
`design`	决定报表应有的外观：基调、标志性设计、页面原型、图表类型、布局、颜色、排版、主题方向、无障碍设计、品牌应用、重新设计或评审	设计 Power BI 报表、让仪表板更专业、选择图表、应用品牌、重新设计报表、创建设计简报	references/design.md
`authoring`	读取或编辑本地 PBIR/PBIP 文件、验证文件、预览报表或截取屏幕截图	编辑 PBIR、创建/添加报表页面或视觉对象、设置视觉对象格式、添加筛选器/切片器/书签/主题、验证 PBIR、在 Desktop 或服务中预览/重新加载/截屏	references/authoring.md
`management`	将报表定义移入或移出 Fabric，或管理工作区报表项目	发布/上传/下载 PBIR 或 PBIP、列出报表、获取/更新/删除报表、重新绑定报表	references/management.md

模式边界规则

根据意图分类，而不是根据当前已打开的文件或工具分类。
design 决定报告应该呈现什么样子；authoring 编写实现该设计的 PBIR。选择图表类型属于 design；将其编码到 visual.json 中属于 authoring。
对现有本地报告重新设置样式或格式属于 authoring，即使请求使用了设计相关措辞也是如此。当用户需要的是建议或设计约定，而不是修改文件时，使用 design。
authoring 修改本地文件并执行预览/验证，但不会发布到 Fabric。
management 传输定义并管理 Fabric 报告项，但不会构思或直接编写 PBIR 内容。
planning 负责引导用户完成新报告从需求到审批的流程。对现有报告进行针对性编辑时，直接进入 authoring。

从零开始的请求可以按以下顺序跨越多个模式：

planning -> design -> authoring -> management

每次只处理一个模式。切换时要明确告知，并在开始该部分工作前阅读新模式的参考资料。planning 的审批关卡是一个轮次边界：在用户于后续回复中明确批准锁定的规范之前，绝不能构建或发布。

从零开始项目的审批屏障——必须遵守。 如果新报告请求要求进行规划、构建和/或发布，但用户尚未在之前的回复中批准锁定的规范，则将当前阶段设为 approval_pending，并仅保留 planning 为活动模式。在此阶段，不得加载 authoring 或 management，不得编辑/搭建 PBIR 或语义模型文件，不得生成合成数据，不得调用 Fabric 写入 API，也不得发布。持久化保存 _brief/report-spec.md，请求用户明确批准，然后结束本轮。原始请求中关于构建/发布的措辞仅表示期望的后续工作范围，并不代表批准跨越此屏障。

各模式必须交付的成果

模式	完成要求
`planning`	持久化保存 `_brief/report-spec.md` 或用户指定的等效文件，请求用户明确批准，并在实现前停止。
`design`	输出完整的 `Design Brief:` 约定，其中包括 `design_identity`，以及每个页面的页面类型/布局约定。不得编辑 PBIR 或调用 Fabric API。
`authoring`	持久化保存所请求的 PBIR/PBIP 更改，逐个验证逻辑批次，然后完成 authoring 参考资料要求的预览和截图审查工作流。不得发布。
`management`	完成所请求的 Fabric 报告操作，包括 LRO 轮询和文档规定的回读验证。

规则

必须遵守

选择能够完整满足当前请求的最精简模式。
在该模式下执行首条命令或编辑首个文件之前，完整阅读 references/<mode>.md。如果已加载的模式明确将某项范围狭窄的跨模式操作转交给指定主题参考文件，则将该主题参考文件视为完整的交接内容；除非工作范围扩大到该操作之外，否则不要加载目标模式的总览文件。
在 planning 模式下，生成 _brief/report-spec.md 之前，还要阅读 references/planning-part-02.md；其中包含必需的规范设计契约和审批检查。
在多轮任务中，保留简洁的工作状态，包括已确认的工作区／项目／模型 ID、本地和已下载路径，以及已阅读的参考文件。后续轮次中重复使用这些信息，除非用户明确要求重新查询，或前序操作导致某个值失效。
遵守所选模式文档中记录的所有参数和安全边界。
请求跨越边界时，明确宣布并执行模式切换。
使用 powerbi-report-author CLI 的元数据和验证接口，不要猜测 PBIR 架构、角色、格式属性、选择器或枚举值。
除非用户明确要求发布，否则将本地编辑保留在本地。
通过列出并筛选来确定 Fabric 工作区和项目 ID，不要猜测标识符。
产出用户要求的内容；只阅读或总结参考文件不算完成任务。

优先遵循

优先推断提示词、语义模型、现有 PBIP 或先前已批准规范中已有的信息，而不是再次询问。
仅加载所选模式及其直接相关的主题参考文件。
重用当前任务中已加载的参考指南。只有在请求的操作或观察到的不匹配需要时，才打开新的参考文件。
保留用户现有的项目结构、架构、宿主、操作、绑定和交付目标，除非所选模式明确要求更改。

避免

未阅读所选模式参考文件就依据此分派器采取行动。
仅因对话进入后续轮次，就重新加载当前任务中已阅读过的此分派器、模式文件或主题参考文件。
加载已弃用的同级技能名称；planning、design、authoring 和 management 是此技能的模式。
在 planning 或 design 模式下编辑 PBIR 或调用 Fabric API。
在 authoring 模式下发布，或在 management 模式下编写 PBIR 内容。
因原始请求还要求构建或发布，就绕过 planning 审批关卡。

完整参考索引

直接从此索引打开所有相关参考文件。名为 part-XX 的文件是对应主题的续篇。

Authoring

设计

模式指南

示例

用户请求	模式
“根据此语义模型创建一份新的执行报告。”	`planning`
“设计一个运营页面并选择合适的图表。”	`design`
“向此 PBIP 添加一个 KPI 页面，进行验证并截取屏幕截图。”	`authoring`
“将此本地 PBIP 发布到我的 Fabric 工作区并重新绑定。”	`management`

路由兼容性

合并后的技能保留了之前的四种路由形式。以下短语是相应模式的明确别名：

模式	保留的路由短语
`planning`	创建报告；构建报告；创建仪表板；从头开始创建新报告；根据语义模型或数据集链接创建报告；为此模型构建报告；为我制作仪表板；先规划再实现；引导我创建报告
`design`	设计 Power BI 报告；让仪表板看起来更专业；选择图表类型；将品牌风格应用到报告；重新设计报告；创建设计简报；Power BI 报告设计原型
`authoring`	编辑 PBIR；创建 Power BI 报告页面；向 PBIP 添加可视化对象；设置报告可视化对象的格式；验证 Power BI 报告；预览 Power BI 报告；Power BI Desktop 预览状态；在服务中预览报告；在浏览器中预览报告；截取报告页面的屏幕截图；截取所有报告页面的屏幕截图；列出预览主机；在 PBIP 中实现仪表板；向报告添加仪表板可视化对象；实现已批准的 PBIP 报告规范；编辑 PBIR 页面/可视化对象；编辑 Power BI 报告
`management`	上传 PBIR 报告定义；上传 Power BI 报告；下载 PBIR 定义；发布 PBIR 定义；将 Power BI 报告发布到 Fabric；管理 Power BI 报告；列出工作区报告

支持 Markdown

登录后评论

基本信息

作者: microsoft
仓库: microsoft/skills-for-fabric
分类: 数据与数据库
安装次数: 176
GitHub Stars: 1,294

报告问题