Communitygithub.com

bg-szy/TOP-SKILLS

透過與使用者訪談、對應其 Azure 訂閱、整合 IP 定址文件,並套用 Microsoft Cloud Adoption Framework 最佳做法,協助填寫 Microsoft Azure Landing Zone (ALZ) Accelerator 檢查清單。最終產出可用於 ALZ 部署的完整 Excel 檢查清單 (.xlsx)。

TOP-SKILLS 是什麼?

此技能旨在自動化填寫 Microsoft Azure Landing Zone (ALZ) Accelerator 檢查清單的過程,這份 Excel 試算表是使用 Bicep 或 Terraform 部署 ALZ 時所有決策的單一事實來源。它透過結構化的工作流程運作:首先讀取上傳的 .xlsx 檔案以了解其結構(包含「Accelerator - Bootstrap」、「Accelerator - Bicep」、「Accelerator - Terraform」等分頁),接著以批次提問的方式引導使用者做出關鍵決策(如 IaC 類型、網路拓撲、安全性元件),並在必要時套用 Microsoft Cloud Adoption Framework 的最佳做法建議。此技能也能自動將使用者提供的 Azure 訂閱清單對應至 ALZ 角色(管理、連線、身分識別、安全性),並從使用者提供的文件中解析 IP 定址方案,以填入網路拓撲的 CIDR 區塊。最後,它使用 openpyxl 將值寫入 Excel 的「已選擇值」欄位,並應用顏色編碼(綠色表示已確認、黃色表示待處理)和註解來說明理由。支援的平臺包括 Bicep 和 Terraform 版本的 ALZ Accelerator,並處理多種情境(如中樞與分支、vWAN、多區域、防火牆類型等)。

相容平台~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) Accelerator 檢查清單 — 一份用於在透過 ALZ Accelerator 工具使用 Bicep 或 Terraform 部署 ALZ 之前,擷取所有必要決策的試算表。

目標是產出一份已填寫完成的 Excel 檢查清單,其中每項決策皆有理由,最佳做法已預設套用,而需要人工輸入的項目也已清楚標記以供使用者注意。

為何重要

ALZ Accelerator 檢查清單是平台登陸區部署的單一事實來源。填錯可能導致網路設定錯誤、安全漏洞,或需要數小時的重工。此技能透過套用 Microsoft Cloud Adoption Framework (CAF) 的建議,同時尊重使用者現有的基礎設施(IP 範圍、訂閱、命名慣例),來確保一致性。

工作流程

第一階段:讀取檢查清單

使用 openpyxl 讀取上傳的 .xlsx 檢查清單,以了解其結構。ALZ 檢查清單通常包含三個分頁:

  • Accelerator - Bootstrap:IaC 類型、VCS、訂閱、命名、CI/CD 設定
  • Accelerator - Bicep:情境選擇、元件開關、IP 定址、原則
  • Accelerator - Terraform:與 Bicep 相同,但包含更多選項(AMBA、Sovereign LZ)

解析檢查清單以識別哪些欄位已有值(F 欄 =「已選擇值」),哪些為空白。這能告訴您哪些決策使用者已做出,哪些需要輸入。

第二階段:訪談使用者

透過結構化提問收集決策。為避免使用者感到負擔,每次以 3-4 個問題為一批進行提問。依下列優先順序進行:

第一批 — 基礎決策:

  • IaC 類型(Bicep 或 Terraform)
  • 版本控制系統(Azure DevOps、GitHub 或本機)
  • 網路拓撲情境(中樞與分支 vs vWAN、單區域 vs 多區域、Azure Firewall vs NVA)
  • Azure 區域

第二批 — 元件決策:

  • 要部署哪些元件(DDoS、Private DNS、Bastion、VPN 閘道、ExpressRoute、Zero Trust)
  • 安全態勢(AMA、Defender 方案)

第三批 — 環境特定細節:

  • Azure DevOps / GitHub 組織與專案名稱
  • 訂閱 ID(管理、連線、身分識別、安全性)
  • 管線核准者
  • IP 定址(詢問他們是否有既有文件)

當使用者說「使用最佳做法」或推遲決策時,套用 references/alz-best-practices.md 中的建議。務必解釋為何提出某項建議 — 使用者會信任他們理解的建議。

第三階段:對應訂閱

如果使用者提供訂閱清單(來自 az account list 或類似指令),透過比對命名模式將訂閱對應至 ALZ 角色:

模式ALZ 角色
*mgmt*、*management*管理
*connectivity*、*network*、*hub*連線
*identity*、*ad*、*entra*身分識別
*security*、*sentinel*、*defender*安全性

如果缺少必要的訂閱(通常是安全性),則以黃色高亮標記並加上註解說明選項:

  1. 建立專用訂閱(建議)
  2. 與管理訂閱共用(預算受限的替代方案)

第四階段:整合 IP 定址

如果使用者提供 IP 文件(Markdown、CSV、Excel 或純文字),解析它以提取:

  • 訂閱層級 CIDR 區塊 — 對應至 ALZ 中樞/分支 VNet
  • 現有中樞 VNet 佈局 — 識別子網路配置(閘道、防火牆、Bastion、共用服務)
  • 內部部署公用 IP — 納入註解中,供 VPN/防火牆規則參考
  • AKS 網路 — 適用的 Pod/服務 CIDR

對於 ALZ 中樞 VNet,使用連線訂閱的 CIDR 區塊建議此子網路佈局:

Hub VNet: <連線基底>/16
  GatewaySubnet:                <基底>.0.0/27     (30 個主機)
  AzureFirewallSubnet:          <基底>.0.64/26    (62 個主機)
  AzureFirewallManagementSubnet:<基底>.0.128/26   (62 個主機)
  AzureBastionSubnet:           <基底>.0.192/26   (62 個主機)
  共用服務:              <基底>.1.0/24     (254 個主機)
  DNS 解析器輸入:         <基底>.2.0/28
  DNS 解析器輸出:        <基底>.2.16/28

如果未提供 IP 文件,則使用 ALZ 預設值並標記為待審查。

第五階段:填寫檢查清單

使用 openpyxl 將值寫入適當分頁的 F 欄(「已選擇值」)。套用一致的格式:

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 選擇為何,一律填寫 — 它是共用的。

第六階段:呈現結果

儲存已填寫的檢查清單後:

  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(Private networking 必要)
  • 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 對等互連。

儲存格參考對應

檢查清單具有固定結構。在寫入值時,請使用這些精確的儲存格參考,以避免列偏移錯誤。在寫入 F 欄之前,務必檢查 B 欄(名稱)是否與預期欄位相符。

Bootstrap 分頁 (Accelerator - Bootstrap)

列儲存格欄位 (B 欄)設定 (D 欄)
4F4Infrastructure as Codeiac_type
5F5Version control systembootstrap_module_name
6F6Starter modulestarter_module_name
8F8Bootstrap resource regionbootstrap_location
9F9Parent management group idroot_parent_management_group_id
10F10Management subscription idsubscription_id_management
11F11Connectivity subscription idsubscription_id_connectivity
12F12Identity subscription idsubscription_id_identity
13F13Security subscription idsubscription_id_identity (注意:範本筆誤)
15F15Bootstrap subscription idbootstrap_subscription_id
16F16Resource naming: service nameservice_name
17F17Resource naming: environment nameenvironment_name
18F18Resource naming: postfix numberpostfix_number
21F21Use separate repository for templatesuse_separate_repository_for_templates
22F22Use private networkinguse_private_networking
23F23Allow storage access from my IPallow_storage_access_from_my_ip
24F24Apply approversapply_approvers
25F25Create branch policiescreate_branch_policies
28F28Azure DevOps PATazure_devops_personal_access_token
29F29Azure DevOps Agent PATazure_devops_agents_personal_access_token
30F30Azure DevOps Organizationazure_devops_organization_name
31F31Azure DevOps legacy urlazure_devops_use_organisation_legacy_url
32F32Create Azure DevOps Projectazure_devops_create_project
33F33Azure DevOps Projectazure_devops_project_name
34F34Use self hosted agentsuse_self_hosted_agents

注意:第 7、14、19、20、26、27、35、36、41 行為空白或區段標題 — 請跳過它們。

Bicep 分頁 (Accelerator - Bicep) — 情境

列儲存格情境
6F6Multi-Region Hub & Spoke + Azure Firewall
7F7Multi-Region vWAN + Azure Firewall
8F8Multi-Region Hub & Spoke + NVA
9F9Multi-Region vWAN + NVA
10F10Management Groups, Policy and Management Only
11F11Single-Region Hub & Spoke + Azure Firewall
12F12Single-Region vWAN + Azure Firewall
13F13Single-Region Hub & Spoke + NVA
14F14Single-Region vWAN + NVA

Bicep 分頁 — 選項(第 17-30 列)

列儲存格選項
17F17Resource naming convention
18F18Custom management group names
19F19Deploy DDOS Protection Plan
20F20Deploy Private DNS
21F21Deploy Bastion Host
22F22Deploy VPN Gateway
23F23Deploy ExpressRoute Gateway
24F24Deploy to more than 2 regions
25F25IP Addressing
26F26Change a policy assignment enforcement mode
27F27Remove a policy assignment
28F28Turn off Azure Monitoring Agent
29F29Turn off Defender Plans
30F30Zero Trust Security

Terraform 分頁 (Accelerator - Terraform)

情境佈局與 Bicep 相同(第 6-14 列)。選項為第 17-32 列:

列儲存格選項
17F17Resource naming convention
18F18Custom management group names
19F19Deploy DDOS Protection Plan
20F20Deploy Private DNS
21F21Deploy Bastion Host
22F22Deploy VPN Gateway
23F23Deploy ExpressRoute Gateway
24F24Deploy to more than 2 regions
25F25IP Addressing
26F26Change a policy assignment enforcement mode
27F27Remove a policy assignment
28F28Turn off Azure Monitoring Agent
29F29Deploy Azure Monitoring Baseline Alerts (AMBA)
30F30Turn off Defender Plans
31F31Zero Trust Security
32F32Sovereign Landing Zone

驗證方式:在寫入任何值之前,請讀取儲存格 B{列} 並驗證它是否與預期的欄位名稱相符。如果不相符,請掃描工作表以尋找正確的列。這樣可以防止因範本版本差異導致資料無聲損毀。

輸出格式

最終交付物是一個 .xlsx 檔案,包含:

  • 保留原始範本中的所有三個分頁
  • F 欄已填寫所選擇的值
  • 包含理由和最佳做法參考的儲存格註解
  • 顏色編碼:綠色(已確認)、黃色(需要操作)、淺黃色(要審查的預設值)
  • 對話中清晰的摘要,列出所有決策和標記的項目

注意事項

  • openpyxl 列索引是從 1 開始 — 差一錯誤會無聲地毀損錯誤的列;在提交前使用 cell.value 回讀驗證。
  • 訂閱正則表達式比對在非標準命名時會失敗(例如 sub-xyz-platform-mgmt)— 當模式失敗時,回退到列舉。
  • 跨區域考量:跨區域的 VNet 對等互連會產生輸出流量費用;預設 ALZ 範本未計算此費用。
  • Excel 核取方塊 vs 儲存格值: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

相關技能