ASD

Prepare

Fase 2 del pipeline azure-app-onboard: mapea los componentes de la app a servicios de Azure con estimación de costes y validación de cuota. No es invocable directamente.

Oficial
Estrellas
1.4k

en todo el repo

Actividad
58

0–100, la ruta de este skill

Actualizado
hace 21 días

último commit aquí

Commits
1

últimos 90 días

Contexto
1.6k tok

29 tok en reposo

Paquete
13 archivos

71 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add microsoft/azure-skills --skill prepare --agent claude-code

Se instala solo en este repositorio.

Qué hace

  • Mapea los componentes de una aplicación a servicios de Azure, con estimación de coste y validación de cuota.
  • Lee `prereq-output.json` y `context.json` del directorio de sesión y escribe `prepare-plan.json`.
  • Es la fase 2 del pipeline de `azure-app-onboard` y devuelve el control al orquestador al terminar: tiene prohibido invocar scaffold o deploy por su cuenta.

Úsalo cuando

  • Lo invoca el orquestador `azure-app-onboard` en la fase 2, cuando existe `prereq-output.json`.

No lo uses cuando

  • Directamente por el usuario: el archivo dice que no es enrutable de forma directa.
  • Para optimizar gasto existente (`azure-cost`), estimar costes de VM (`azure-compute`) o arquitectura de landing zone empresarial.

SKILL.md

En inglés

Prepare — Architecture Planning & Cost Estimation

Quick Reference

Property Value
Best for Mapping app components to Azure services with cost estimation and quota validation
Inputs prereq-output.json + context.json from .copilot-azure/sessions/{id}/
Outputs prepare-plan.json written to session directory
Parent azure-app-onboard

When to Use This Skill

Invoked by the azure-app-onboard orchestrator at Phase 2 when prereq-output.json exists. Not directly user-routable.

Return to orchestrator: When complete, return control to azure-app-onboard. Do NOT directly invoke scaffold or deploy.

When NOT to Use

Scenario Use Instead
Code readiness or prereq scanning azure-app-onboard Step 3 (prereq)
IaC generation from a completed plan azure-app-onboard Step 7 (scaffold)
Deploying resources to Azure azure-app-onboard Step 9 (deploy)
Optimizing existing Azure spend azure-cost
Estimating VM-specific costs azure-compute
Enterprise landing zone architecture azure-enterprise-infra-planner

MCP Tools

Tool Purpose
mcp_azure_mcp_pricing / azure-pricing (router → command: pricing_get) Cost estimation (inline — see Step 6). Fallback: dispatch subagent-pricing.md
mcp_azure_mcp_policy Subscription policy constraints
az rest Quota validation (via sub-agent — see Step 5)
mcp_azure_mcp_cloudarchitectcloudarchitect_design WAF-aligned architecture design
mcp_azure_mcp_wellarchitectedframework Per-service WAF guidance
mcp_azure_mcp_advisoradvisor_recommendation_list Optimization recommendations

Workflow

# Step Action Reference
1 Read session state Load prereq-output.json + context.json. Resolve subscription Cross-ref subscription-resolution.md if needed
2 Query policy constraints Inline MCP: fetch policy + advisor recommendations mcp_azure_mcp_policy + mcp_azure_mcp_advisor
3 Map components to services Per-component Azure service selection, Dockerfile routing, deploy-as-is You MUST read service-mapping.md and deploy-strategy.md
4 Select SKUs + WAF analysis Budget-aware SKU selection, inline WAF service guidance You MUST read sku-matrix.md
5 Validate quotas + region capacity ⛔ Read subagent-quota.md → dispatch as task (NEXT action MUST be task, ⛔ agent_type: "task" — NEVER "general-purpose"). Copy the COMPLETE and UNMODIFIED template text into the task prompt between <<<TEMPLATE_START>>> / <<<TEMPLATE_END>>> delimiters — do NOT summarize. Append the caller-provided inputs listed in subagent-quota.md's Input table AFTER the template block. ⛔ After dispatching, proceed to Step 6 (cost estimation) while the subagent runs. Do NOT run quota checks yourself — the subagent handles it. Collect subagent results before Step 9 (write plan). You MUST read subagent-quota.md
6 Estimate costs You MUST read pricing-guide.md for methodology, then pricing-guide-services.md for per-service filters. Call the pricing router (mcp_azure_mcp_pricing/azure-pricing) with command: "pricing_get" + a parameters{} object inline per paid service. If MCP unavailable or fails → ⛔ Read subagent-pricing.md → dispatch as task (NEXT action MUST be task, ⛔ agent_type: "task" — NEVER "general-purpose"). Copy the COMPLETE and UNMODIFIED template text into the task prompt between <<<TEMPLATE_START>>> / <<<TEMPLATE_END>>> delimiters — do NOT summarize. Append data (services[], region, budget tier) AFTER the template block. Write results to prepare-plan.json.costEstimate. pricing-guide.md
7 Generate naming Centralized naming: suffix, prefix, all resource names You MUST read naming-patterns.md
8 Determine IaC format Existing non-Azure .tfask_user Bicep vs TF, write to overrides[].iacFormat. No .tf → default Bicep. (inline)
9 Write prepare-plan.json Per PreparePlan schema. Include postDeployRecommendations, deploymentVariables You MUST read prepare-schemas.ts for PreparePlan schema
10 Return summary Structured summary for orchestrator approval gate (inline — 1 line)
11 Validate plan 4-dimension check: Goal Alignment, WAF Alignment, Dependency Completeness, Deployment Viability. Fix inline on failure, document tradeoffs in assumptions[]. All must pass before writing

Step 5 — Post-Quota Validation

NEVER present a region without checking quota first. Skipping quota validation causes cascading deploy failures and extended healing loops. ⛔ If plan includes PostgreSQL/MySQL, verify offerRestrictionsVerified: true — if false/missing, region is blocked. Do NOT proceed to scaffold with unchecked DB services. ⛔ Free ≠ unlimited. Every compute SKU — including F1, Consumption, and Serverless tiers — has a per-subscription, per-region quota. Do NOT skip quota checks because a SKU is free. ⛔ After region fallback, update ALL services[].region in prepare-plan.json. Do not leave stale values.

Error Handling

Error Remediation
Pricing API 400 Verify --sku included. Free tiers: skip API
MCP pricing unavailable Dispatch subagent-pricing.md as task fallback (uses direct HTTP to prices.azure.com)
Prereq output missing Trigger prereq backfill
Quota check fails Fall back to best-effort estimate + disclaimer
Override conflicts Re-run from Step 3 with new constraints

Reproducido de microsoft/azure-skills bajo licencia MIT. Leer esta página en markdown.

Archivos

13 archivos en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

Antes de instalar

Requiere `prereq-output.json` y `context.json` en `.copilot-azure/sessions/{id}/`. No tiene frontmatter propio: es un sub-skill del pipeline.

Detalles

Creador
microsoft
Licencia
MIT
Recursos incluidos
referencias
Código fuente
Ver SKILL.md

Etiquetas

Más de microsoft/azure-skills

Este repo incluye 41 skills. Si instalas uno, normalmente ya tienes los demás.

Despliega, evalúa, ajusta y gestiona agentes de Foundry de punta a punta con azd: agentes hospedados, evaluación por lotes y continua, optimizador de prompts y fine-tuning (SFT/DPO/RFT).

Costo de contexto al activarse
6.5k tok
Tamaño del paquete
185 archivos
Última actualización
hace 3 días
Oficialherramientas desarrollo

Prepara proyectos Azure basados en azd para desplegar: genera azure.yaml, la infraestructura (Bicep o Terraform) y los Dockerfiles del flujo del Azure Developer CLI.

Costo de contexto al activarse
3.2k tok
Tamaño del paquete
164 archivos
Última actualización
hace 4 días
Oficialdevops infraestructura

Depura incidencias de producción en Azure con AppLens, Azure Monitor, resource health y triaje seguro. Cubre App Service, Container Apps, Functions, AKS, VMs y mensajería.

Costo de contexto al activarse
1.6k tok
Tamaño del paquete
49 archivos
Última actualización
hace 4 días
Oficialdevops infraestructura

Validación previa al despliegue en Azure. Comprueba en profundidad la configuración, la infraestructura (Bicep o Terraform), los roles RBAC, los permisos de identidad administrada y los prerrequisitos.

Costo de contexto al activarse
901 tok
Tamaño del paquete
27 archivos
Última actualización
hace 4 días
Oficialdevops infraestructura

Skill unificado de despliegue de modelos de Azure OpenAI con enrutado por intención: despliegues rápidos con preset, despliegues personalizados y descubrimiento de capacidad entre regiones y proyectos.

Costo de contexto al activarse
1.8k tok
Tamaño del paquete
17 archivos
Última actualización
hace 4 días
Oficialdevops infraestructura

Orquestador de punta a punta: de una idea o una app existente hasta un despliegue en Azure, con estimación de costes y aprobación previa. Analiza tu app y detecta los servicios adecuados.

Costo de contexto al activarse
1.6k tok
Tamaño del paquete
68 archivos
Última actualización
hace 4 días
Oficialdevops infraestructura

Skills relacionados

Despliega una app web o API existente en un clúster AKS ya en marcha: detecta el framework, genera Dockerfile y manifiestos, valida contra los Deployment Safeguards y despliega con verificación.

Costo de contexto al activarse
503 tok
Tamaño del paquete
42 archivos
Última actualización
hace 4 días
Oficialdevops infraestructura

Deploy

1.4k

Fase 4 del pipeline azure-app-onboard: ejecuta la IaC validada contra Azure y verifica la salud de los recursos desplegados. No es invocable directamente.

Costo de contexto al activarse
1.8k tok
Tamaño del paquete
16 archivos
Última actualización
hace 21 días
Oficialdevops infraestructura

Fase 3 del pipeline azure-app-onboard: genera IaC lista para desplegar desde el plan de arquitectura y la verifica con auto-revisión adversarial, sin desplegar. No es invocable directamente.

Costo de contexto al activarse
3.6k tok
Tamaño del paquete
27 archivos
Última actualización
hace 4 días
Oficialdevops infraestructura