企业官网建设流程全解析

skills-for-fabric 是微软官方推出的Microsoft Fabric AI 技能合集：装好它，GitHub Copilot CLI、Claude Code、VS Code 等 AI 编程助手就能直接帮你创建笔记本、写 T-SQL、搭建奖牌架构（Medallion Architecture）和执行数据迁移。本教程带你 5 分钟完成安装，并用一句自然语言跑通第一个数据任务。

1️⃣ skills-for-fabric 是什么？先看懂"三层结构"

一句话理解：它把 Fabric 领域专家的"操作手册"打包成 AI 能读懂的指令文件。整个项目采用Agents → Skills → Common三层架构（详见 AGENTS.md）：

几个代表性技能（完整清单见 skills/ 目录）：

💡 技能提供的是"专业指导"，而 MCP 服务器提供"实时工具能力"（连接真实 API 和数据源），两者配合才完整。

2️⃣ 安装前的 3 个准备（约 2 分钟）

✅准备 1：一个 AI 编程工具GitHub Copilot CLI（官方推荐路径）、Claude Code、Cursor、Windsurf 或 VS Code 均可。

✅准备 2：已登录的 Azure CLIFabric 操作需要 Azure AD 认证，确保本机装有 Azure CLI 且已完成登录：

az login az account show --query tenantId --output tsv

✅准备 3：Fabric 租户与访问权限需要一个可访问的 Microsoft Fabric 租户，并对目标工作区拥有相应权限。

3️⃣ 5 分钟安装：任选一条路径（约 1 分钟）

方式一：GitHub Copilot CLI 插件市场（推荐 ⭐）

在 Copilot CLI 中依次执行两条命令，先添加市场，再安装主技能包：

/plugin marketplace add microsoft/skills-for-fabric /plugin install fabric-skills@fabric-collection

• fabric-skills：完整的 Fabric 技能合集（开发、消费、运维、迁移、端到端架构全覆盖）
• 如果主要做报表和语义模型，可改装独立打包的 Power BI 创作包：

/plugin install powerbi-authoring@fabric-collection

方式二：Claude Code 安装技能包

claude plugin marketplace add microsoft/skills-for-fabric claude plugin install fabric-skills@fabric-collection

安装后运行claude mcp list查看 MCP 连接状态，配置细节见 mcp-setup/README.md。

方式三：APM 单技能安装（只装你需要的）

插件包是整体安装的；如果只想激活某一个技能，可以用 APM（Agent Package Manager）：

pip install apm-cli apm install microsoft/skills-for-fabric --skill sqldw-cli --target copilot

常用参数：

方式四：克隆仓库，让 AI 工具自动识别

仓库根目录自带各工具的配置文件（CLAUDE.md、AGENTS.md、.cursorrules、.windsurfrules、GEMINI.md），克隆后克隆目录即"开箱即懂"：

git clone https://gitcode.com/gh_mirrors/sk/skills-for-fabric

4️⃣ 两步完成 Fabric 认证（约 1 分钟）

多数 Fabric 操作依赖 Azure 令牌。若尚未登录，执行：

az login az account get-access-token --resource https://api.fabric.microsoft.com

⚠️ 不同工作负载可能需要不同资源端点的令牌（如 SQL 连接用https://database.windows.net）。已安装的技能会根据具体任务给出对应命令和 API 模式，无需死记。

5️⃣ 跑通第一个数据任务（约 1 分钟）

打开 Copilot CLI（或你的 AI 工具），在项目文件夹中直接用自然语言提需求。最轻量的入门任务——文档化一个工作区：

Document my Fabric Workspace called FabricCLIDemo.

想挑战更完整的场景？试试为 NYC 出租车数据设计奖牌架构：

Use Microsoft Fabric skills to design a medallion architecture for NYC taxi data.

更多可直接抄作业的示例提示词都在 prompt_examples/ 目录里：

• 📄 NYCTaxi_MedallionArchitecture.txt —— 从原始数据到 Power BI 语义模型的完整奖牌架构
• 📄 Variables.txt —— 用 Variable Library 参数化 Lakehouse 引用
• 📄 EstimateFabricCost.txt —— 成本估算
• 📄 RealtimeTaxiEventstream.txt —— 实时事件流

看到 AI 自动帮你规划工作区、解析 ID、按规范生成命令了吗？这就是技能包的价值。

6️⃣ 更新插件与常见问题

更新已安装的技能包

/plugin update fabric-skills@fabric-collection # 或在终端一次性更新全部 copilot plugin update --all

也可以开启自动更新：在~/.copilot/settings.json的fabric-collection条目中加上"autoUpdate": true；Claude Code 则在/plugin→ Marketplaces →fabric-collection→Enable auto-update中开启一次即可。

常见疑问 💬

Q：安装成功了，但 MCP 没连上？A：claude mcp list或 Claude 内/mcp查看各服务器状态；确认 Azure CLI 与客户端在同一环境（WSL/容器中不会自动共享 Windows 登录态）。排错清单见 mcp-setup/README.md。

Q：APM 装完 Copilot CLI 用不上 MCP？A：Copilot 目标需要-g全局作用域，否则 MCP 配置到不了 CLI；apm_modules/目录会写入.gitignore，请保留它。

Q：技能之间会不会"串台"？A：不会。每个技能内置明确的路由规则（如 KQL 物化视图归eventhouse-cli，Spark 归spark-cli），AI 会先选定模式再动手。

Q：想看版本变化？A：查看 CHANGELOG.md，打包信息见 apm.yml。

7️⃣ 关键资料索引

🎉 到这里，你已经掌握了 skills-for-fabric 的完整上手路径：选型 → 安装 → 认证 → 用一句话下数据任务。下一步，挑一个 prompt_examples/ 里的场景，让 AI 技能包替你干活吧。