К основному содержанию
скилл CX Codex

azure-app-onboard-prereq — скилл для Claude Code: что делает

Скилл azure-app-onboard-prereq проверяет готовность исходного кода к развёртыванию в Azure до настройки инфраструктуры. Он оценивает зависимости, сборку и совместимость стека без запуска тестовых и сборочных команд.

MIT ★ 3 232 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add microsoft/skills --skill azure-app-onboard-prereq -a claude-code
Открыть на GitHub

Что делает azure-app-onboard-prereq

Скилл выполняет первый этап конвейера azure-app-onboard. Он проводит статический аудит репозитория, находит зависимости других облаков вроде AWS или Google Cloud и формирует вердикты PASS, WARN или FAIL для каждого компонента приложения. Результаты пишутся в файл prereq-output.json внутри каталога сессии .copilot-azure/sessions/.

Любые команды установки пакетов, тестов и сборки вроде npm install, pytest или dotnet build здесь строго запрещены. Анализ выполняется только статически, поэтому сломать окружение или запустить недоверенный код во время проверки агент не сможет.

Для полноценной работы скиллу нужна сессия на диске и авторизация через Azure CLI с вызовом az account show. Если вам требуется генерация IaC или развёртывание через azd up, перенаправляйте задачи в azure-prepare или azure-deploy.

Какие задачи решает

  • проверить готовность репозитория к деплою в Azure
  • найти блокирующие зависимости и несовместимые фреймворки
  • выявить SDK сторонних облаков перед миграцией
  • оценить полноту сборки без запуска пакетных менеджеров

Примеры запросов агенту

  • Проверь, готов ли мой репозиторий к деплою в Azure
  • Есть ли у проекта несовместимые зависимости или блокировки для деплоя?
  • Нужен ли приложению Dockerfile перед развёртыванием в Azure?

Как установить azure-app-onboard-prereq

1Через Skills CLI (Vercel)

npx skills add microsoft/skills --skill azure-app-onboard-prereq -a claude-code

2Вручную: положить файлы

~/.claude/skills/azure-app-onboard-prereq/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/azure-app-onboard-prereq/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об azure-app-onboard-prereq

Как установить azure-app-onboard-prereq в Claude Code?

Выполните команду npx skills add microsoft/skills --skill azure-app-onboard-prereq -a claude-code.

Что делает azure-app-onboard-prereq?

Скилл проводит статический аудит кодовой базы перед подготовкой облачной инфраструктуры, проверяя стек, зависимости и готовность компонентов к работе в Azure.

Почему скилл не запускает тесты и сборку проекта?

Во время этапа prereq действует строгий запрет на вызов npm install, pytest, dotnet build и любых других пакетных менеджеров. Оценка проходит исключительно через статический анализ файлов.

Исходный текст

SKILL.md · MIT
---
name: azure-app-onboard-prereq
description: "Assess whether source code is ready to deploy to Azure — the check BEFORE infrastructure work. Evaluates build health, app completeness, dependencies and local services, stack compatibility, and deployment feasibility. Answers questions about what your app needs before it can be deployed — frameworks, dependencies, and configuration. Checks whether dependencies are compatible and identifies deployment blockers and unsupported frameworks. WHEN: \"evaluate my repo\", \"is my app ready to deploy\", \"what does my app need to deploy\", \"what do I need before deploying\", \"does my app need\", \"can I ship this to Azure\", \"scan my repo for issues\", \"is this app deployable\", \"check if my app is ready for Azure\", \"do I need a Dockerfile\", \"what's blocking my deployment\", \"are there any blockers\", \"are my dependencies compatible\", \"does Azure support my framework\", \"what needs to change before deploying\", \"check my app configuration\"."
license: MIT
metadata:
  author: Microsoft
  version: "1.2.5"
---

# Azure App Onboard Prereq — Repository Evaluation

Evaluate a user's repository for build health, app completeness, and Azure deployment feasibility — before infrastructure planning. Produces per-component verdicts (PASS/WARN/FAIL) consumed by downstream phases.

> **Orchestrator relationship:** Called by `azure-app-onboard` at Step 3, or standalone for code readiness checks. When called by orchestrator, return control to `azure-app-onboard` after writing artifacts — do NOT invoke downstream phases directly.

Phase 1 of 4 in AppOnboard pipeline. Session: `.copilot-azure/sessions/{session-id}/`. Reads `context.json`. Writes `components[]`, `repo{}`, `detectedInfra[]`. Produces `prereq-output.json`. Schema: [`prereq-schemas.ts`](references/prereq-schemas.ts) — `PrereqOutput`, `BuildRequirements`. Direct entry supported.

## When NOT to Use

| Signal | Redirect |
|--------|----------|
| Validate infrastructure (Bicep/TF/azure.yaml) | **azure-validate** |
| Generate IaC | **azure-prepare** |
| End-to-end idea-to-production | **azure-app-onboard** |
| Run `azd up` or deploy | **azure-deploy** |

## Rules

> ⛔ **ABSOLUTE PROHIBITION — `npm install`, `npm test`, `npx jest`, `pytest`, and ALL install/build/test commands are NEVER allowed.**
> Under NO circumstances may you run `npm install`, `npm test`, `npx jest`, `pip install`, `pytest`, `dotnet build`, `dotnet restore`, `dotnet test`, `go mod download`, `cargo build`, or ANY package-manager install, build, or test command during the prereq phase. Do NOT run test suites to verify code — check for test config files statically instead. The prereq phase is read-only evaluation + static-only verification.
> **ONLY exception — two sanctioned contexts, both consent-gated:** (a) code the agent **modified** during migration/remediation (see [remediation-protocol.md](references/remediation-protocol.md) step 6), or (b) code the agent **wrote** from scratch on the zero-code path (see [zero-code-path.md](references/zero-code-path.md)). In either case, install/build/test runs ONLY via the user-confirmed build-validation gate ([build-check.md](references/build-check.md) Step 3), after the user answers that specific per-command consent prompt. General prior consent never counts.

1. ⛔ **Full pipeline (Steps 1–8), no exceptions.** All prompts → Step 1 directly. Answer specific questions AS PART OF findings (Step 5), not before.
2. ⛔ **No sub-agents for evaluation.** 3-axis evaluation is inline. **Exception**: zero-code-path scaffolding (Step 2).
3. Code/destructive modifications require `ask_user`. Max 3 questions before results. Direct entry: don't repeat orchestrator's intent questions.

## MCP Tools

| Tool | Purpose |
|------|---------|
| `mcp_azure_mcp_get_azure_bestpractices` | Validate detected stack patterns against Azure best practices |
| `mcp_azure_mcp_extension_cli_install` | Check/install required CLI tools (az, azd, func) |

## Workflow

### Step 1: Session Check

**Orchestrator entry:** Session exists — read `context.json`, proceed to Step 2.

**Direct entry:** Check `.copilot-azure/sessions/active-session.json`:
- **Exists** → ⛔ read [session-protocol.md](references/session-protocol.md) for resume/fresh gate. Do NOT proceed until user answers.
- **Missing** → create session: generate UUID, `New-Item -ItemType Directory -Path ".copilot-azure/sessions/{uuid}" -Force`, write `context.json` + `active-session.json` via `create` tool.

Then: `az account show` → merge `{id, name, tenantId}` into `context.json.azure`. ⛔ Session MUST exist on disk before any scanning.

### Step 2: Scan Workspace

Scan for project files. Detect components, `repo{}`, `detectedInfra[]`, `detectedServices[]`. Classify Terraform providers. Check CLI availability. Stack detection conflicts: user explicit statement wins (write to `context.json`, mark scan as override); scan-only → confirm with user; multiple stacks → show all and ask (see [component-mapping.md](references/component-mapping.md)); no code → [zero-code-path.md](references/zero-code-path.md).

> If no project files, no Dockerfile, AND no index.html → ⛔ read [zero-code-path.md](references/zero-code-path.md).

> ⛔ **Cloud SDK early gate.** Grep for `aws-sdk|@aws-sdk|boto3|google-cloud|@google-cloud|firebase`. If functional deps found → read [cloud-sdk-migration.md](references/cloud-sdk-migration.md), then `ask_user`: **"Redirect to Azure Cloud Migrate"** (set `routeToSkill: "azure-cloud-migrate"`) · **"Continue evaluation anyway"** (finish readiness eval + SDK→Azure mapping, then STOP at Step 8 — no plan until the deps are swapped) · **"Cancel"**.

### Step 3: Per-Component Evaluation

| Sub-step | Action | Reference |
|----------|--------|-----------|
| 3.1 | **Build check** | ⛔ **You MUST read [build-check.md](references/build-check.md)** |
| 3.2 | **Completeness check** | ⛔ **You MUST read [completeness-check.md](references/completeness-check.md)** |
| 3.3 | **Deployability check** | ⛔ **You MUST read [deployability-check.md](references/deployability-check.md)** |
| 3.3a | **Component mapping** (conditional) | Read [component-mapping.md](references/component-mapping.md) ONLY IF >1 project manifest found (monorepo) |

Populate `buildRequirements` per component after evaluation. Verdict propagation, tier rules, and f1Viable aggregation are in [readiness-gate.md](references/readiness-gate.md) and the individual check references.

### Step 4: Write Artifacts + Readiness Gate

⛔ Verify `context.json` exists on disk. ⛔ **You MUST read [readiness-gate.md](references/readiness-gate.md)** (verdicts, tiers, batch-then-approve, fast-track), then ⛔ **You MUST read [prereq-artifacts.md](references/prereq-artifacts.md)** (write procedures, schemas).

### Step 5: Present Findings

Per [readiness-gate.md § Present Findings](references/readiness-gate.md) — show verdicts grouped by severity before proceeding.

### Step 6: Remediation (conditional)

⛔ **You MUST read [remediation-protocol.md](references/remediation-protocol.md)** IF any ❌ FAIL verdict, 🔧 Recommended Fix, or ⚠️ WARN with `fixPhase: "prereq"` exists. Contains remediation loop, static verification, re-eval mandate, post-remediation artifact updates, and the build-validation consent gate. If all verdicts are ✅ PASS or ⚠️ WARN without `fixPhase: "prereq"`, skip to Step 7.

### Step 7: Write Final State

`completedPhases` already has `"prereq"` + `currentPhase: null` (from Step 4). Then:

> ⛔ **Write `lastScanCommit`.** Run `git rev-parse HEAD` and store the full 40-character SHA as `context.json.repo.lastScanCommit`. Required — staleness guard in Step 1 compares to HEAD on resume to detect changes.

### Step 8: Route

⛔ **Mandatory — do NOT skip this step.**

> **Routing fields:** All routing writes `routeToSkill` and `routeReason` to `context.json`.

> **Post-remediation context:** If Step 6 ran, lead the routing prompt with: "Remediation complete — {N} issues fixed, your app is now {overallHealth}."

> ⛔ **Evaluate rows top to bottom — first match wins.**

| # | Condition | Action |
|---|-----------|--------|
| 1 | `routeToSkill` set (any entry) | `ask_user`: "Redirect to {routeToSkill}" / "Not now". ⛔ Pipeline stops — do NOT proceed to architecture planning. |
| 2 | `cloudSdkFindings[]` non-empty (user chose "Continue evaluation anyway") | Present the cloud-SDK → Azure swap mapping as 🔶 blockers, then `ask_user` with this exact prompt: **"🔶 Cloud SDK migration required — these dependencies must be swapped before this app can deploy to Azure. (Redirect to azure-cloud-migrate / Stop — swap manually and re-run)"** — Redirect sets `routeToSkill: "azure-cloud-migrate"`, Stop halts. ⛔ Pipeline stops — do NOT proceed to architecture planning, and do NOT offer a "continue to prepare" option; the app can't deploy until the deps are swapped. |
| 3 | Orchestrator + no `routeToSkill` | Tell the user: "✅ Your app has been evaluated and is ready — let's plan your Azure deployment." Then invoke `azure-app-onboard`. ⛔ Do NOT stop, do NOT wait for user input, do NOT narrate internal handoffs. The user already consented to the full pipeline at scope triage. |
| 4 | Direct + ready/readyWithCaveats + no Azure infra | `ask_user`: "Deploy to Azure (full pipeline)" → invoke `azure-app-onboard` / "Not now" |
| 5 | Direct + ready/readyWithCaveats + existing Azure infra | `ask_user`: "Start fresh" → invoke `azure-app-onboard` / "Use existing infra" → invoke `azure-prepare` / "Not now" |
| 6 | Direct + blocked | Report blocker summary + "Fix and re-run." |

Severity tiers (🛑🔶❌🔧⚠️✅) are defined in [readiness-gate.md](references/readiness-gate.md).

## Outputs

| Artifact | Location | Consumer |
|----------|----------|----------|
| Session context | `context.json` → `components[]`, `repo{}`, `detectedInfra[]`, `detectedServices[]` | All downstream phases |
| Prereq output | `prereq-output.json` | prepare phase (via `azure-app-onboard`) |
| Readiness report | `.copilot-azure/sessions/{uuid}/readiness-report.md` | User (offline reference) |

© Microsoft · MIT · microsoft/skills

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
azure-app-service MicrosoftDocs Скилл с экспертными знаниями по Azure App Service: архитектура, лимиты, безопасность, развёртывание и CI/CD. Подключает документацию через MCP-сервер или веб-запросы. CX Codex +1 324установок azure-tools Fatih C. Akyon Плагин azure-tools запрашивает и администрирует ресурсы Azure прямо из чата. Включается при работе с облачной инфраструктурой через Azure CLI и встроенный Azure MCP-сервер. CX Codex ★ 1 216звёзд репо azure-well-architected MicrosoftDocs С готовыми чек-листами, принципами и рекомендациями Azure Well Architected. CX Codex +1 676установок azure-diagrams Eraser Labs Скилл azure-diagrams превращает шаблоны ARM, вывод Azure CLI и описания в схемы архитектуры. Отправляет готовый код в Eraser API и возвращает ссылку на просмотр. CX Codex +1 673установок azure-expert personamanagmentlayer Скилл azure-expert помогает проектировать архитектуру в Microsoft Azure, писать код для Azure Functions и Cosmos DB, а также генерировать команды Azure CLI. CX Codex +1 180установок azure-devops devops-skills Пишет и правит YAML-пайплайны Azure DevOps: сборка, тесты, деплой в Azure. CI/CD живёт в Azure Pipelines. CX Codex +1 360установок

Из того же набора250

Весь набор →
azure-kubernetes-app-deploy Скилл azure-kubernetes-app-deploy подготавливает контейнеры и разворачивает веб-приложения в работающий кластер Azure Kubernetes Service. Помогает настроить манифесты и пройти проверки AKS Deployment Safeguards. CX Codex +1 ★ 3 232звёзд репо azure-kubernetes Планирует и настраивает кластеры Azure Kubernetes Service: от выбора SKU и сети до безопасности, наблюдаемости и обновлений. CX Codex +1 ★ 3 232звёзд репо azure-enterprise-infra-planner Скилл azure-enterprise-infra-planner для Claude Code и GitHub Copilot планирует корпоративную инфраструктуру Azure по описанию нагрузки и генерирует Bicep или Terraform. Проектирует landing zone, hub-spoke сети и DR-топологии. CX Codex +1 ★ 3 232звёзд репо azure-app-onboard Скилл azure-app-onboard для Claude Code и GitHub Copilot планирует перенос приложения в Azure и ведёт его до развёртывания. Сначала он показывает план и смету, затем запрашивает одобрение. CX Codex +1 ★ 3 232звёзд репо airunway-aks-setup Скилл airunway-aks-setup проводит настройку AI Runway на существующем AKS-кластере: от проверки узлов до первого развёртывания модели. Подходит для GPU-инференса и провайдеров KAITO, Dynamo, KubeRay. CX Codex +1 ★ 3 232звёзд репо azure-servicebus-ts Скилл azure-servicebus-ts для Claude Code и GitHub Copilot, который добавляет агенту шаблоны работы с Azure Service Bus SDK для JavaScript. Включается при реализации очередей, топиков, подписок, сессий и обработки недоставленных сообщений. CX Codex +1 ★ 3 232звёзд репо azure-storage-queue-rust Скилл azure-storage-queue-rust обучает ИИ-ассистента писать код для Azure Queue Storage на Rust через официальный крейт azure_storage_queue. Помогает отправлять, читать и удалять сообщения. CX Codex +1 ★ 3 232звёзд репо azure-storage-queue-py Скилл azure-storage-queue-py для Claude Code и GitHub Copilot, который подключает Python SDK Azure Queue Storage. Включается, когда в коде нужно организовать очередь сообщений или асинхронную обработку задач через Azure. CX Codex +1 ★ 3 232звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой