1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | semantic-model-authoring |
| 作者/维护者 | Microsoft（skills-for-fabric 官方仓库） |
| 来源链接 | https://github.com/microsoft/skills-for-fabric/tree/main/skills/semantic-model-authoring |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 881（合集仓库整体数字，来自 GitHub API；不代表本技能个体热度，见第 6 章说明） |
| Forks | 239（数据来自 GitHub API） |
| 最新版本 | v0.3.9（2026-07-23，数据来自 GitHub 提交记录） |
| 安装方式 | GitHub Copilot CLI / Claude Code 插件市场，或手动复制技能目录 |
2. 功能介绍与亮点
semantic-model-authoring 是微软官方 Fabric Skills 家族中专门负责 Power BI 语义模型建模的技能，覆盖建模全生命周期：
- 跨三种载体创建/编辑模型——Power BI Desktop、PBIP 项目文件、Fabric 工作区，支持 Import、DirectQuery、Direct Lake 三种存储模式；
- 表/列/关系/度量的增删改，含 DAX 编写与专门的性能优化决策框架；
- 面向 Fabric Copilot 与 Power BI Data Agent 的“AI 就绪度”检查与修复；
- 模型部署、刷新、数据源与权限配置、连接绑定，以及导出为 PBIP 项目结构。
主要亮点：
- 双层工具路由：优先使用官方 Power BI Modeling MCP Server 进行实时读写，未注册 MCP 时自动降级为 TMDL 文件直接编辑或 Fabric REST API 往返，两条路径均有完整文档；
- 主动护栏：显式拒绝执行 RLS/OLS 安全角色变更等越权请求；数据源缺失或凭据报错时要求停止并转交用户处理，不臆测重试；
- 官方产品文档背书：微软为其单独建立了 Microsoft Learn 产品页面，含分步教程与故障排查表；
- 每次修改后强制执行校验清单（结构完整性检查 + DAX 查询回归测试）。
3. 适用场景
固定分类：数据分析与可视化
面向已经或准备使用 Power BI / Microsoft Fabric 的数据分析师与 BI 开发者，尤其是采用 PBIP 版本控制工作流、或需要在 Fabric 工作区批量维护语义模型的团队；用户需具备一定 Power BI 建模/DAX 基础，以审核 agent 的建模决策与 DAX 输出。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 仓库根目录含 .claude-plugin/marketplace.json 插件市场清单与根级 CLAUDE.md，可通过插件市场命令安装，也可手动复制技能目录使用 |
| Codex | 需适配 | 仓库根目录提供 AGENTS.md 供 Codex/Jules/OpenCode 自动读取，但未见针对 Codex 的专属安装流程说明 |
| OpenClaw | 未验证 | 抓取材料未提及 |
| Hermes Agent | 未验证 | 抓取材料未提及 |
5. 推荐理由
在 Power BI/Fabric 语义建模这一专业且高频的数据分析场景中，semantic-model-authoring 提供了该细分领域内文档最完整、护栏设计最主动的官方 agent 技能——它把“连接模型→设计星型架构→编写 DAX→校验→部署”这条原本需要人工在多个工具间切换的流程，收敛成一套带主动止损机制的标准工作流，尤其适合正在把 Power BI 开发迁入版本控制与 agent 协作模式的团队。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 合集仓库整体 stars 不计入本技能；官方为其单独建立 Microsoft Learn 产品文档页，且 GitHub issue 中有多位具名外部用户（Lwhieldon、gdfidpt 等）就本技能相关问题持续互动 |
| 可用性 | 7 | 官方文档与故障排查表详尽，支持免 MCP 的降级路径，但功能当前标注 Preview，且存在一个已知未修复的打包缺陷（配套只读技能未随插件一起安装，需人工绕行） |
| 安全性 | 8 | 权限用途均有说明、无隐蔽指令、License 明确、维护活跃；对越权操作与凭据错误有主动止损设计，MIT 开源可审计 |
安全检查清单：
① Shell/权限：通过 az CLI 与可选 MCP Server 操作 Fabric REST API，写操作范围限定在语义模型资源；
② 联网：是，调用 Fabric/Power BI API 及版本检查（仅读取版本号，不执行远端代码）；
③ 凭据：走 Azure CLI 标准 OAuth 令牌流程，非技能自行存储明文凭据；
④ 可疑指令：未发现，且文档显式列出“拒绝越权操作”清单；
⑤ 作者信誉：官方 Microsoft 仓库，具名员工维护；
⑥ License：MIT，明确；
⑦ 最近维护：2026-07-23，活跃。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| power-bi-agentic-development（社区维护） | 覆盖语义建模、DAX/Power Query、TMDL/PBIR、Tabular Editor 自动化、报表可视化、Fabric 租户治理的全流程技能市场，按周迭代 | 覆盖面更广，并用确定性 Hooks 做规则式校验，但非官方出品，无 Power BI Desktop 实时截图验证闭环 |
| Power BI Modeling MCP Server（微软官方，本技能的底层依赖） | 单纯的 MCP 协议服务器，提供语义模型读写工具调用能力 | 只是工具层，不含建模方法论、故障排查与安全护栏；semantic-model-authoring 是在同一 MCP 之上封装的完整工作流与安全边界 |
8. 用户评价
- 独立从业者 Shai Karmani（个人技术博客 Data Ninja AI Lab）撰文讨论了将 semantic-model-authoring 与报表创作技能配合使用的实践方式，认为 agent 技能与 Power BI 开发者习惯的文件/Git/Desktop/Fabric 工作流高度契合，能承担重复性搭建工作、把开发者精力留给模型质量与业务逻辑，建议从单个 PBIP 报告的小范围试点开始验证实际节省的时间。
- GitHub issue 讨论区中，外部用户 Lwhieldon 与 gdfidpt 各自报告了配套只读技能未被正确打包进插件的问题，微软维护者 Avi Sander 已确认跟进，截至最近一次更新仍在处理中。
9. 其他补充
技能内置每 7 天一次的版本自检机制（check-updates），仅读取仓库主分支的版本号与更新日志用于提示，不会自动执行远端代码。
10. 安装使用方式
- GitHub Copilot CLI：
/plugin marketplace add microsoft/skills-for-fabric后执行/plugin install powerbi-authoring@fabric-collection（该 bundle 同时包含 Power BI 报告相关技能）； - Claude Code：可通过同一插件市场清单安装，或手动将仓库
skills/semantic-model-authoring/目录复制进本地技能目录； - 可选增强：注册官方 Power BI Modeling MCP Server（
npx -y @microsoft/powerbi-modeling-mcp@latest --start）以获得实时读写能力，未注册时自动降级为 TMDL 文件编辑； - 使用前需完成
az login并确认对目标 Fabric 工作区有 Contributor 及以上权限；首次在会话中使用时会自动触发一次版本检查。
11. 注意事项
- 该技能目前处于官方标注的 Preview 阶段，功能与文档仍可能变化；
- 已知一个尚未修复的打包缺陷：配套的只读验证技能未包含在默认安装的插件包内，遇到只读 DAX 校验场景需手动改用 MCP 直接查询；
- 不处理报表视觉布局与 RLS/OLS 安全角色成员管理，如需这两类能力需转向其他专门技能或 Power BI 门户；
- 依赖 Azure 身份认证与 Fabric/Power BI 订阅，个人免费账户可能无法覆盖全部工作区级功能。