$ ~/registry/skill/microsoft-dataflows-save-as-authoring-cli

SKILL

dataflows-save-as-authoring-cli

Name: dataflows-save-as-authoring-cli
Author: microsoft

扫描并评估 Power BI Gen1 数据流，生成迁移快照并执行升级为 Gen2.1 副本。

星标

★ 821

来源

GitHub

更新于

2026-07-18

// 安全评估需留意

仅提示词，不执行代码
开源可审计
社区验证· 420

总评

该技能材料显示其为开源的提示型/文档型 Skill，本身未声明内置密钥或固定远程端点，来源为微软 GitHub 且有一定社区采用度，整体偏低风险。需注意其面向 Fabric/Power BI 管理与迁移场景，文档会引导调用 CLI 和 REST API、扫描工作区/租户并生成快照，因此实际使用时涉及账号权限、潜在数据枚举与外发到微软官方服务的常规风险。

凭证密钥需留意

材料未要求专用 API 密钥或环境变量，但 README 明确提到需通过 `az login`/令牌获取来访问 Fabric 与 Power BI REST API。凭证主要是 Azure/Microsoft 账户令牌，敏感性较高；若在高权限租户上下文中使用，可能被用于枚举或执行 SaveAs 操作，但这属于其声明功能范围内的常规凭证风险。

网络外发需留意

元数据未声明固定远程 host，但描述中明确会通过 `az rest`/`curl` 调用 Power BI REST 与 Fabric REST API，并可能执行工作区或整个租户扫描、生成快照、调用 SaveAsNativeArtifact。数据外发目标与功能相关，推定为微软官方服务，未见无关或不明端点红旗；但实际会把工作区/数据流元数据发送到云端接口。

代码执行需留意

该 Skill 不是纯静态说明，它会指导使用 CLI 命令（如 `az rest`、`curl`）并在会话开始时建议执行更新检查，因此具备触发本机命令执行的常规能力。未见要求超出其用途的系统权限，也未见明显恶意命令，但本机执行外部命令本身应谨慎。

数据访问需留意

描述表明其可扫描工作区或整个租户中的 Gen1 dataflow，评估依赖与风险信号，并输出 Markdown/JSON 快照；这意味着会访问并处理 Fabric/Power BI 元数据，且可能在本地写出报告文件。访问范围与迁移评估功能基本一致，未见明显过度授权表述，但“整个租户扫描”意味着数据可见范围可能较广，应按最小权限使用。

来源供应链低风险

来源为 GitHub 上的微软开源仓库，且系统已标记 open-source、prompt-only，并有约 420 star 的社区采用度，这些都是降低风险的正面证据。许可证与维护状态在材料中未明确，README 中的“先做更新检查”更像操作指引而非直接供应链红旗；基于现有事实，供应链维度整体偏低风险。

安全建议

仅在最小必要权限的 Azure/Fabric 账号下使用，避免默认以租户级管理员上下文执行扫描或 SaveAs。
在执行 `az rest`/`curl` 前审阅将访问的 API、资源范围与输出位置，确认不会收集或落盘超出需要的元数据。
若需生成 Markdown/JSON 快照，建议保存到受控目录并按敏感配置管理其中的工作区、项目与依赖信息。
优先固定仓库版本/提交并人工审阅更新内容，不要仅依据 README 的更新提示自动信任远端变化。

审计模型: gpt-5.4 · 2026-06-17

// 安装

复制安装指令，让 AI 自动完成配置 · 推荐新手

请帮我安装 askskill 上的 "dataflows-save-as-authoring-cli" 技能：
1. 下载 https://raw.githubusercontent.com/microsoft/skills-for-fabric/main/skills/dataflows-save-as-authoring-cli/SKILL.md
2. 保存为 ~/.claude/skills/dataflows-save-as-authoring-cli/SKILL.md
3. 装好后重载技能，告诉我可以用了

// 下载

下载 SKILL.md机读安装清单 ↗

// 用法示例

扫描工作区中的 Gen1 数据流

输入

请扫描指定 Power BI 工作区中的所有 Gen1 数据流，列出名称、所属工作区、所有者和可执行 save-as 的候选对象，并输出摘要表。

预期产出

返回工作区内 Gen1 数据流清单，并标记适合继续做 save-as 评估的对象。

评估迁移就绪度与风险

输入

请对这个租户的 Gen1 数据流执行 save-as readiness assessment，检查七类风险信号，并生成 Save-As Readiness Snapshot，包含 markdown 报告和 JSON 结果。

预期产出

输出每个数据流的就绪度结论、风险项明细，以及可用于审批或排期的快照报告。

执行升级并验证结果

输入

请将目标 Gen1 数据流通过 SaveAsNativeArtifact API 创建为 Gen2.1 副本，随后检查数据完整性，并识别是否仍存在残留的 Gen1 引用。

预期产出

返回升级执行结果、生成的新副本信息、验证结论，以及需要后续处理的残留依赖。

// 文档

Update Check — ONCE PER SESSION (mandatory) The first time this skill is used in a session, run the check-updates skill before proceeding.

GitHub Copilot CLI / VS Code: invoke the check-updates skill.

Claude Code / Cowork / Cursor / Windsurf / Codex: compare local vs remote package.json version.

Skip if the check was already performed earlier in this session.

CRITICAL NOTES

To find the workspace details (including its ID) from workspace name: list all workspaces and, then, use JMESPath filtering

To find the item details (including its ID) from workspace ID, item type, and item name: list all items of that type in that workspace and, then, use JMESPath filtering

dataflows-save-as-authoring-cli — Dataflow Save-As Gen1 → Gen2.1 CI/CD via CLI

A save-as companion for creating upgraded Gen2.1 copies from Power BI Gen1 dataflows using readiness assessment and guarded execution.

We currently cannot perform an in-place migration of your dataflow. We can use save-as to create an upgraded Gen2.1 copy while preserving the original Gen1 dataflow.

Task	Reference	Notes
Finding Workspaces and Items in Fabric	COMMON-CLI.md § Finding Workspaces and Items	Mandatory — READ link first
Fabric Topology & Key Concepts	COMMON-CORE.md § Fabric Topology
Environment URLs	COMMON-CORE.md § Environment URLs
Authentication & Token Acquisition	COMMON-CORE.md § Authentication	Wrong audience = 401
Core Control-Plane REST APIs	COMMON-CORE.md § Core REST APIs	Pagination, LRO polling, rate limits
Tool Selection Rationale	COMMON-CLI.md § Tool Selection
Authentication Recipes	COMMON-CLI.md § Auth Recipes	`az login` flows and token acquisition
Fabric Control-Plane API via `az rest`	COMMON-CLI.md § az rest	Always pass `--resource`
Gotchas & Troubleshooting (CLI)	COMMON-CLI.md § Gotchas	`az rest` audience, shell escaping
Quick Reference	COMMON-CLI.md § Quick Ref	Token audience / tool matrix
Dataflow Definition Structure	DATAFLOWS-AUTHORING-CORE.md § Definition	3-part format for Gen2 CI/CD
Consumption Capability Matrix	DATAFLOWS-CONSUMPTION-CORE.md § Capabilities	Read-only discovery patterns
Upgrade CLI Quick Reference	upgrade-cli-quickref.md	All `az rest` one-liners for scanning & save-as
Risk Assessment Guide	risk-assessment-guide.md	Risk signal detection logic & API calls

Tool Stack

Tool	Role	Install
`az` CLI	Primary: Auth (`az login`), REST API calls (`az rest`) against both Fabric and Power BI APIs.	Pre-installed in most dev environments
`jq`	Parse and filter JSON responses (dataflow lists, risk signal extraction).	Pre-installed or trivial
`base64`	Decode dataflow definitions for inspection.	Built into bash / `[Convert]::ToBase64String()` in PowerShell

Agent check — verify before first operation:

az --version 2>/dev/null || echo "INSTALL: https://aka.ms/install-azure-cli"
jq --version 2>/dev/null || echo "INSTALL: apt-get install jq OR brew install jq"

…

查看完整文档 ↗

帮助你将 Power Automate 云端流程接入 Power Pages 站点并生成调用代码

microsoft装→

MCP 工具

GenFilesMCP

用自然语言生成办公文档与表格演示，并为 Word 文档提供 AI 审阅意见。

—装→

技能

★821

semantic-model-consumption

用于执行 DAX 查询并检查 Fabric Power BI 语义模型元数据。

microsoft装→

MCP 工具

powerbi-ai-mcp

通过自然语言操控 Power BI，快速生成度量、解释指标并优化数据模型。

—装→

$ loading_

请帮我安装 askskill 上的 "dataflows-save-as-authoring-cli" 技能： 1. 下载 https://raw.githubusercontent.com/microsoft/skills-for-fabric/main/skills/dataflows-save-as-authoring-cli/SKILL.md 2. 保存为 ~/.claude/skills/dataflows-save-as-authoring-cli/SKILL.md 3. 装好后重载技能，告诉我可以用了

// 用法示例

扫描工作区中的 Gen1 数据流

输入

请扫描指定 Power BI 工作区中的所有 Gen1 数据流，列出名称、所属工作区、所有者和可执行 save-as 的候选对象，并输出摘要表。

预期产出

返回工作区内 Gen1 数据流清单，并标记适合继续做 save-as 评估的对象。

评估迁移就绪度与风险

输入

请对这个租户的 Gen1 数据流执行 save-as readiness assessment，检查七类风险信号，并生成 Save-As Readiness Snapshot，包含 markdown 报告和 JSON 结果。

预期产出

输出每个数据流的就绪度结论、风险项明细，以及可用于审批或排期的快照报告。

执行升级并验证结果

输入

请将目标 Gen1 数据流通过 SaveAsNativeArtifact API 创建为 Gen2.1 副本，随后检查数据完整性，并识别是否仍存在残留的 Gen1 引用。

预期产出

返回升级执行结果、生成的新副本信息、验证结论，以及需要后续处理的残留依赖。

// 文档

Update Check — ONCE PER SESSION (mandatory) The first time this skill is used in a session, run the check-updates skill before proceeding.

GitHub Copilot CLI / VS Code: invoke the check-updates skill.

Claude Code / Cowork / Cursor / Windsurf / Codex: compare local vs remote package.json version.

Skip if the check was already performed earlier in this session.

CRITICAL NOTES

To find the workspace details (including its ID) from workspace name: list all workspaces and, then, use JMESPath filtering

To find the item details (including its ID) from workspace ID, item type, and item name: list all items of that type in that workspace and, then, use JMESPath filtering

dataflows-save-as-authoring-cli — Dataflow Save-As Gen1 → Gen2.1 CI/CD via CLI

A save-as companion for creating upgraded Gen2.1 copies from Power BI Gen1 dataflows using readiness assessment and guarded execution.

We currently cannot perform an in-place migration of your dataflow. We can use save-as to create an upgraded Gen2.1 copy while preserving the original Gen1 dataflow.

Task	Reference	Notes
Finding Workspaces and Items in Fabric	COMMON-CLI.md § Finding Workspaces and Items	Mandatory — READ link first
Fabric Topology & Key Concepts	COMMON-CORE.md § Fabric Topology
Environment URLs	COMMON-CORE.md § Environment URLs
Authentication & Token Acquisition	COMMON-CORE.md § Authentication	Wrong audience = 401
Core Control-Plane REST APIs	COMMON-CORE.md § Core REST APIs	Pagination, LRO polling, rate limits
Tool Selection Rationale	COMMON-CLI.md § Tool Selection
Authentication Recipes	COMMON-CLI.md § Auth Recipes	`az login` flows and token acquisition
Fabric Control-Plane API via `az rest`	COMMON-CLI.md § az rest	Always pass `--resource`
Gotchas & Troubleshooting (CLI)	COMMON-CLI.md § Gotchas	`az rest` audience, shell escaping
Quick Reference	COMMON-CLI.md § Quick Ref	Token audience / tool matrix
Dataflow Definition Structure	DATAFLOWS-AUTHORING-CORE.md § Definition	3-part format for Gen2 CI/CD
Consumption Capability Matrix	DATAFLOWS-CONSUMPTION-CORE.md § Capabilities	Read-only discovery patterns
Upgrade CLI Quick Reference	upgrade-cli-quickref.md	All `az rest` one-liners for scanning & save-as
Risk Assessment Guide	risk-assessment-guide.md	Risk signal detection logic & API calls

Tool Stack

Tool	Role	Install
`az` CLI	Primary: Auth (`az login`), REST API calls (`az rest`) against both Fabric and Power BI APIs.	Pre-installed in most dev environments
`jq`	Parse and filter JSON responses (dataflow lists, risk signal extraction).	Pre-installed or trivial
`base64`	Decode dataflow definitions for inspection.	Built into bash / `[Convert]::ToBase64String()` in PowerShell

Agent check — verify before first operation:

az --version 2>/dev/null || echo "INSTALL: https://aka.ms/install-azure-cli"
jq --version 2>/dev/null || echo "INSTALL: apt-get install jq OR brew install jq"

…

查看完整文档 ↗

dataflows-save-as-authoring-cli

// 用法示例

// 文档

dataflows-save-as-authoring-cli — Dataflow Save-As Gen1 → Gen2.1 CI/CD via CLI

Table of Contents

Tool Stack

// 同源资产

eventhouse-consumption-cli

eventstream-consumption-cli

fabriciq

sqldw-consumption-cli

synapse-migration

activator-authoring-cli

// 功能相似

dataflows-authoring-cli

dataflows-consumption-cli

add-cloud-flow

GenFilesMCP

semantic-model-consumption

powerbi-ai-mcp

dataflows-save-as-authoring-cli

// 用法示例

// 文档

dataflows-save-as-authoring-cli — Dataflow Save-As Gen1 → Gen2.1 CI/CD via CLI

Table of Contents

Tool Stack

// 同源资产

eventhouse-consumption-cli

eventstream-consumption-cli

fabriciq

sqldw-consumption-cli

synapse-migration

activator-authoring-cli

// 功能相似

dataflows-authoring-cli

dataflows-consumption-cli

add-cloud-flow

GenFilesMCP

semantic-model-consumption

powerbi-ai-mcp