mcpField
A
azure-smart-city-iot-solution-builder

azure-smart-city-iot-solution-builder

github.com/github云与 DevOps40.5k74 次安装1 天前更新
代码仓库

关于 azure-smart-city-iot-solution-builder

用于 Azure IoT 与智慧城市方案设计的技能,可将高层需求转化为架构、治理清单和分阶段交付计划。适合规划城市平台的团队,并要求在涉及边缘计算时先查阅 Azure IoT Edge 文档。

主要功能

  1. 01梳理城市需求与约束
  2. 02按平台层划分能力
  3. 03选择 Azure 服务
  4. 04制定安全与成本策略
  5. 05生成分阶段实施待办

适用场景

  1. 01规划交通、照明或废弃物 IoT 方案
  2. 02设计设备、分析与告警链路
  3. 03为城市平台制定路线图与待办

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/github/awesome-copilot --skill azure-smart-city-iot-solution-builder

安装后在 Claude Code 中输入/azure-smart-city-iot-solution-builder确认已加载。

附带文件references/smart-city-solution-template.md

详细介绍

Azure 智慧城市 IoT 解决方案构建器

使用此技能可重建并标准化 Azure IoT 与智慧城市解决方案的完整工作流。

何时使用

当用户提出如下需求时使用此技能:

  • “我想在 Azure 上构建 IoT 解决方案”
  • “用于交通、照明或垃圾管理的智慧城市架构”
  • “如何连接设备、分析和告警?”
  • “我需要一个城市平台的路线图和待办列表”

目标

  • 将高层想法转化为可部署的架构。
  • 尽可能复用现有的 Azure 相关技能。
  • 产出团队可以落地的具体工件。

工作流

0) 强制文档审查(在任何架构之前)

在提出涉及边缘计算的架构或技术决策之前,先审查 Azure IoT Edge 文档:

至少需要审查的页面:

  • 什么是 Azure IoT Edge
  • 运行时架构
  • 支持的系统
  • 版本历史/发行说明
  • 与场景相关的 Linux/Windows 快速入门

如果无法查阅文档,请明确说明,并在继续时清楚标注假设。

1) 范围与约束

收集并确认:

  • 城市领域:出行、停车、空气质量、水务、能源、公共安全、垃圾等。
  • 规模:设备数量、遥测频率、保留期、区域。
  • 延迟与可用性目标。
  • 法规与隐私约束。
  • 需要集成的现有系统(SCADA、GIS、ERP、票务、API)。
2) 能力地图

将平台拆分为以下层次:

  • 设备与边缘:接入、身份、固件、OTA、边缘处理。
  • 摄取与消息传递:命令与控制、事件路由、缓冲。
  • 数据与分析:热路径与冷路径、仪表板、历史分析。
  • 运维:可观测性、事件流程、SLO。
  • 治理:RBAC、密钥、策略、网络隔离。
3) Azure 服务选择(参考)
  • 设备连接:Azure IoT Hub、Azure IoT Operations、IoT Edge。
  • 事件流:Event Hubs、Service Bus、Event Grid。
  • 存储:Blob Storage、Data Lake、Cosmos DB、SQL。
  • 分析:Azure Data Explorer、Stream Analytics、Fabric/Synapse。
  • API 与应用:API Management、App Service、Container Apps、Functions。
  • 监控:Azure Monitor、Application Insights、Log Analytics。
  • 安全:Key Vault、Defender for IoT、Private Endpoints、Managed Identity。
4) 非功能性设计

定义并记录:

  • 可靠性模型(区域/可用区、重试、死信处理、重放)。
  • 安全控制(零信任、加密、密钥轮换、最小权限)。
  • 成本控制(保留层、合理规格、自动缩放、工作负载调度)。
  • 数据生命周期(原始、已整理、聚合、归档)。
5) 交付计划

创建分阶段执行计划:

  • 阶段 1:试点区域或单一用例。
  • 阶段 2:多领域集成。
  • 阶段 3:城市级推广与优化。

每个阶段都要包含:

  • 退出标准
  • 依赖项
  • 风险与缓解措施
  • KPI 集

优先复用其他技能

技能有两个来源:

  • 运行时提供的技能(在此仓库之外):仅当 Copilot 宿主环境暴露它们时才可用。
  • 本地仓库技能(此仓库):可作为 skills/ 下的本地文件使用。
运行时提供的 Azure 技能(可选)

如果执行环境中可用,可委派给这些专用技能以获得更深入的指导:

  • azure-kubernetes
  • azure-messaging
  • azure-observability
  • azure-storage
  • azure-rbac
  • azure-cost
  • azure-validate
  • azure-deploy
本地仓库替代项(在本仓库中使用)

当运行时技能不可用时,优先使用本仓库中已有的本地技能:

  • azure-architecture-autopilot,用于架构生成与优化。
  • azure-resource-visualizer,用于资源关系图。
  • azure-role-selector,用于角色选择指导。
  • az-cost-optimize 和 azure-pricing,用于成本与定价分析。
  • azure-deployment-preflight,用于部署前检查。
  • appinsights-instrumentation,用于遥测插桩模式。

如果没有可用的专用技能,请继续使用本技能,并保持假设明确。

必需的输出产物

始终提供以下输出:

  1. 智慧城市解决方案摘要(范围、假设、约束)。
  2. 参考架构(组件与数据流)。
  3. 安全与治理检查清单。
  4. 成本与扩缩容策略。
  5. 分阶段实施待办事项(史诗与里程碑)。

输出模板

使用 references/smart-city-solution-template.md 为每个场景标准化输出,并采用以下响应结构:

  1. 背景与目标
  2. 提议的架构
  3. 技术决策与权衡
  4. 安全、运维与成本控制
  5. 分阶段实施计划
  6. 风险与未决问题

指南

  • 在验证先决条件之前,不要直接进入部署。
  • 不要为关键城市工作负载推荐单区域生产环境。
  • 不要遗漏运维责任归属(谁处理事件、SLA、变更窗口)。
  • 清楚区分假设与已确认事实。

评论

支持 Markdown