Communitygithub.com

bg-szy/TOP-SKILLS

通过面试用户、映射其 Azure 订阅、集成 IP 地址文档并应用 Microsoft Cloud Adoption Framework 最佳实践,填写 Microsoft Azure Landing Zone (ALZ) 加速器检查表。输出一份可直接用于 ALZ 部署的完整 Excel 检查表 (.xlsx)。

TOP-SKILLS 是什么?

此技能专门用于帮助用户自动完成 Microsoft Azure Landing Zone (ALZ) 加速器检查表的填写。ALZ 检查表是部署平台登陆区(landing zone)前的决策记录单,涵盖网络、安全、订阅分配等关键配置。该技能通过结构化的面试流程,依次收集 IaC 类型(Bicep 或 Terraform)、版本控制系统、网络拓扑场景、组件部署选项、环境详细信息等决策。用户上传或提供订阅列表后,技能会根据命名模式自动将订阅映射至 ALZ 角色(管理、连接、身份、安全),并对缺失的必要订阅进行高亮提示。此外,技能会解析用户提供的 IP 文档(Markdown、CSV 等),提取 CIDR 块、现有 VNet 布局和本地公共 IP,为 Hub VNet 提供推荐子网布局。最终,技能利用 openpyxl 库将决策写入 Excel 检查表的对应单元格,应用颜色编码(绿色表示已确认、黄色表示需用户操作、浅黄色表示默认值需审查)并添加最佳实践注释。支持 Cursor、Codex 等支持 Python 执行的 AI Agent 平台,显著降低 ALZ 部署的配置错误风险。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/claude-code-skills/azure-landing-zone-checklist

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Azure Landing Zone 检查表技能

此技能将引导您完成 Microsoft Azure Landing Zone (ALZ) 加速器检查表的填写——该电子表格记录了通过 ALZ 加速器工具使用 Bicep 或 Terraform 部署 ALZ 之前所需的所有决策。

目标是生成一份已填写的 Excel 检查表,其中每个决策都有依据,默认应用最佳实践,并且需要人工输入的项目会明确标记以引起用户注意。

为何重要

ALZ 加速器检查表是平台登陆区部署的单一事实来源。填写错误意味着网络配置错误、安全漏洞或数小时的重做工作。此技能通过应用 Microsoft Cloud Adoption Framework (CAF) 的建议,同时尊重用户现有的基础设施(IP 范围、订阅、命名约定),确保一致性。

工作流程

阶段 1:读取检查表

使用 openpyxl 读取上传的 .xlsx 检查表以了解其结构。ALZ 检查表通常包含三个选项卡:

  • Accelerator - Bootstrap:IaC 类型、VCS、订阅、命名、CI/CD 设置
  • Accelerator - Bicep:场景选择、组件开关、IP 寻址、策略
  • Accelerator - Terraform:与 Bicep 相同,但包含额外选项(AMBA、Sovereign LZ)

解析检查表以识别哪些字段已有值(F 列 = "Chosen Value")以及哪些为空。这可以告诉您用户已经决定了什么以及需要什么输入。

阶段 2:面试用户

通过结构化的提问收集决策。一次询问 3-4 个问题,以免让用户不知所措。按以下顺序优先询问:

第一批——基础决策:

  • IaC 类型(Bicep 或 Terraform)
  • 版本控制系统(Azure DevOps、GitHub 或本地)
  • 网络拓扑场景(Hub & Spoke 与 vWAN、单区域与多区域、Azure Firewall 与 NVA)
  • Azure 区域

第二批——组件决策:

  • 部署哪些组件(DDoS、Private DNS、Bastion、VPN Gateway、ExpressRoute、Zero Trust)
  • 安全态势(AMA、Defender 计划)

第三批——环境特定细节:

  • Azure DevOps / GitHub 组织和项目名称
  • 订阅 ID(管理、连接、身份、安全)
  • 管道审批者
  • IP 寻址(询问他们是否已有现有文档)

当用户说“使用最佳实践”或推迟决策时,应用 references/alz-best-practices.md 中的建议。始终解释提出建议的原因——用户信任他们理解的建议。

阶段 3:映射订阅

如果用户提供订阅列表(来自 az account list 或类似命令),通过匹配命名模式将订阅映射到 ALZ 角色:

模式ALZ 角色
*mgmt*, *management*管理
*connectivity*, *network*, *hub*连接
*identity*, *ad*, *entra*身份
*security*, *sentinel*, *defender*安全

如果缺少必需的订阅(通常是安全),用黄色高亮标记并添加注释解释选项:

  1. 创建专用订阅(推荐)
  2. 与管理订阅共享(预算受限的替代方案)

阶段 4:集成 IP 寻址

如果用户提供 IP 文档(Markdown、CSV、Excel 或文本),解析它以提取:

  • 订阅级 CIDR 块——映射到 ALZ 中心/分支 VNet
  • 现有中心 VNet 布局——识别子网分配(网关、防火墙、堡垒机、共享服务)
  • 本地公共 IP——包含在注释中,用于 VPN/防火墙规则参考
  • AKS 网络——Pod/服务 CIDR(如适用)

对于 ALZ 中心 VNet,使用连接订阅的 CIDR 块推荐以下子网布局:

Hub VNet: <connectivity-base>/16
  GatewaySubnet:                <base>.0.0/27     (30 个主机)
  AzureFirewallSubnet:          <base>.0.64/26    (62 个主机)
  AzureFirewallManagementSubnet:<base>.0.128/26   (62 个主机)
  AzureBastionSubnet:           <base>.0.192/26   (62 个主机)
  Shared Services:              <base>.1.0/24     (254 个主机)
  DNS Resolver Inbound:         <base>.2.0/28
  DNS Resolver Outbound:        <base>.2.16/28

如果未提供 IP 文档,使用 ALZ 默认值并标记以供审查。

阶段 5:填写检查表

使用 openpyxl 将值写入相应选项卡的 F 列("Chosen Value")。应用一致的格式:

from openpyxl.styles import Font, PatternFill, Alignment
from openpyxl.comments import Comment

# 已确认的值——绿色背景
green_fill = PatternFill('solid', fgColor='CCE5CC')

# 需要用户操作的项目——黄色背景 + 红色粗体文本
yellow_fill = PatternFill('solid', fgColor='FFFF00')
action_font = Font(bold=True, color='FF0000', size=10)

# 信息性注释——斜体黄色背景
note_fill = PatternFill('solid', fgColor='FFFFCC')
note_font = Font(italic=True, size=10)

对于您填写的每个单元格:

  • 添加一个评论说明理由或最佳实践参考
  • 已确认的决定使用绿色填充
  • 需要用户操作的项目(例如,“待定义”、“待提供”)使用黄色填充 + 红色文本
  • 使用默认值但用户应检查的项目使用浅黄色填充 + 斜体

选项卡特定逻辑:

仅填写与用户 IaC 选择匹配的选项卡。如果另一个选项卡之前有值,则将其清除。对于活动选项卡:

  1. 场景部分:将所选场景设置为“是”,所有其他场景设置为“否”。用更明亮的绿色突出显示所选场景。
  2. 选项部分:应用用户的组件选择。对于任何未明确讨论的选项,应用最佳实践默认值并在注释中说明。
  3. Bootstrap 选项卡:无论 IaC 选择如何,始终填写——它是共享的。

阶段 6:呈现结果

保存填写好的检查表后:

  1. 打印一个汇总表,显示所有已填写的值
  2. 列出标记为需要用户操作的项目(黄色高亮)
  3. 指出任何体系结构注意事项(例如,如果 ALZ 区域与现有基础架构不同,则需要跨区域对等)
  4. 提供文件下载链接

最佳实践建议

阅读 references/alz-best-practices.md 以获取完整的建议集。用户推迟决策时应用的关键默认值:

  • Private networking:true(状态存储不应公开访问)
  • Separate CI/CD template repo:true(代码与管道定义之间的安全边界)
  • Branch policies:true(所有更改都需要 PR)
  • Self-hosted agents/runners:true(私有网络所需)
  • DDoS Protection:是(所有 VNet 资源的网络层保护)
  • Private DNS Zones:是(中心辐射架构中 Private Endpoints 所需)
  • Azure Bastion:是(无需公开 IP 即可实现安全的 VM 访问)
  • AMA (Azure Monitoring Agent):保持启用(集中监控)
  • Defender plans:保持启用(所有资源类型的威胁检测)
  • Zero Trust:是(最小权限访问和微隔离)
  • AMBA alerts(仅限 Terraform):是(平台资源的主动监控)
  • Sovereign Landing Zone:否(除非明确要求合规)

跨区域注意事项

如果用户现有基础设施位于与 ALZ 部署不同的区域,请在此标记到 Bootstrap 选项卡的区域注释中。他们需要规划 ALZ 中心与任何现有中心辐射拓扑之间的跨区域 VNet 对等互连。

单元格参考映射

检查表具有固定结构。写入值时使用这些精确的单元格引用,以避免出现行偏移错误。始终通过检查 B 列(“名称”)是否与预期字段匹配来验证,然后再写入 F 列。

Bootstrap 选项卡 (Accelerator - Bootstrap)

行单元格字段 (col B)配置设置 (col D)
4F4基础设施即代码iac_type
5F5版本控制系统bootstrap_module_name
6F6启动模块starter_module_name
8F8Bootstrap 资源区域bootstrap_location
9F9父管理组 IDroot_parent_management_group_id
10F10管理订阅 IDsubscription_id_management
11F11连接订阅 IDsubscription_id_connectivity
12F12身份订阅 IDsubscription_id_identity
13F13安全订阅 IDsubscription_id_identity (注意:模板拼写错误)
15F15Bootstrap 订阅 IDbootstrap_subscription_id
16F16资源命名:服务名称service_name
17F17资源命名:环境名称environment_name
18F18资源命名:后缀编号postfix_number
21F21为模板使用单独仓库use_separate_repository_for_templates
22F22使用私有网络use_private_networking
23F23允许从我的 IP 访问存储allow_storage_access_from_my_ip
24F24应用审批者apply_approvers
25F25创建分支策略create_branch_policies
28F28Azure DevOps PATazure_devops_personal_access_token
29F29Azure DevOps Agent PATazure_devops_agents_personal_access_token
30F30Azure DevOps 组织azure_devops_organization_name
31F31Azure DevOps 旧版 URLazure_devops_use_organisation_legacy_url
32F32创建 Azure DevOps 项目azure_devops_create_project
33F33Azure DevOps 项目azure_devops_project_name
34F34使用自托管代理use_self_hosted_agents

注意:第 7、14、19、20、26、27、35、36、41 行为空白或节标题——跳过它们。

Bicep 选项卡 (Accelerator - Bicep) —— 场景

行单元格场景
6F6多区域 Hub & Spoke + Azure Firewall
7F7多区域 vWAN + Azure Firewall
8F8多区域 Hub & Spoke + NVA
9F9多区域 vWAN + NVA
10F10仅管理组、策略和管理
11F11单区域 Hub & Spoke + Azure Firewall
12F12单区域 vWAN + Azure Firewall
13F13单区域 Hub & Spoke + NVA
14F14单区域 vWAN + NVA

Bicep 选项卡 —— 选项(第 17-30 行)

行单元格选项
17F17资源命名约定
18F18自定义管理组名称
19F19部署 DDOS 保护计划
20F20部署私有 DNS
21F21部署 Bastion 主机
22F22部署 VPN 网关
23F23部署 ExpressRoute 网关
24F24部署到 2 个以上区域
25F25IP 寻址
26F26更改策略分配强制模式
27F27删除策略分配
28F28关闭 Azure 监控代理
29F29关闭 Defender 计划
30F30零信任安全

Terraform 选项卡 (Accelerator - Terraform)

与 Bicep 相同的场景布局(第 6-14 行)。选项为第 17-32 行:

行单元格选项
17F17资源命名约定
18F18自定义管理组名称
19F19部署 DDOS 保护计划
20F20部署私有 DNS
21F21部署 Bastion 主机
22F22部署 VPN 网关
23F23部署 ExpressRoute 网关
24F24部署到 2 个以上区域
25F25IP 寻址
26F26更改策略分配强制模式
27F27删除策略分配
28F28关闭 Azure 监控代理
29F29部署 Azure 监控基线警报 (AMBA)
30F30关闭 Defender 计划
31F31零信任安全
32F32主权登陆区

验证方法:在写入任何值之前,读取单元格 B{row} 并验证它与预期字段名称匹配。如果不匹配,扫描工作表以找到正确的行。这可以防止模板版本差异导致的静默数据损坏。

输出格式

最终交付物为 .xlsx 文件,其中包含:

  • 保留原始模板的所有三个选项卡
  • F 列中填充选定的值
  • 包含理由和最佳实践参考的单元格注释
  • 颜色编码:绿色(已确认)、黄色(需要操作)、浅黄色(需要审查的默认值)
  • 对话中清晰的摘要,列出所有决策和标记的项目

注意事项

  • openpyxl 行索引从 1 开始 —— 差一错误会静默破坏错误行;在提交前使用 cell.value 回读验证。
  • 订阅正则表达式匹配在非标准命名上会失败(例如 sub-xyz-platform-mgmt)—— 当模式失败时回退到枚举。
  • 跨区域注意事项:跨区域 VNet 对等会产生出站流量成本;默认 ALZ 模板未计入此项。
  • Excel 复选框与单元格值:openpyxl 无法写入复选框状态——使用单元格值“✓”+ 命名范围指示已选中。
  • 订阅配额传播:请求的配额增加在配额实际应用之前显示为“已批准”——使用 az vm list-usage 验证。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

bg-szy/TOP-SKILLS

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

相关技能