告别手动文档，一句话自动生成

没时间、没工具、没流程——文档永远是最后一项优先级。直到有人离职，或者你半年后回头看一个报表，完全想不起当初的逻辑。

这不是纪律问题，这是摩擦问题。手动写文档太耗时了。

但现在，故事变了。

Reza Rad 在最新视频中展示了一个组合方案：GitHub Copilot + Microsoft Fabric Skills，可以从自然语言提示出发，自动为你的 Power BI 报表和 Fabric 对象生成完整文档。

不需要外部工具，不需要写一行自定义代码。

直接看效果。

在 VS Code 的 GitHub Copilot 中，他连续运行了几个提示：

提示1：“列出我 Fabric 租户中所有空的 workspace。”

Copilot 借助 Fabric Skills 连接到 Fabric 租户，调用对应 REST API，分析结果后返回：28 个工作区中，有 3 个是空的。

不需要手动打开门户翻找，不需要查 API 文档。一句提示搞定。

提示2：“列出我所有 workspace 下的 Power BI 报表，按年月降序分类。”

这个更有意思。Copilot 需要扫描所有 workspace，发现标准 Fabric Items API 不返回创建日期，于是自动切换到 Power BI Scanner API（用于扫描 Power BI 服务的 admin API），生成脚本、执行、返回按年月分组的格式化结果。

提示3：“为我的每个报表生成一份文档，包含：报表名称、创建日期、数据集来源、行级安全设置、刷新状态。”

Copilot 遍历所有报表，提取元数据，调用多个 API，最终输出一份结构化的文档草稿。

整个过程不需要你手动打开任何一个 Power BI 界面。

Fabric Skills 是微软近期推出的能力，允许 Copilot 直接理解 Fabric 的语义模型和数据对象。GitHub Copilot 则提供代码生成和执行环境。

两者结合后，Copilot 可以：

•理解“我的 Fabric 租户”这个上下文

•自动选择合适的 REST API（如 Items API、Scanner API、Admin API）

•生成并执行脚本

•格式化输出结果

本质上，这是把文档生成从一个手动任务，变成了一个对话任务。

这个方案对国内 Power BI 用户同样有参考价值——尤其是那些在大型企业里做 BI 治理的团队。

很多团队用 Power BI 几年后，租户里攒了几百个报表，但文档几乎为零。想梳理一遍，发现连 API 调用都要查半天文档。

如果 Fabric Skills 和 Copilot 的组合能稳定落地，那文档缺失这个老大难问题，终于有了一个低成本的自动化解法。

当然，目前这个方案依赖 GitHub Copilot 和 Fabric 的云端能力，在国内网络环境下可能需要一些配置。但思路是对的：用 AI 降低文档的摩擦成本。