$ ~/registry/skill/microsoft-activator-authoring-cli

SKILL

activator-authoring-cli

Name: activator-authoring-cli
Author: microsoft

帮助你在 Fabric 中创建告警、通知与事件自动化处置流程。

星标

★ 821

来源

GitHub

更新于

2026-07-18

// 安全评估需留意

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

总评

该技能材料显示其主要是面向 Fabric/CLI 的提示与操作指南，且来源为微软 GitHub 开源仓库并有一定社区采用，整体风险偏低。基于现有材料，它更接近提示型技能，但文档中包含远程版本检查与调用外部 CLI/API 的指引，使用时仍需留意环境与实际执行边界。

凭证密钥低风险

材料声明无需预置密钥或环境变量；虽 README 提到可复用 `az login`/令牌获取指导，但未显示该技能自身要求用户提供独立第三方凭证，凭证暴露面较低。

网络外发需留意

系统检查项标记为无远程端点，但 README 明确包含远程更新检查建议（如 GitHub API 或 `git fetch origin main`），描述中还涉及通过 Fabric REST API/`az rest` 与声明用途相关的云端服务交互；这属于该类技能的常规联网能力，需确认不会向无关端点发送数据。

代码执行需留意

作为技能文档，其本体更接近提示型内容；但 README 指引会调用本机 CLI 命令（如 `git fetch`、`git show`、`az rest`），因此一旦宿主按指引执行，即具备常规本地命令执行能力。未见申请与声明功能明显不相称的系统权限。

数据访问需留意

文档要求读取本地 `package.json` 进行版本比较，并围绕 Fabric 工作区、项目与告警定义进行查询/修改；这意味着会访问本地少量文件及用户在 Fabric 中的相关资源。根据材料，访问范围与其声明功能基本一致，未见明显过度授权迹象。

来源供应链低风险

来源为微软 GitHub 开源仓库，系统标记 open-source，且有约 420 star，具备一定可审计性与社区信任度，这些都是降低风险的正面因素。需注意许可证未声明、维护状态未知，但仅凭这些不足以升为高风险。

安全建议

若在受控环境中使用，限制该技能实际可执行的 CLI 命令范围，并对 `git fetch`、`az rest` 等联网调用做审计。
执行前核实其更新检查与 API 调用仅访问 GitHub/Microsoft Fabric 等预期端点。
如需使用 Fabric 身份认证，优先采用最小权限账户，并避免在日志中暴露访问令牌。
在正式启用前，审阅仓库源码与 README 提到的公共文档，确认其行为与组织策略一致。

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

// 安装

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

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

// 下载

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

// 用法示例

创建阈值告警

输入

帮我在 Microsoft Fabric 中创建一个 Activator 告警：当 Eventhouse 里的订单失败率在 5 分钟内超过 3% 时，向 Teams 频道发送提醒，并附上失败率、时间窗口和数据源名称。请给出所需配置步骤和可执行命令。

预期产出

返回告警设计方案、触发条件、动作配置，以及通过 REST API 或 az rest 执行的命令示例。

更新现有通知规则

输入

请帮我修改现有的 Fabric Reflex 规则：把库存低于 20 的邮件通知阈值改为低于 50，并增加一个动作，在触发时同时运行指定的 Fabric pipeline。请说明需要更新的字段和命令。

预期产出

返回规则更新说明、修改后的条件与动作定义，以及更新该规则的接口调用示例。

排查告警未触发

输入

我的 Fabric Activator 告警没有按预期触发。请帮我排查：检查事件源连接、筛选条件、阈值设置、通知动作和相关配置是否有问题，并给出修复建议与验证步骤。

预期产出

返回分步骤排查清单、可能原因、修复命令或配置建议，以及验证告警恢复正常的方法。

// 文档

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 (e.g., /fabric-skills:check-updates).

Claude Code / Cowork / Cursor / Windsurf / Codex: read the local package.json version, then compare it against the remote version via git fetch origin main --quiet && git show origin/main:package.json (or the GitHub API). If the remote version is newer, show the changelog and update instructions.

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

activator-authoring-cli — Activator Item & Rule Authoring via CLI

Task	Reference	Notes
Finding Workspaces and Items in Fabric	COMMON-CLI.md § Finding Workspaces and Items in Fabric	Mandatory — READ link first [needed for workspace/item ID resolution]
Authentication & Token Acquisition	COMMON-CORE.md § Authentication & Token Acquisition	Wrong audience = 401
Authentication Recipes	COMMON-CLI.md § Authentication Recipes	Use the shared `az login` / token guidance from common docs
Core Control-Plane REST APIs	COMMON-CORE.md § Core Control-Plane REST APIs	List Workspaces, List Items, Item Creation
Long-Running Operations (LRO)	COMMON-CORE.md § Long-Running Operations (LRO)	Create, getDefinition, updateDefinition may return 202
Fabric Item Definitions	ITEM-DEFINITIONS-CORE.md § Definition Envelope	Base64-encoded parts structure
Fabric Control-Plane API via `az rest`	COMMON-CLI.md § Fabric Control-Plane API via az rest	Always pass `--resource https://api.fabric.microsoft.com`
LRO Pattern	COMMON-CLI.md § Long-Running Operations (LRO) Pattern	Poll 202 responses
Entity Types, Sources & Views	source-types.md	Entity envelope, source entities, and `timeSeriesView-v1` variants
Eventstream Source	eventstream-source.md	Push-source workflow: create Eventstream sink first, then extend the discovered Activator entities
KQL Source	kql-source.md	KQL source schema, time-axis support, design guidance
Digital Twin Builder / Ontology Source	dtb-source.md	DTB / ontology source schema, JSON-string query payloads, snapshot vs time-axis guidance
Real-time Hub Source	real-time-hub-source.md	Real-time Hub source schema, workspace event types
Rule Conditions	rule-conditions.md	Rule template structure, detection conditions, aggregation, time windows, occurrence options, enrichments
Action Types	action-types.md	TeamsMessage, EmailMessage, FabricItemInvocation action schemas

Tool Stack

Tool	Purpose
az CLI	Fabric authentication and REST API token acquisition
curl	Header-aware Fabric REST calls through the shared `fabric_lro` helper

…

查看完整文档 ↗

帮助你列出、解析并检查 Microsoft Fabric Eventstream 的拓扑与配置状态。

microsoft装→

MCP 工具

AgentPing

让 AI 通过邮件、Slack、Discord 或 Webhook 发送通知

—装→

技能

★10

skillify

将当前对话中的可复用流程整理并保存为可反复调用的技能文件

microsoft装→

技能

★23k

skill-creator

帮助用户创建或更新技能，扩展 Codex 的知识、流程与工具能力

OpenAI装→

$ loading_

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

// 用法示例

创建阈值告警

输入

帮我在 Microsoft Fabric 中创建一个 Activator 告警：当 Eventhouse 里的订单失败率在 5 分钟内超过 3% 时，向 Teams 频道发送提醒，并附上失败率、时间窗口和数据源名称。请给出所需配置步骤和可执行命令。

预期产出

返回告警设计方案、触发条件、动作配置，以及通过 REST API 或 az rest 执行的命令示例。

更新现有通知规则

输入

请帮我修改现有的 Fabric Reflex 规则：把库存低于 20 的邮件通知阈值改为低于 50，并增加一个动作，在触发时同时运行指定的 Fabric pipeline。请说明需要更新的字段和命令。

预期产出

返回规则更新说明、修改后的条件与动作定义，以及更新该规则的接口调用示例。

排查告警未触发

输入

我的 Fabric Activator 告警没有按预期触发。请帮我排查：检查事件源连接、筛选条件、阈值设置、通知动作和相关配置是否有问题，并给出修复建议与验证步骤。

预期产出

返回分步骤排查清单、可能原因、修复命令或配置建议，以及验证告警恢复正常的方法。

// 文档

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 (e.g., /fabric-skills:check-updates).

Claude Code / Cowork / Cursor / Windsurf / Codex: read the local package.json version, then compare it against the remote version via git fetch origin main --quiet && git show origin/main:package.json (or the GitHub API). If the remote version is newer, show the changelog and update instructions.

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

activator-authoring-cli — Activator Item & Rule Authoring via CLI

Task	Reference	Notes
Finding Workspaces and Items in Fabric	COMMON-CLI.md § Finding Workspaces and Items in Fabric	Mandatory — READ link first [needed for workspace/item ID resolution]
Authentication & Token Acquisition	COMMON-CORE.md § Authentication & Token Acquisition	Wrong audience = 401
Authentication Recipes	COMMON-CLI.md § Authentication Recipes	Use the shared `az login` / token guidance from common docs
Core Control-Plane REST APIs	COMMON-CORE.md § Core Control-Plane REST APIs	List Workspaces, List Items, Item Creation
Long-Running Operations (LRO)	COMMON-CORE.md § Long-Running Operations (LRO)	Create, getDefinition, updateDefinition may return 202
Fabric Item Definitions	ITEM-DEFINITIONS-CORE.md § Definition Envelope	Base64-encoded parts structure
Fabric Control-Plane API via `az rest`	COMMON-CLI.md § Fabric Control-Plane API via az rest	Always pass `--resource https://api.fabric.microsoft.com`
LRO Pattern	COMMON-CLI.md § Long-Running Operations (LRO) Pattern	Poll 202 responses
Entity Types, Sources & Views	source-types.md	Entity envelope, source entities, and `timeSeriesView-v1` variants
Eventstream Source	eventstream-source.md	Push-source workflow: create Eventstream sink first, then extend the discovered Activator entities
KQL Source	kql-source.md	KQL source schema, time-axis support, design guidance
Digital Twin Builder / Ontology Source	dtb-source.md	DTB / ontology source schema, JSON-string query payloads, snapshot vs time-axis guidance
Real-time Hub Source	real-time-hub-source.md	Real-time Hub source schema, workspace event types
Rule Conditions	rule-conditions.md	Rule template structure, detection conditions, aggregation, time windows, occurrence options, enrichments
Action Types	action-types.md	TeamsMessage, EmailMessage, FabricItemInvocation action schemas

Tool Stack

Tool	Purpose
az CLI	Fabric authentication and REST API token acquisition
curl	Header-aware Fabric REST calls through the shared `fabric_lro` helper

…

查看完整文档 ↗

activator-authoring-cli

// 用法示例

// 文档

activator-authoring-cli — Activator Item & Rule Authoring via CLI

Table of Contents

Tool Stack

// 同源资产

search-consumption-cli

semantic-model-authoring

spark-authoring-cli

spark-consumption-cli

sqldw-operations-cli

hdinsight-migration

// 功能相似

activator-consumption-cli

check-updates

eventstream-consumption-cli

AgentPing

skillify

skill-creator

activator-authoring-cli

// 用法示例

// 文档

activator-authoring-cli — Activator Item & Rule Authoring via CLI

Table of Contents

Tool Stack

// 同源资产

search-consumption-cli

semantic-model-authoring

spark-authoring-cli

spark-consumption-cli

sqldw-operations-cli

hdinsight-migration

// 功能相似

activator-consumption-cli

check-updates

eventstream-consumption-cli

AgentPing

skillify

skill-creator