1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | dataflows-authoring-cli |
| 作者/维护者 | Microsoft（skills-for-fabric 官方仓库） |
| 来源链接 | https://github.com/microsoft/skills-for-fabric/tree/main/skills/dataflows-authoring-cli |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 881（合集仓库整体数字，来自 GitHub API；不代表本技能个体热度，见第 6 章说明） |
| Forks | 240（数据来自 GitHub API） |
| 最新版本 | v0.3.9（2026-07-23，数据来自 GitHub 提交记录） |
| 安装方式 | GitHub Copilot CLI / Claude Code 插件市场，或手动复制技能目录 |
2. 功能介绍与亮点
dataflows-authoring-cli 是微软官方 Fabric Skills 家族中负责 Dataflow Gen2（Fabric 平台的可视化/低代码数据转换管道）写侧操作的技能，通过 az CLI 直接调用 Fabric REST API：
- 创建、修改、删除 Dataflow Gen2，构建
mashup.pq（Power Query M 代码）与queryMetadata.json，覆盖源连接、合并转换、查询定义的完整编写流程； - 管理数据源连接绑定（含 Web/云连接与本地网关两类凭据形态），配置输出目的地（Lakehouse Table/Files、Warehouse、ADX、Azure SQL）；
- 触发并轮询刷新任务（含长时异步操作的 Location 轮询模式）。
主要亮点：
- 预览驱动的编写循环：修改持久化前，技能会用
executeQuery单独预览候选 M 代码是否评估成功，并在首次物化（刷新）前主动提议向用户展示 ASCII 图表预览，而非直接写入未经验证的转换逻辑； - 前置意图确认门：遇到“帮我搭个报表用的 Dataflow”这类模糊请求时，技能会要求先明确数据源、转换逻辑、输出与刷新行为，禁止凭空猜测创建；
- 文档完整：除主文档外另配 7 篇专题参考（连接管理、M 语言语义、预览契约、输出目的地模式等）与故障排查对照表，含可运行的 bash/PowerShell 双语言示例；
- 近期维护活跃，子目录级提交历史显示 8 次更新（最近一次 2026-07-23），是仓库内数据转换类技能中提交频率较高的一个。
3. 适用场景
固定分类：数据分析与可视化
面向已采用 Microsoft Fabric 平台的数据工程师、ETL/数据集成开发者，尤其适合需要 agent 协助快速搭建或维护 Dataflow Gen2 转换管道（连接数据源、编写合并/清洗逻辑、绑定输出目的地），但不想在 Power Query 编辑器里逐步手工试错的场景。使用者需具备一定 Power Query M 语言与 Fabric REST API 基础，以审核 agent 生成的转换逻辑与连接配置。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 仓库根目录含 .claude-plugin/marketplace.json 插件市场清单与根级 CLAUDE.md，可通过插件市场命令安装，也可手动复制技能目录使用 |
| Codex | 需适配 | 仓库根目录提供 AGENTS.md 供 Codex/Jules/OpenCode 自动读取，但未见针对 Codex 的专属安装流程说明 |
| OpenClaw | 未验证 | 抓取材料未提及 |
| Hermes Agent | 未验证 | 抓取材料未提及 |
5. 推荐理由
在 Fabric Dataflow Gen2 这一原本高度依赖手工试错的可视化转换搭建场景中，dataflows-authoring-cli 用一套带预览确认、意图前置校验与故障排查支持的标准流程，把“连接数据源→编写转换→绑定输出→刷新验证”收敛为可审核的 agent 工作流；与依赖外部 MCP Server 的同仓库姊妹技能不同，它纯用 az/curl/jq 等标准 CLI 工具实现，无额外服务依赖，安装与故障排查路径更短。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 合集仓库整体 stars 不计入本技能个体；独立第三方——Microsoft Regional Director / Data Platform MVP Reza Rad 在个人技术博客 RADACAD 专文介绍该技能的免代码建管能力，仓库 issue 区亦有多位具名外部用户长期互动，但未见针对本技能的多来源独立讨论 |
| 可用性 | 7 | 文档与故障排查表完整、近期维护活跃（8 次提交，最近一次 2026-07-23）、无 MCP Server 外部依赖；但 Dataflow Gen2 需 Fabric Pro/PPU 许可或限时试用容量，个人开发者无法长期免费使用 |
| 安全性 | 8 | 写操作范围明确（限于 Dataflow 资源本身）且有主动止损设计；凭据走 Azure CLI 标准 OAuth 流程，并显式建议敏感凭据用 Key Vault 引用而非明文；License 清晰、官方维护、无可疑指令 |
安全检查清单：
① Shell/权限：通过 az/curl/jq/base64/uuidgen 等标准 CLI 工具调用 Fabric REST API，含创建/修改/删除/触发刷新等写操作，范围限定在用户自身 Fabric 工作区内的 Dataflow 资源；
② 联网：是，调用官方 Fabric 与 Power BI v2 API 端点，目标透明；
③ 凭据：走 az login 标准 OAuth 令牌流程，技能文档明确建议敏感连接凭据使用 Key Vault 引用（passwordReference/keyReference 等）而非明文写入脚本；
④ 可疑指令：未发现，文档反而多处主动限制（如禁止在无用户确认前物化转换、禁止对生产量级数据做无边界预览）；
⑤ 作者信誉：官方 Microsoft 仓库，具名员工维护，无刷星或自我造假迹象；
⑥ License：MIT，明确；
⑦ 最近维护：2026-07-23，活跃。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| dataflows-consumption-cli（同仓库姊妹技能） | Dataflow Gen2 的只读消费对应物——查询已保存转换的执行结果、刷新历史与状态，遇到写请求会主动拒绝并转交本技能 | 两者是官方按读写职责拆分的一对技能；本技能专注创建/修改，消费技能专注监控与只读查询，互不重叠 |
| using-dbt-for-analytics-engineering（dbt Labs 官方出品） | 代码优先（SQL + ref()/source()）的转换建模技能，围绕 Git 版本控制、dbt show 校验与破坏性变更评估设计 |
dbt 面向已采用 dbt 项目结构的团队，转换逻辑以可复用 SQL 文件沉淀并接受 CI 测试；本技能走 Fabric 平台原生的低代码 M 语言路线，无需搭建独立 dbt 项目即可在现有 Fabric 工作区内直接编写转换，两者面向不同技术栈与团队成熟度 |
8. 用户评价
- Microsoft Regional Director / Data Platform MVP Reza Rad 在个人技术博客 RADACAD（2026-07-10 发文）中专门介绍了该技能的免代码 Dataflow Gen2 创建能力，包括自动识别表间合并列、生成转换步骤 M 代码、按财年配置创建日期表等场景，并强调应优先使用官方发布的技能而非社区自建版本，理由是“由 Fabric 产品团队持续维护”。
- 该技能目前在其他第三方平台尚无具名用户评价。
9. 其他补充
技能内置每 7 天一次的版本自检机制（check-updates），仅读取仓库主分支的版本号与更新日志用于提示，不会自动执行远端代码。
10. 安装使用方式
- GitHub Copilot CLI：
/plugin marketplace add microsoft/skills-for-fabric后执行/plugin install fabric-authoring@fabric-collection（该 bundle 同时包含其他 Fabric 写侧创作技能，如 Spark/Lakehouse、SQL DB/DW 等）； - Claude Code：可通过同一插件市场清单安装，或手动将仓库
skills/dataflows-authoring-cli/目录复制进本地技能目录； - 使用前需完成
az login并确认对目标 Fabric 工作区有相应写权限；首次在会话中使用时会自动触发一次版本检查。
11. 注意事项
- Dataflow Gen2 需要 Fabric Pro/PPU 许可、或处于限时的 Fabric 试用容量期内才能使用，个人开发者若试用期已过需付费许可才能继续使用；
- 技能本身不做只读查询与监控，遇到“查看刷新历史/执行已保存查询”等只读需求需改用姊妹技能 dataflows-consumption-cli；
- 涉及本地网关（On-Premises Gateway）连接的凭据需按网关成员做 RSA 加密处理，配置复杂度高于纯云端连接。