1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | powerbi-report-authoring-microsoft-skills-for-fabric |
| 项目自述名称 | Power BI Report Authoring skill（README 内称“Power BI report authoring”） |
| 作者/维护者 | Microsoft（Microsoft Fabric 团队） |
| 来源链接 | https://github.com/microsoft/skills-for-fabric/tree/main/skills/powerbi-report-authoring |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 881（数据来自 GitHub API；此数字为所属合集仓库整体热度，不代表本技能自身热度，详见第 6 章说明） |
| Forks | 239（同上，合集仓库整体） |
| 最新版本 | v0.3.9（2026-07-23 发布，数据来自仓库 CHANGELOG） |
| 安装方式 | GitHub Copilot CLI / Claude Code 插件市场，或手动复制技能目录 |
2. 功能介绍与亮点
本技能负责读取、编辑与创建 Power BI 报告的 PBIR（Power BI Report） 格式文件，即 PBIP（Power BI Project） 项目中的报告定义部分：新增/修改页面、可视化图表、筛选器、切片器、书签、主题与格式。
核心能力围绕两个官方 CLI 工具展开：powerbi-report-author 提供可视化类型目录、格式属性元数据查询与 PBIR 结构校验；powerbi-desktop（Power BI Desktop Bridge）负责与本机运行的 Power BI Desktop 通信，实现重载与截图。技能内置一套“编辑 → 校验 → 重载 → 截图 → 复核”的闭环工作流：每次改动后先离线校验 PBIR 结构，再驱动 Desktop 重新加载并截图，最后对渲染结果做人工可读的复核检查，确认视觉效果无误才算完成——这让 agent 在报告完工前就能“看见”自己的产出，而不是仅凭 JSON 是否合法来判断成功。
SKILL.md 正文与随附的近 20 个专题参考文档中，沉淀了大量实测踩坑记录：过时可视化类型迁移路径、JSON 结构层级陷阱、深色主题改造的完整检查清单、图表配色跨视觉一致性方案等，均以“陷阱→后果→修复”表格形式呈现。
该技能是微软官方 Power BI 报告自动化家族的一员，与专注视觉设计建议的 powerbi-report-design、负责需求梳理与审批流程的 powerbi-report-planning 分工明确、互相衔接；微软官方 Fabric 社区博客与 Microsoft Learn 均为其单独撰写了产品文档页面。
3. 适用场景
固定分类：数据分析与可视化
面向已具备 Power BI 语义模型或 PBIP 项目、需要用自然语言快速搭建或迭代报告页面与视觉呈现的场景，典型受益人群包括 Power BI 报告开发者、BI 团队分析师，以及需要按统一设计规范批量产出多页面仪表盘的团队管理者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 可通过 .claude-plugin 插件市场清单一键安装，也可手动复制技能目录使用；曾因清单中 MCP 服务器类型字段与 Claude Code 不兼容而安装失败（GitHub issue #32），已于 2026-07-15 版本更新修复 |
| Codex | 需适配 | 仓库根目录提供 AGENTS.md，采用“Agents → Skills → Common”架构并显式将具体实现委托给 skills/ 目录下的技能，但需克隆整个仓库配合使用，无独立插件安装机制 |
| OpenClaw | 未验证 | 已抓取材料未提及 |
| Hermes Agent | 未验证 | 已抓取材料未提及 |
5. 推荐理由
微软官方出品的 Power BI 报告自动化技能，文档详尽、故障排查案例丰富，且内置“编辑→校验→重载→截图”闭环验证机制，能让 agent 在自然语言指令下独立完成报告页面搭建并自行核验渲染效果，把过去需要人工数小时的重复性报表工作压缩到分钟级。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方 Microsoft Learn 为该技能单独撰写产品文档页面，Fabric 官方社区博客亦有专文介绍；第三方技术博客 AI Kick Start、Data Ninja AI Lab 各自发文测评；GitHub 仓库获 239 次 fork，且有 6 位以上具名外部用户在 issue 中报告过与该技能直接相关的具体问题（如渲染桥接错误、格式校验疑问） |
| 可用性 | 8 | SKILL.md 正文连同近 20 个专题参考文档覆盖建表、配色、表格、地图等细分场景的完整示例与故障排查表；仓库按周持续发布新版本（CHANGELOG 记录到 v0.3.9），文档质量与维护频率俱佳；需要 Node.js 环境与两个官方 CLI 的全局安装，非零配置 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
① Shell 命令执行：有，范围限定为官方 npm 全局 CLI（powerbi-report-author、powerbi-desktop）中文档列出的固定子命令（校验、元数据查询、Desktop 重载/截图），不涉及任意 shell
② 联网外发：该技能本身不发起外部网络请求，仅通过本地 IPC 与运行中的 Power BI Desktop Bridge 通信
③ API Key/凭据：该技能自身不需要 API Key 或凭据（认证需求集中在同仓库其他调用 Fabric REST API 的技能中）
④ 可疑指令：抓取的 SKILL.md 全文及引用的参考文档均为报告编辑操作指引，未见可疑指令或隐蔽外发
⑤ 作者信誉：官方 Microsoft 出品，对外部问题反馈响应及时（如 issue #32 从报告到确认修复约 5 周）
⑥ License：MIT，明确
⑦ 最近维护：仓库主线与该子技能自身均在 2026-07-23 有直接改动记录
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| power-bi-agentic-development（个人维护者 Kurt，GPLv3） | 面向 Power BI/Fabric 的社区技能市场，含 DAX 调优、Power Query（M 语言）、Tabular Editor 自动化、Fabric CLI 租户治理等 11 个插件 | BI 建模与调优深度覆盖更广，但为个人维护的非官方项目，不含 Power BI Desktop 实时渲染截图复核这一验证闭环 |
| metabase/agent-skills（Metabase 官方出品） | 覆盖开源 BI 工具 Metabase 的嵌入迁移、SSO 配置、数据模型探索 | 面向完全不同的开源 BI 生态，不涉及 PBIR/PBIP 这类 Power BI 专有报告文件格式 |
| sigmacomputing/sigma-agent-skills（Sigma Computing 官方出品） | 跨 Claude Code、Cursor、Codex、Snowflake Cortex 多平台，服务 Sigma 云端 BI 对象模型 | 面向 Sigma 自有的云端 BI 对象体系，与 Power BI/Fabric 生态相互独立 |
8. 用户评价
- AI Kick Start 创始人 Daniel Fleuren 在测评文章中转引 YouTube 频道 “Guy in a Cube” 的实测：单条自然语言指令即可生成含 KPI 卡片、图表并正确绑定数据的报告，agent 能通过诊断底层 PBIR JSON 结构自行修复渲染错误，“过去需要数小时的任务被压缩到几分钟”；同时指出该技能仅支持 PBIP 项目格式（不支持传统 PBIX 单文件），且需要配合 Git 做好版本管控。
- Data Ninja AI Lab 作者 Shai Karmani 撰文评价：“让 agent 能够访问渲染后的页面截图是一个重要的实践进步”，并认为该技能覆盖的报表搭建、视觉对齐、主题调整等工作“结构清晰、以文件为基础、可视化程度高、可迭代”，适合团队先用单个不重要的报告做小范围试点。
9. 其他补充
仓库 CHANGELOG 按周更新，并配有 check-updates 配套技能，可在会话开始时自动检测本地版本与远程仓库差异并提示更新内容。仓库根目录同时提供 CLAUDE.md、.cursorrules、.windsurfrules、AGENTS.md、GEMINI.md 等多套配置文件，便于不同编码助手在克隆仓库后自动识别项目上下文。
10. 安装使用方式
方式一：插件市场（GitHub Copilot CLI / Claude Code）
/plugin marketplace add microsoft/skills-for-fabric
/plugin install powerbi-authoring@fabric-collection方式二：手动安装
克隆仓库后，将 skills/powerbi-report-authoring 目录复制到本地 agent 的 skills 目录即可，仅依赖同仓库 common/ 下的两个通用文档，无需整仓库其他内容。
前置依赖：Node.js 20 及以上版本；需全局安装两个官方 CLI：
npm install -g @microsoft/powerbi-report-authoring-cli@latest @microsoft/powerbi-desktop-bridge-cli@latest安装后注意事项：首次在会话中使用时，建议先触发内置的 check-updates 技能确认版本；若需要重载与截图验证，本机需已安装并打开 Power BI Desktop。
11. 注意事项
- 仅支持 PBIP/PBIR 项目文件格式，不支持传统 PBIX 单文件格式的直接编辑。
- 重载与截图验证环节依赖本机实际运行的 Power BI Desktop——该应用目前主要面向 Windows，macOS/Linux 用户在使用完整验证闭环前需自行确认桌面应用的可用性。
- 本技能只负责报告文件层的页面与可视化编辑；语义模型（TMDL）层面的建模与度量值改动需配合同仓库的
semantic-model-authoring等姊妹技能。 - 曾出现插件市场安装在 Claude Code 上因 MCP 服务器类型字段不兼容而失败的问题，已于 2026-07-15 版本更新修复，使用较旧版本者建议先升级。