1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | activator-authoring-cli（Microsoft Fabric Skills 合集子技能） |
| 作者/维护者 | Microsoft（skills-for-fabric 官方仓库） |
| 来源链接 | https://github.com/microsoft/skills-for-fabric/tree/main/skills/activator-authoring-cli |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 891（合集仓库整体数字，来自 GitHub API；不代表本技能个体热度，见第 6 章说明） |
| Forks | 243（数据来自 GitHub API） |
| 最新版本 | v0.3.9（2026-07-23，数据来自 GitHub 提交记录） |
| 安装方式 | GitHub Copilot CLI 插件市场 / npx skills add / 直接克隆仓库 |
2. 功能介绍与亮点
activator-authoring-cli 通过 Fabric REST API 与 az rest 命令，帮助用户创建和管理 Fabric Activator 的告警/Reflex 规则——不需要在 Fabric 门户里手动配置触发条件，直接描述“当满足什么条件时，触发什么动作”，技能负责把这段意图翻译成规范的 API 调用。
技能覆盖 Activator 规则的完整写侧生命周期：新建/删除 Activator 与 Reflex 条目，配置阈值、过滤条件与时间窗口，绑定 Teams 消息、邮件通知、Fabric 内其他条目调用（如触发一次 Pipeline 运行）等动作，并支持从 Eventhouse（KQL）、Eventstream、Real-Time Hub、Digital Twin Builder/Ontology 四类数据源接入触发信号。正文 347 行，附 7 篇独立参考文档（按数据源类型与规则条件/动作类型拆分），并给出一条明确的技术提醒：构造嵌套 JSON payload 必须用 Python 而非 PowerShell（后者的 ConvertTo-Json 会破坏嵌套字符串结构），这是实际踩坑后总结出的经验。技能明确区分自己与只读姊妹技能 activator-consumption-cli 的边界——纯查询/解释类请求应转交后者。
3. 适用场景
所属分类：数据分析与可视化
适合需要在 Microsoft Fabric 上为实时数据设置告警与自动化响应的数据工程师、平台团队与业务分析人员——典型场景包括：Eventhouse 中的 KQL 查询结果超过阈值时自动发 Teams 通知、Real-Time Hub 事件满足条件时触发下游 Pipeline、或对 Digital Twin Builder 建模的资产状态变化设置监控规则。不涉及实时数据触发响应、只需要静态报表或批处理告警的用户用不上这个技能。
4. 跨Agent兼容性
- Claude Code：原生支持。仓库根目录内置
CLAUDE.md，克隆后自动被 Claude Code 读取。 - Codex：原生支持。仓库根目录内置
AGENTS.md，Codex/Jules/OpenCode 会自动发现该文件。 - OpenClaw：未验证——未在仓库文档或发布说明中找到相关信息。
- Hermes Agent：未验证——同上。
主要安装路径是 GitHub Copilot CLI 的插件市场机制（/plugin install），是作者优先适配的客户端。
5. 推荐理由
Activator 规则的 JSON 定义涉及实体类型、数据源 envelope、条件聚合、动作绑定等多层嵌套结构，手写容易在 payload 格式上出错（技能文档特别指出 PowerShell 序列化会静默破坏嵌套 JSON 这一坑）。这个技能把四类数据源、规则条件与动作类型的配置差异，全部整理成可直接复用的结构化参考与工具链指引（az CLI + curl + jq + Python），能显著降低从“设想一条告警规则”到“规则真正生效”之间的调试成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方 Microsoft 出品；作为合集中的一个子技能，独立于合集之外暂未发现专属的第三方评测，仅被官方社区博客与第三方技能目录提及 |
| 可用性 | 8 | SKILL.md 结构完整（347 行）+ 7 篇独立参考文档全部可正常访问，2026-07-23 有实质性提交，是仓库近期改动中最新的子目录之一；需要 Fabric 平台访问权限与 az CLI 配置 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
① 无内置可执行脚本——内容全部是 Markdown 参考文档，指导用户调用官方 az CLI / Fabric REST API 完成操作，始终以用户自身 Azure 账号权限执行
② 不联网外发数据——技能本身不发起额外网络请求，仅调用文档中明确写出的 Fabric 官方 API 端点
③ 涉及 Azure AD Token，获取方式文档中写明（az account get-access-token）
④ 未发现可疑指令或隐蔽外发
⑤ Microsoft 官方账号发布，信誉良好
⑥ MIT License，明确开源
⑦ 最近一次实质性提交为 2026-07-23，维护活跃
综合评分（三项均值）：7.7
7. 跟同类Skills相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| alerting-irm（Grafana 官方 grafana/skills 合集子技能） | 通用可观测性告警配置——Prometheus 风格通知策略路由树、on-call 升级链、SLO 燃尽率告警，适用任意基础设施 | 服务通用监控栈（Grafana OSS/Cloud），不理解 Fabric 平台专属的数据源模型（Eventhouse/Eventstream/Real-Time Hub/DTB）与 Fabric 内条目联动（如直接触发 Pipeline） |
| activator-consumption-cli（同合集技能） | 对已有 Activator/Reflex 规则做只读查询与状态解释 | 是本技能的只读镜像，负责“规则现在是什么状态”；本技能负责“创建/修改规则本身”，两者在 SKILL.md 中互相引用、按写/读场景分工 |
| Azure Monitor 告警规则（Azure 原生服务，非 agent skill） | 面向通用 Azure 资源指标/日志的告警平台，需在 Azure Portal 或 ARM/Bicep 中配置 | 覆盖全体 Azure 资源但不理解 Fabric 内部数据对象（如 Eventstream 拓扑节点），本技能专注 Fabric 原生数据流触发场景，两者可在同一系统中互补使用 |
8. 用户评价
该技能所属的 Fabric Skills 合集已被 Microsoft Fabric 官方社区博客与技术媒体 Enterprise DNA 报道，并被第三方技能目录收录列出。截至目前，activator-authoring-cli 这一具体子技能尚未见到独立于官方渠道之外的具名用户评价。
9. 其他补充
该技能与 eventstream-authoring-cli、eventhouse-authoring-cli 等同属 fabric-authoring 插件包，常与这些数据源技能搭配使用——先用它们把数据接入 Fabric，再用 activator-authoring-cli 对接入后的数据设置监控与响应规则。
10. 安装使用方式
- GitHub Copilot CLI（推荐路径）：
/plugin marketplace add microsoft/skills-for-fabric，再/plugin install fabric-skills@fabric-collection（完整包）或/plugin install fabric-authoring@fabric-collection（仅授权类子集） - 通用安装：
npx skills add https://github.com/microsoft/skills-for-fabric --skill activator-authoring-cli - Claude Code / Codex：直接克隆仓库到项目目录，根目录的
CLAUDE.md/AGENTS.md会被自动读取，无需额外配置 - 使用前需要
az login并获取 Fabric REST API 的访问令牌（az account get-access-token --resource https://api.fabric.microsoft.com） - 首次在会话中使用会触发一次
check-updates检查（每个已安装插件最多每 7 天联网检查一次）
11. 注意事项
- 需要 Microsoft Fabric 的工作区访问权限（Fabric 没有永久免费个人层，需 Pro/PPU 授权或试用容量）
- 构造规则 payload 时必须用 Python 而非 PowerShell 生成 JSON（PowerShell 的
ConvertTo-Json会破坏嵌套字符串结构，技能文档已用 CRITICAL 标注提醒） - 若通过较窄的分包（如
fabric-authoring）安装而非完整包，技能文档中指向 activator-consumption-cli 等姊妹技能的部分链接可能失效，完整包或手动克隆仓库不受此影响