[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M699VAZ83HGSZAEFB216YNR5":3,"skill-same:01M699VAZ83HGSZAEFB216YNR5":87},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":45,"linkOnly":46,"markdownContent":47,"markdownBody":48,"frontMatter":49,"refName":54,"commitSha":55,"skillDirectory":56,"forksCount":57,"repositoryHtmlUrl":58,"repositoryHomepageUrl":59,"ownerHtmlUrl":60,"ownerBlogUrl":61,"ownerDescription":62,"updatedAt":63,"install":64,"resources":76},"01M699VAZ83HGSZAEFB216YNR5","migrate-bootstrap",null,"Migrates a non-SPA (classic) Power Pages site from Bootstrap 3 to Bootstrap 5. Downloads the site, runs the pac pages bootstrap-migrate engine, reviews the change report, applies AI-assisted fixes for the residual hierarchy\u002FCSS changes the engine only flags, uploads the migrated site (which auto-enables the Bootstrap 5 runtime flag), verifies the flag, and validates. Use when the user wants to upgrade an older Bootstrap-3 portal to Bootstrap 5. NOT for SPA sites (React\u002FVue\u002FAngular\u002FAstro) — those are never Bootstrap-3.","microsoft\u002Fpower-platform-skills","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M699JVYJFB75D9JM70BN4H0Q",1149,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fpower-pages\u002Fskills\u002Fmigrate-bootstrap\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"migrate bootstrap","bootstrap","migrate","auto","when","hierarchy","which","reviews","spa","local","upgrade","only","never","power","css","Bash","astro","angular","power pages","change","react","2026-11-10 10:12:30",false,"---\nname: migrate-bootstrap\ndescription: >-\n  Migrates a non-SPA (classic) Power Pages site from Bootstrap 3 to Bootstrap 5. Downloads the\n  site, runs the pac pages bootstrap-migrate engine, reviews the change report, applies\n  AI-assisted fixes for the residual hierarchy\u002FCSS changes the engine only flags, uploads\n  the migrated site (which auto-enables the Bootstrap 5 runtime flag), verifies the flag,\n  and validates. Use when the user wants to upgrade an older Bootstrap-3 portal to\n  Bootstrap 5. NOT for SPA sites (React\u002FVue\u002FAngular\u002FAstro) — those are never Bootstrap-3.\nuser-invocable: true\nargument-hint: Optional website name or local site folder path\nallowed-tools: Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion, Skill, Task, TaskCreate, TaskUpdate, TaskList\nmodel: opus\n---\n\n> **Plugin check**: Run `node \"${PLUGIN_ROOT}\u002Fscripts\u002Fcheck-version.js\"` — if it outputs a message, show it to the user before proceeding.\n\n# Migrate a Non-SPA Power Pages Site from Bootstrap 3 to Bootstrap 5\n\nGuide the user through migrating a **non-SPA \u002F native** Power Pages site from Bootstrap 3\nto Bootstrap 5. Follow a systematic approach: verify tooling, acquire and back up the site,\nassess scope, run the `pac pages bootstrap-migrate` engine, review the change report, apply\nthe residual fixes the engine can only flag, upload (which auto-enables the runtime flag),\nverify, and validate.\n\n## Core Principles\n\n- **Non-SPA sites only**: This skill targets non-SPA Power Pages sites (Liquid web templates,\n  `*.webtemplate.source.html`, `*.html\u002F.aspx\u002F.ascx`, `*.css`, `sitesetting.yml`). It does **NOT**\n  apply to SPA sites (React\u002FVue\u002FAngular\u002FAstro) — they are never Bootstrap-3-based. If the target\n  is a SPA site, stop and tell the user this skill doesn't apply.\n- **The engine does the bulk; you do the residual**: `pac pages bootstrap-migrate` deterministically\n  applies the well-known class renames. The skill's value is assisting with the **hierarchy \u002F CSS\n  changes the engine only logs** (see [references\u002Fbootstrap-v5-manual-fixes.md](references\u002Fbootstrap-v5-manual-fixes.md)).\n- **Non-destructive, with a restore point**: The engine writes a **new `\u003Cfolder>V5`** copy and never\n  edits the source in place. Still, snapshot the source folder (git) before doing anything.\n- **Assist and flag — never silently rewrite**: Residual fixes are Liquid-aware and can break layouts.\n  Apply them with per-category consent; when a case is ambiguous (e.g. Liquid conditionals), flag it\n  for the user instead of guessing.\n- **Verify the runtime flag flip via `pac-log.txt`**: `pac pages upload` flips the server-side\n  Bootstrap 5 flag automatically, but **flip outcomes are logged and swallowed** by the CLI. Never\n  trust the upload exit code alone. The authoritative record is the PAC diagnostic log (`pac telemetry\n  status` → `pac-log.txt`); grep it for `BootstrapV5UploadPostProcessor`. The flip **requires an\n  active portal** — a website record with no provisioned site logs `no portal found` and skips.\n- **Use TaskCreate\u002FTaskUpdate**: Create the todo list upfront with all 8 phases before starting work.\n\n**Initial request:** $ARGUMENTS\n\n---\n\n## Phase 1: Verify Prerequisites\n\n**Goal**: Ensure PAC CLI is installed, the user is authenticated, the target environment is\nconfirmed, and the required commands are available.\n\n**Actions**:\n\n1. Create the todo list with all 8 phases (see [Progress Tracking](#progress-tracking)).\n2. Run `pac help` to confirm PAC CLI is installed and on PATH. If missing, point the user to\n   `https:\u002F\u002Faka.ms\u002FPowerPlatformCLI` (`dotnet tool install --global Microsoft.PowerApps.CLI.Tool`)\n   and re-verify.\n\u003C!-- not-a-gate: data-gathering — free-text environment URL when PAC CLI isn't authenticated; the prompt itself writes nothing -->\n\n3. Run `pac auth who`. If not authenticated, ask for the environment URL via `AskUserQuestion`,\n   then `pac auth create --environment \"\u003CURL>\"` and re-verify. Capture the environment name, URL,\n   and ID.\n\n\u003C!-- gate: migrate-bootstrap:1.confirm-env | category=consent | cancel-leaves=nothing -->\n\n> ? **Gate (consent · migrate-bootstrap:1.confirm-env):** Confirm the target environment before any download, migration, or upload. Running the migration against the wrong environment is destructive, so this confirmation is mandatory.\n\n4. Confirm the target environment with the user (`AskUserQuestion`: use this environment \u002F choose\n   another via `pac org list` + `pac org select`).\n5. **Probe command availability** — both verbs are required:\n\n   ```bash\n   pac pages help\n   ```\n\n   Confirm `bootstrap-migrate` and `upload` appear in the verb list. If either is missing (feature\n   not enabled in this CLI build \u002F tenant), stop and tell the user the migration can't proceed\n   until those commands are available.\n6. **Locate the PAC diagnostic log** — capture the path now; you will need it in Phase 7 to verify\n   the flag flip:\n\n   ```bash\n   pac telemetry status\n   ```\n\n   It prints `The diagnostic logs can be found at: \u003C…>\\logs\\pac-log.txt`. This is a **rolling log\n   across all `pac` runs** and is the **authoritative record of the Bootstrap V5 flag flip**. Note:\n   `pac pages upload` writes **no per-folder log** — `pac-log.txt` is the only place its post-processor\n   records the flip result. Set `PAC_LOG = \u003Cthat path>`.\n\n**Output**: PAC CLI verified, authenticated session, confirmed environment, `bootstrap-migrate`\nand `upload` confirmed available, `PAC_LOG` path captured.\n\n---\n\n## Phase 2: Acquire the Site & Back Up\n\n**Goal**: Get a local copy of the non-SPA site to migrate, and establish a restore point.\n\n**Actions**:\n\n### 2.1 Locate or download the site\n\n- **If the user provided a local site folder path** (or `$ARGUMENTS` names one): verify it exists\n  and looks like a downloaded non-SPA site (contains `website.yml` and `sitesetting.yml`). Use it\n  as `SITE_FOLDER`.\n- **Otherwise**: list available websites and download the chosen one.\n\n  ```bash\n  pac pages list\n  ```\n\n\u003C!-- gate: migrate-bootstrap:2.1.select-site | category=plan | cancel-leaves=nothing -->\n\n  > ? **Gate (plan · migrate-bootstrap:2.1.select-site):** Choose which website to download when more than one exists. Canceling leaves nothing changed.\n\n  Present the websites via `AskUserQuestion`, then download the selected site:\n\n  ```bash\n  pac pages download --path \"\u003CSITE_FOLDER>\" --webSiteId \"\u003CWEBSITE_ID>\"\n  ```\n\n  Use the downloaded directory as `SITE_FOLDER`.\n\n> Confirm this is a **non-SPA** site, not a SPA site. A SPA project has `powerpages.config.json`\n> and a framework `package.json`; a non-SPA site has `website.yml`, `sitesetting.yml`, and\n> `*.webtemplate.source.html` files. If it's a SPA site, stop — this skill does not apply.\n\n### 2.2 Confirm the site is ACTIVATED (not just a website record)\n\n`pac pages list` shows **website records** (`adx_website`). A website record can exist with **no\nprovisioned\u002Factive Power Pages site (portal)** behind it — created by data import\u002Fclone, deactivated,\nor orphaned. The Phase 7 flag flip (`SetPortalBootstrapV5Enabled`) targets the **portal**, not the\nwebsite record, so **if no active portal exists the flip silently skips and the live site won't\nrender** — and you won't find this out until after uploading unless you check now.\n\nResolve the site URL from `websitebinding.yml` (`adx_sitename`) and probe the **final** status code\n(`-L` follows redirects so a sign-in \u002F canonical-host redirect resolves to its real code):\n\n```bash\ncurl -sL -o \u002Fdev\u002Fnull -w \"%{http_code}\" \"https:\u002F\u002F\u003Cadx_sitename>\u002F\"\n```\n\n- **`2xx` or a redirect that resolves to `2xx`\u002F`3xx`** → active portal; proceed. A private or\n  protected site legitimately redirects to sign-in or a canonical host, so a resolved `3xx` is\n  **active**, not a failure.\n- **`4xx`\u002F`5xx`** → inconclusive from the status alone. A private site can return a non-`200` without\n  being unactivated, so **do not conclude \"not activated\" from the code alone** — fetch the error\n  body (or open the URL in a browser) to look for the unactivated signature:\n\n  ```bash\n  curl -sL \"https:\u002F\u002F\u003Cadx_sitename>\u002F\" | head -c 4000\n  ```\n\n  If the body shows a Dataverse-connection null-ref (`Object reference not set …` \u002F\n  `CrmOnlineOrganizationService.ToOrganizationService`), or the URL fails to render a portal page in\n  the browser, **the site is most likely NOT activated**. This is the same condition that makes the\n  Phase 7 flag flip log `no portal found for website \u003Cid> via Power Pages API`. A `4xx`\u002F`5xx` **without**\n  that signature is more likely an auth wall or transient error on an active site — treat as active and\n  note it for the user rather than blocking.\n\nIf the site is confirmed not active, **stop and tell the user to activate\u002Fprovision it first** (Power\nPages admin center, or the `\u002Fpower-pages:activate-site` skill). Migrating content into an unactivated\nwebsite still uploads, but the runtime flag can't flip and the site can't be verified.\n\n### 2.3 Snapshot the source\n\nCreate a restore point before any migration:\n\n```bash\ncd \"\u003CSITE_FOLDER>\"\ngit init -q && git add -A && git commit -q -m \"Pre-migration snapshot (Bootstrap 3)\"\n```\n\nIf the folder is already a git repo, just commit any pending changes so the pre-migration state\nis captured.\n\n**Output**: `SITE_FOLDER` resolved, confirmed non-SPA, source snapshot committed.\n\n---\n\n## Phase 3: Pre-Migration Assessment\n\n**Goal**: Set expectations by inventorying Bootstrap-3 usage and flagging risk areas before\nrunning the engine.\n\n**Actions**:\n\n1. Scan the site for Bootstrap-3 markers using `Grep` over `*.html`, `*.aspx`, `*.ascx`, `*.css`:\n   - Component classes: `panel`, `navbar-header`, `img-responsive`, `btn-block`, `pull-left|pull-right`,\n     `col-(xs|sm|md|lg)-`, `glyphicon`, `label-`, `page-header`, `pager`, `data-toggle|data-dismiss`.\n   - Count affected files and the rough number of occurrences per category.\n2. Flag risk areas:\n   - Heavy **custom CSS** (large `.css` files with non-Bootstrap selectors) — won't be auto-converted.\n   - **Liquid-entangled markup** (`{% ... %}` around classes, conditional dropdowns) — needs review.\n3. Present a concise scope summary and set expectations:\n\n   > \"This is an **assisted** migration. The engine will auto-apply the common Bootstrap 3→5 class\n   > renames. Some changes (grid hierarchy, navbar structure, panel\u002Fpage-header\u002Fpager styling) can\n   > only be flagged — I'll help apply those in Phase 6. Visual parity isn't guaranteed and you'll\n   > want to QA the result.\"\n\n**Output**: Scope summary presented; user understands this is assisted, not push-button.\n\n---\n\n## Phase 4: Run the Migration Engine\n\n**Goal**: Produce the migrated `\u003Cfolder>V5` copy.\n\n**Actions**:\n\n\u003C!-- gate: migrate-bootstrap:4.run-engine | category=consent | cancel-leaves=nothing -->\n\n> ? **Gate (consent · migrate-bootstrap:4.run-engine):** Explicit consent before running `pac pages bootstrap-migrate`. The engine writes a new `\u003CSITE_FOLDER>V5` copy and never edits the source, so canceling leaves nothing changed.\n\n1. Get explicit consent to run the engine (`AskUserQuestion`: \"Run the Bootstrap 5 migration on\n   `\u003CSITE_FOLDER>`? This creates a new `\u003CSITE_FOLDER>V5` copy and does not modify the original.\").\n2. Run:\n\n   ```bash\n   pac pages bootstrap-migrate --path \"\u003CSITE_FOLDER>\"\n   ```\n\n3. Confirm the engine produced **`\u003CSITE_FOLDER>V5`** containing:\n   - Rewritten `*.html \u002F *.js \u002F *.aspx \u002F *.ascx \u002F *.css` files\n   - Swapped `bootstrap.min.css` (Bootstrap 5)\n   - Updated `sitesetting.yml` with a `Site\u002FBootstrapV5Enabled` record\n   - `logs.txt` and per-file `*-diff.json`\n\n   See [references\u002Fmigration-engine-reference.md](references\u002Fmigration-engine-reference.md) for the\n   full output contract. Set `MIGRATED_FOLDER = \u003CSITE_FOLDER>V5`.\n\n**Output**: `MIGRATED_FOLDER` produced with rewritten files, swapped CSS, `logs.txt`, and diffs.\n\n---\n\n## Phase 5: Review the Change Report\n\n**Goal**: Turn `logs.txt` into a structured, grouped summary that surfaces the manual work.\n\n**Actions**:\n\n1. Read `\u003CMIGRATED_FOLDER>\u002Flogs.txt` and categorize per the format documented in the engine\n   reference. The report opens with three file lists — **no change**, **auto-applied**\n   (Replacement\u002FAddition\u002FDeletion), and **hierarchy changes** (logged only) — followed by a\n   per-file detail block (`Total Number of Changes:\u003Cn>` + change lines). Use `Grep` to count and\n   locate the work:\n\n   - `Grep` for `Need hierarchy change` → the manual hierarchy items (often **zero**).\n   - The most reliable residual signal is the **V5 output itself**: `Grep` the migrated `*.html`\n     for surviving Bootstrap-3 markers (`page-header`, `glyphicon`, `label-(info|danger|primary)`,\n     `panel-(primary|success|info|warning|danger)`, `btn-block`, `navbar-header`). Whatever the\n     engine left behind is exactly the Phase 6 work.\n\n2. Present a summary:\n   - Counts per category.\n   - The list of files with **hierarchy changes** and **CSS-dependent contextual classes** (e.g.\n     `panel-primary`) — these are the Phase 6 work items.\n\n**Output**: Grouped change summary; explicit list of residual manual items.\n\n---\n\n## Phase 6: AI-Assisted Residual Fixes\n\n**Goal**: Apply the structural \u002F CSS fixes the engine flagged but could not safely auto-apply, in\nthe `MIGRATED_FOLDER` files.\n\n> Reference recipes: [references\u002Fbootstrap-v5-manual-fixes.md](references\u002Fbootstrap-v5-manual-fixes.md)\n\n**Actions**:\n\n1. Group the residual items by category (grid hierarchy, navbar structure, panel\u002Fcard styling,\n   page-header, pager, btn-block, Liquid edge cases, partial paths).\n\u003C!-- gate: migrate-bootstrap:6.residual-fixes | category=progress | cancel-leaves=nothing -->\n\n> ? **Gate (progress · migrate-bootstrap:6.residual-fixes):** Per-category consent before applying each residual fix to the `MIGRATED_FOLDER` files. Changes are local to the V5 copy and committed per category; canceling leaves nothing outward-facing changed.\n\n2. For **each category**, get per-category consent (`AskUserQuestion`: \"Apply the `\u003Ccategory>` fixes\n   to `\u003CN>` file(s)?\"). On consent:\n   - Apply the recipe from the manual-fixes reference using `Edit`.\n   - Re-check the affected lines against the file's `*-diff.json` to confirm you didn't disturb\n     auto-applied changes.\n   - Commit per category: `git -C \"\u003CMIGRATED_FOLDER>\" add -A && git -C \"\u003CMIGRATED_FOLDER>\" commit -m \"v5 fixes: \u003Ccategory>\"`\n     (init the V5 folder as a repo first if needed). Use `-C \"\u003CMIGRATED_FOLDER>\"` on **both**\n     `add` and `commit` so they run against the V5 copy, not the current working directory.\n3. For **ambiguous \u002F Liquid-entangled** cases, do **not** rewrite — list them for the user with the\n   file and line and a suggested manual change.\n\n**Output**: Residual fixes applied (or flagged) per category, each committed; ambiguous items listed.\n\n---\n\n## Phase 7: Upload, Auto-Enable Runtime Flag, and Verify\n\n**Goal**: Upload the migrated site (which automatically flips the server-side Bootstrap 5 flag) and\n**verify** the flag actually took effect.\n\n**Actions**:\n\n### 7.1 Pre-flight the manifest\n\nThe automatic flag flip is gated on two files in `MIGRATED_FOLDER`:\n\n- `website.yml` must have a valid `adx_websiteid`.\n- `sitesetting.yml` must contain `Site\u002FBootstrapV5Enabled` with value `true`.\n\nVerify both (`Grep`\u002F`Read`). If either is missing, the flag flip silently no-ops — fix before uploading.\n\n### 7.2 Final consent gate, then upload\n\n\u003C!-- gate: migrate-bootstrap:7.2.upload | category=final | cancel-leaves=nothing -->\n\n> ? **Gate (final · migrate-bootstrap:7.2.upload):** Final sign-off before the first outward-facing change. `pac pages upload` publishes the Bootstrap 5 site and auto-enables the runtime flag. Canceling before upload leaves the live site untouched.\n\nThis is the first **outward-facing** change. Get explicit consent (`AskUserQuestion`: \"Upload\n`\u003CMIGRATED_FOLDER>` to environment `\u003CENV_NAME>`? This publishes the Bootstrap 5 site and enables the\nBootstrap 5 runtime.\"). On consent:\n\n```bash\npac pages upload --path \"\u003CMIGRATED_FOLDER>\"\n```\n\nLeave `--modelVersion` at its default (`Standard`) for a non-SPA site. `pac pages upload` uploads the\ncontent **and** auto-flips the server-side Bootstrap 5 flag via its post-processor (triggered by the\n`Site\u002FBootstrapV5Enabled=true` setting).\n\n> Use `pac pages upload` — **not** `upload-code-site` (that is the SPA path and will corrupt a\n> non-SPA site).\n\n### 7.3 Verify the flag flip (mandatory)\n\nThe CLI logs and **swallows** flag-flip outcomes, so a successful upload does **not** prove the\nruntime is on Bootstrap 5. **The authoritative record is `pac-log.txt`** (the `PAC_LOG` path captured\nin Phase 1), not the live site. Check it **first** — it is decisive in seconds, whereas the live\nsite can be misleading (an unactivated site throws a 500 that has nothing to do with Bootstrap):\n\n```bash\n# grep the PAC diagnostic log for the post-processor's result (most recent run is last)\ngrep -iE \"BootstrapV5UploadPostProcessor|SetPortalBootstrapV5Enabled\" \"\u003CPAC_LOG>\"\n```\n\nThree possible outcomes:\n\n| Log line | Meaning | Action |\n|----------|---------|--------|\n| `Set … BootstrapV5Enabled` \u002F success (`INF`) | Flip **applied** | ✅ Proceed; optionally confirm on the live site. |\n| `Skipping SetPortalBootstrapV5Enabled: no portal found for website \u003Cid> via Power Pages API` (`WRN`) | **No active portal** — flip never attempted | ❌ The site isn't activated. Activate it (see Phase 2.2 \u002F `\u002Fpower-pages:activate-site`), then re-run `pac pages upload`. |\n| `ERR`\u002Fexception from the post-processor | Flip **attempted but failed** (auth\u002FHTTP) | ❌ Re-confirm 7.1 manifest + permissions, then re-run upload. |\n\nThen **corroborate on the live site** (only meaningful if the log shows *applied*): re-render a known\npage and confirm the Bootstrap 5 bundle is served, or re-confirm the portal's Bootstrap V5 enabled\nstate via the Power Pages management surface. If the live URL returns a `5xx` with a Dataverse-connection\nnull-ref (`CrmOnlineOrganizationService.ToOrganizationService`), that is the **\"site not activated\"**\nsignature — match it against the log's `no portal found` line rather than treating it as a transient\nrestart.\n\n**Output**: Migrated site uploaded; flag-flip outcome read from `pac-log.txt` (applied \u002F skipped-no-portal\n\u002F errored) and, when applied, confirmed on the live site.\n\n---\n\n## Phase 8: Validate & Summarize\n\n**Goal**: Confirm the live site works on Bootstrap 5 and record the outcome.\n\n**Actions**:\n\n1. **Runtime smoke test** — invoke `\u002Ftest-site` against the site URL to crawl key pages, verify they\n   render, and capture console\u002Fnetwork errors.\n2. **Before\u002Fafter visual check** — spot-check the highest-traffic pages (home, navbar, any\n   panels\u002Fcards, forms, pagination) for layout regressions introduced by the migration.\n3. **Record skill usage** — follow `${PLUGIN_ROOT}\u002Freferences\u002Fskill-tracking-reference.md`, passing\n   `--projectRoot \"\u003CMIGRATED_FOLDER>\"` (the folder containing `powerpages.config.json`) and\n   `--skillName \"MigrateBootstrap\"`. Tracking only writes when the project is a **SPA site**\n   (`.powerpages-site\u002Fsite-settings\u002F` exists); for a non-SPA\u002Fnative download the script exits\n   silently as a no-op — that is expected, so call it unconditionally and don't treat the no-op as an\n   error. If tracking files are written, include them in the final commit.\n4. **Summary** — present:\n   - Files changed per category (auto-applied vs assisted vs flagged-for-manual).\n   - Residual items that still need human attention.\n   - Confirmation the Bootstrap 5 runtime flag is enabled.\n   - Location of the source snapshot (for rollback) and `MIGRATED_FOLDER`.\n5. **Suggest next steps** — manual QA pass, `\u002Ftest-site` re-runs, and (if promoting across\n   environments) the ALM skills (`\u002Fplan-alm`).\n\n**Output**: Site validated on Bootstrap 5, usage recorded, summary + residual list presented.\n\n---\n\n## Important Notes\n\n### Throughout All Phases\n\n- **Use TaskCreate\u002FTaskUpdate** to track progress at every phase.\n- **Ask for user confirmation** at the key decision points (below).\n- **Present errors clearly** — show the relevant command output and explain it before suggesting fixes.\n- **No automated rollback** after upload — rely on the Phase 2 source snapshot; report failures and\n  continue\u002Ftriage rather than auto-reverting.\n\n### Key Decision Points (Wait for User)\n\n1. Phase 1: If not authenticated, get environment URL; confirm\u002Fswitch target environment.\n2. Phase 2: If multiple sites, which website to download; confirm non-SPA (not code) site.\n3. Phase 4: Consent to run the migration engine.\n4. Phase 6: Per-category consent before applying residual fixes.\n5. Phase 7: Final consent before uploading (outward-facing).\n\n### Progress Tracking\n\nBefore starting Phase 1, create a task list with all phases using `TaskCreate`:\n\n| Task subject | activeForm | Description |\n|-------------|------------|-------------|\n| Verify prerequisites | Verifying prerequisites | PAC CLI, auth, environment, and command availability (`bootstrap-migrate`, `upload`) |\n| Acquire site and back up | Acquiring site | Download\u002Flocate the non-SPA site; snapshot the source |\n| Pre-migration assessment | Assessing scope | Inventory Bootstrap-3 usage; flag custom CSS \u002F Liquid risk |\n| Run migration engine | Running migration | `pac pages bootstrap-migrate` → `\u003Cfolder>V5` |\n| Review change report | Reviewing report | Parse `logs.txt`; group auto-applied vs hierarchy\u002Fmanual |\n| Apply residual fixes | Applying fixes | Per-category assisted fixes for the flagged hierarchy\u002FCSS items |\n| Upload and verify flag | Uploading and verifying | `pac pages upload`; verify the Bootstrap 5 runtime flag flipped |\n| Validate and summarize | Validating | `\u002Ftest-site`, visual check, record usage, summary |\n\nMark each task `in_progress` when starting and `completed` when done via `TaskUpdate`.\n\n---\n\n**Begin with Phase 1: Verify Prerequisites**\n","> **Plugin check**: Run `node \"${PLUGIN_ROOT}\u002Fscripts\u002Fcheck-version.js\"` — if it outputs a message, show it to the user before proceeding.\n\n# Migrate a Non-SPA Power Pages Site from Bootstrap 3 to Bootstrap 5\n\nGuide the user through migrating a **non-SPA \u002F native** Power Pages site from Bootstrap 3\nto Bootstrap 5. Follow a systematic approach: verify tooling, acquire and back up the site,\nassess scope, run the `pac pages bootstrap-migrate` engine, review the change report, apply\nthe residual fixes the engine can only flag, upload (which auto-enables the runtime flag),\nverify, and validate.\n\n## Core Principles\n\n- **Non-SPA sites only**: This skill targets non-SPA Power Pages sites (Liquid web templates,\n  `*.webtemplate.source.html`, `*.html\u002F.aspx\u002F.ascx`, `*.css`, `sitesetting.yml`). It does **NOT**\n  apply to SPA sites (React\u002FVue\u002FAngular\u002FAstro) — they are never Bootstrap-3-based. If the target\n  is a SPA site, stop and tell the user this skill doesn't apply.\n- **The engine does the bulk; you do the residual**: `pac pages bootstrap-migrate` deterministically\n  applies the well-known class renames. The skill's value is assisting with the **hierarchy \u002F CSS\n  changes the engine only logs** (see [references\u002Fbootstrap-v5-manual-fixes.md](references\u002Fbootstrap-v5-manual-fixes.md)).\n- **Non-destructive, with a restore point**: The engine writes a **new `\u003Cfolder>V5`** copy and never\n  edits the source in place. Still, snapshot the source folder (git) before doing anything.\n- **Assist and flag — never silently rewrite**: Residual fixes are Liquid-aware and can break layouts.\n  Apply them with per-category consent; when a case is ambiguous (e.g. Liquid conditionals), flag it\n  for the user instead of guessing.\n- **Verify the runtime flag flip via `pac-log.txt`**: `pac pages upload` flips the server-side\n  Bootstrap 5 flag automatically, but **flip outcomes are logged and swallowed** by the CLI. Never\n  trust the upload exit code alone. The authoritative record is the PAC diagnostic log (`pac telemetry\n  status` → `pac-log.txt`); grep it for `BootstrapV5UploadPostProcessor`. The flip **requires an\n  active portal** — a website record with no provisioned site logs `no portal found` and skips.\n- **Use TaskCreate\u002FTaskUpdate**: Create the todo list upfront with all 8 phases before starting work.\n\n**Initial request:** $ARGUMENTS\n\n---\n\n## Phase 1: Verify Prerequisites\n\n**Goal**: Ensure PAC CLI is installed, the user is authenticated, the target environment is\nconfirmed, and the required commands are available.\n\n**Actions**:\n\n1. Create the todo list with all 8 phases (see [Progress Tracking](#progress-tracking)).\n2. Run `pac help` to confirm PAC CLI is installed and on PATH. If missing, point the user to\n   `https:\u002F\u002Faka.ms\u002FPowerPlatformCLI` (`dotnet tool install --global Microsoft.PowerApps.CLI.Tool`)\n   and re-verify.\n\u003C!-- not-a-gate: data-gathering — free-text environment URL when PAC CLI isn't authenticated; the prompt itself writes nothing -->\n\n3. Run `pac auth who`. If not authenticated, ask for the environment URL via `AskUserQuestion`,\n   then `pac auth create --environment \"\u003CURL>\"` and re-verify. Capture the environment name, URL,\n   and ID.\n\n\u003C!-- gate: migrate-bootstrap:1.confirm-env | category=consent | cancel-leaves=nothing -->\n\n> ? **Gate (consent · migrate-bootstrap:1.confirm-env):** Confirm the target environment before any download, migration, or upload. Running the migration against the wrong environment is destructive, so this confirmation is mandatory.\n\n4. Confirm the target environment with the user (`AskUserQuestion`: use this environment \u002F choose\n   another via `pac org list` + `pac org select`).\n5. **Probe command availability** — both verbs are required:\n\n   ```bash\n   pac pages help\n   ```\n\n   Confirm `bootstrap-migrate` and `upload` appear in the verb list. If either is missing (feature\n   not enabled in this CLI build \u002F tenant), stop and tell the user the migration can't proceed\n   until those commands are available.\n6. **Locate the PAC diagnostic log** — capture the path now; you will need it in Phase 7 to verify\n   the flag flip:\n\n   ```bash\n   pac telemetry status\n   ```\n\n   It prints `The diagnostic logs can be found at: \u003C…>\\logs\\pac-log.txt`. This is a **rolling log\n   across all `pac` runs** and is the **authoritative record of the Bootstrap V5 flag flip**. Note:\n   `pac pages upload` writes **no per-folder log** — `pac-log.txt` is the only place its post-processor\n   records the flip result. Set `PAC_LOG = \u003Cthat path>`.\n\n**Output**: PAC CLI verified, authenticated session, confirmed environment, `bootstrap-migrate`\nand `upload` confirmed available, `PAC_LOG` path captured.\n\n---\n\n## Phase 2: Acquire the Site & Back Up\n\n**Goal**: Get a local copy of the non-SPA site to migrate, and establish a restore point.\n\n**Actions**:\n\n### 2.1 Locate or download the site\n\n- **If the user provided a local site folder path** (or `$ARGUMENTS` names one): verify it exists\n  and looks like a downloaded non-SPA site (contains `website.yml` and `sitesetting.yml`). Use it\n  as `SITE_FOLDER`.\n- **Otherwise**: list available websites and download the chosen one.\n\n  ```bash\n  pac pages list\n  ```\n\n\u003C!-- gate: migrate-bootstrap:2.1.select-site | category=plan | cancel-leaves=nothing -->\n\n  > ? **Gate (plan · migrate-bootstrap:2.1.select-site):** Choose which website to download when more than one exists. Canceling leaves nothing changed.\n\n  Present the websites via `AskUserQuestion`, then download the selected site:\n\n  ```bash\n  pac pages download --path \"\u003CSITE_FOLDER>\" --webSiteId \"\u003CWEBSITE_ID>\"\n  ```\n\n  Use the downloaded directory as `SITE_FOLDER`.\n\n> Confirm this is a **non-SPA** site, not a SPA site. A SPA project has `powerpages.config.json`\n> and a framework `package.json`; a non-SPA site has `website.yml`, `sitesetting.yml`, and\n> `*.webtemplate.source.html` files. If it's a SPA site, stop — this skill does not apply.\n\n### 2.2 Confirm the site is ACTIVATED (not just a website record)\n\n`pac pages list` shows **website records** (`adx_website`). A website record can exist with **no\nprovisioned\u002Factive Power Pages site (portal)** behind it — created by data import\u002Fclone, deactivated,\nor orphaned. The Phase 7 flag flip (`SetPortalBootstrapV5Enabled`) targets the **portal**, not the\nwebsite record, so **if no active portal exists the flip silently skips and the live site won't\nrender** — and you won't find this out until after uploading unless you check now.\n\nResolve the site URL from `websitebinding.yml` (`adx_sitename`) and probe the **final** status code\n(`-L` follows redirects so a sign-in \u002F canonical-host redirect resolves to its real code):\n\n```bash\ncurl -sL -o \u002Fdev\u002Fnull -w \"%{http_code}\" \"https:\u002F\u002F\u003Cadx_sitename>\u002F\"\n```\n\n- **`2xx` or a redirect that resolves to `2xx`\u002F`3xx`** → active portal; proceed. A private or\n  protected site legitimately redirects to sign-in or a canonical host, so a resolved `3xx` is\n  **active**, not a failure.\n- **`4xx`\u002F`5xx`** → inconclusive from the status alone. A private site can return a non-`200` without\n  being unactivated, so **do not conclude \"not activated\" from the code alone** — fetch the error\n  body (or open the URL in a browser) to look for the unactivated signature:\n\n  ```bash\n  curl -sL \"https:\u002F\u002F\u003Cadx_sitename>\u002F\" | head -c 4000\n  ```\n\n  If the body shows a Dataverse-connection null-ref (`Object reference not set …` \u002F\n  `CrmOnlineOrganizationService.ToOrganizationService`), or the URL fails to render a portal page in\n  the browser, **the site is most likely NOT activated**. This is the same condition that makes the\n  Phase 7 flag flip log `no portal found for website \u003Cid> via Power Pages API`. A `4xx`\u002F`5xx` **without**\n  that signature is more likely an auth wall or transient error on an active site — treat as active and\n  note it for the user rather than blocking.\n\nIf the site is confirmed not active, **stop and tell the user to activate\u002Fprovision it first** (Power\nPages admin center, or the `\u002Fpower-pages:activate-site` skill). Migrating content into an unactivated\nwebsite still uploads, but the runtime flag can't flip and the site can't be verified.\n\n### 2.3 Snapshot the source\n\nCreate a restore point before any migration:\n\n```bash\ncd \"\u003CSITE_FOLDER>\"\ngit init -q && git add -A && git commit -q -m \"Pre-migration snapshot (Bootstrap 3)\"\n```\n\nIf the folder is already a git repo, just commit any pending changes so the pre-migration state\nis captured.\n\n**Output**: `SITE_FOLDER` resolved, confirmed non-SPA, source snapshot committed.\n\n---\n\n## Phase 3: Pre-Migration Assessment\n\n**Goal**: Set expectations by inventorying Bootstrap-3 usage and flagging risk areas before\nrunning the engine.\n\n**Actions**:\n\n1. Scan the site for Bootstrap-3 markers using `Grep` over `*.html`, `*.aspx`, `*.ascx`, `*.css`:\n   - Component classes: `panel`, `navbar-header`, `img-responsive`, `btn-block`, `pull-left|pull-right`,\n     `col-(xs|sm|md|lg)-`, `glyphicon`, `label-`, `page-header`, `pager`, `data-toggle|data-dismiss`.\n   - Count affected files and the rough number of occurrences per category.\n2. Flag risk areas:\n   - Heavy **custom CSS** (large `.css` files with non-Bootstrap selectors) — won't be auto-converted.\n   - **Liquid-entangled markup** (`{% ... %}` around classes, conditional dropdowns) — needs review.\n3. Present a concise scope summary and set expectations:\n\n   > \"This is an **assisted** migration. The engine will auto-apply the common Bootstrap 3→5 class\n   > renames. Some changes (grid hierarchy, navbar structure, panel\u002Fpage-header\u002Fpager styling) can\n   > only be flagged — I'll help apply those in Phase 6. Visual parity isn't guaranteed and you'll\n   > want to QA the result.\"\n\n**Output**: Scope summary presented; user understands this is assisted, not push-button.\n\n---\n\n## Phase 4: Run the Migration Engine\n\n**Goal**: Produce the migrated `\u003Cfolder>V5` copy.\n\n**Actions**:\n\n\u003C!-- gate: migrate-bootstrap:4.run-engine | category=consent | cancel-leaves=nothing -->\n\n> ? **Gate (consent · migrate-bootstrap:4.run-engine):** Explicit consent before running `pac pages bootstrap-migrate`. The engine writes a new `\u003CSITE_FOLDER>V5` copy and never edits the source, so canceling leaves nothing changed.\n\n1. Get explicit consent to run the engine (`AskUserQuestion`: \"Run the Bootstrap 5 migration on\n   `\u003CSITE_FOLDER>`? This creates a new `\u003CSITE_FOLDER>V5` copy and does not modify the original.\").\n2. Run:\n\n   ```bash\n   pac pages bootstrap-migrate --path \"\u003CSITE_FOLDER>\"\n   ```\n\n3. Confirm the engine produced **`\u003CSITE_FOLDER>V5`** containing:\n   - Rewritten `*.html \u002F *.js \u002F *.aspx \u002F *.ascx \u002F *.css` files\n   - Swapped `bootstrap.min.css` (Bootstrap 5)\n   - Updated `sitesetting.yml` with a `Site\u002FBootstrapV5Enabled` record\n   - `logs.txt` and per-file `*-diff.json`\n\n   See [references\u002Fmigration-engine-reference.md](references\u002Fmigration-engine-reference.md) for the\n   full output contract. Set `MIGRATED_FOLDER = \u003CSITE_FOLDER>V5`.\n\n**Output**: `MIGRATED_FOLDER` produced with rewritten files, swapped CSS, `logs.txt`, and diffs.\n\n---\n\n## Phase 5: Review the Change Report\n\n**Goal**: Turn `logs.txt` into a structured, grouped summary that surfaces the manual work.\n\n**Actions**:\n\n1. Read `\u003CMIGRATED_FOLDER>\u002Flogs.txt` and categorize per the format documented in the engine\n   reference. The report opens with three file lists — **no change**, **auto-applied**\n   (Replacement\u002FAddition\u002FDeletion), and **hierarchy changes** (logged only) — followed by a\n   per-file detail block (`Total Number of Changes:\u003Cn>` + change lines). Use `Grep` to count and\n   locate the work:\n\n   - `Grep` for `Need hierarchy change` → the manual hierarchy items (often **zero**).\n   - The most reliable residual signal is the **V5 output itself**: `Grep` the migrated `*.html`\n     for surviving Bootstrap-3 markers (`page-header`, `glyphicon`, `label-(info|danger|primary)`,\n     `panel-(primary|success|info|warning|danger)`, `btn-block`, `navbar-header`). Whatever the\n     engine left behind is exactly the Phase 6 work.\n\n2. Present a summary:\n   - Counts per category.\n   - The list of files with **hierarchy changes** and **CSS-dependent contextual classes** (e.g.\n     `panel-primary`) — these are the Phase 6 work items.\n\n**Output**: Grouped change summary; explicit list of residual manual items.\n\n---\n\n## Phase 6: AI-Assisted Residual Fixes\n\n**Goal**: Apply the structural \u002F CSS fixes the engine flagged but could not safely auto-apply, in\nthe `MIGRATED_FOLDER` files.\n\n> Reference recipes: [references\u002Fbootstrap-v5-manual-fixes.md](references\u002Fbootstrap-v5-manual-fixes.md)\n\n**Actions**:\n\n1. Group the residual items by category (grid hierarchy, navbar structure, panel\u002Fcard styling,\n   page-header, pager, btn-block, Liquid edge cases, partial paths).\n\u003C!-- gate: migrate-bootstrap:6.residual-fixes | category=progress | cancel-leaves=nothing -->\n\n> ? **Gate (progress · migrate-bootstrap:6.residual-fixes):** Per-category consent before applying each residual fix to the `MIGRATED_FOLDER` files. Changes are local to the V5 copy and committed per category; canceling leaves nothing outward-facing changed.\n\n2. For **each category**, get per-category consent (`AskUserQuestion`: \"Apply the `\u003Ccategory>` fixes\n   to `\u003CN>` file(s)?\"). On consent:\n   - Apply the recipe from the manual-fixes reference using `Edit`.\n   - Re-check the affected lines against the file's `*-diff.json` to confirm you didn't disturb\n     auto-applied changes.\n   - Commit per category: `git -C \"\u003CMIGRATED_FOLDER>\" add -A && git -C \"\u003CMIGRATED_FOLDER>\" commit -m \"v5 fixes: \u003Ccategory>\"`\n     (init the V5 folder as a repo first if needed). Use `-C \"\u003CMIGRATED_FOLDER>\"` on **both**\n     `add` and `commit` so they run against the V5 copy, not the current working directory.\n3. For **ambiguous \u002F Liquid-entangled** cases, do **not** rewrite — list them for the user with the\n   file and line and a suggested manual change.\n\n**Output**: Residual fixes applied (or flagged) per category, each committed; ambiguous items listed.\n\n---\n\n## Phase 7: Upload, Auto-Enable Runtime Flag, and Verify\n\n**Goal**: Upload the migrated site (which automatically flips the server-side Bootstrap 5 flag) and\n**verify** the flag actually took effect.\n\n**Actions**:\n\n### 7.1 Pre-flight the manifest\n\nThe automatic flag flip is gated on two files in `MIGRATED_FOLDER`:\n\n- `website.yml` must have a valid `adx_websiteid`.\n- `sitesetting.yml` must contain `Site\u002FBootstrapV5Enabled` with value `true`.\n\nVerify both (`Grep`\u002F`Read`). If either is missing, the flag flip silently no-ops — fix before uploading.\n\n### 7.2 Final consent gate, then upload\n\n\u003C!-- gate: migrate-bootstrap:7.2.upload | category=final | cancel-leaves=nothing -->\n\n> ? **Gate (final · migrate-bootstrap:7.2.upload):** Final sign-off before the first outward-facing change. `pac pages upload` publishes the Bootstrap 5 site and auto-enables the runtime flag. Canceling before upload leaves the live site untouched.\n\nThis is the first **outward-facing** change. Get explicit consent (`AskUserQuestion`: \"Upload\n`\u003CMIGRATED_FOLDER>` to environment `\u003CENV_NAME>`? This publishes the Bootstrap 5 site and enables the\nBootstrap 5 runtime.\"). On consent:\n\n```bash\npac pages upload --path \"\u003CMIGRATED_FOLDER>\"\n```\n\nLeave `--modelVersion` at its default (`Standard`) for a non-SPA site. `pac pages upload` uploads the\ncontent **and** auto-flips the server-side Bootstrap 5 flag via its post-processor (triggered by the\n`Site\u002FBootstrapV5Enabled=true` setting).\n\n> Use `pac pages upload` — **not** `upload-code-site` (that is the SPA path and will corrupt a\n> non-SPA site).\n\n### 7.3 Verify the flag flip (mandatory)\n\nThe CLI logs and **swallows** flag-flip outcomes, so a successful upload does **not** prove the\nruntime is on Bootstrap 5. **The authoritative record is `pac-log.txt`** (the `PAC_LOG` path captured\nin Phase 1), not the live site. Check it **first** — it is decisive in seconds, whereas the live\nsite can be misleading (an unactivated site throws a 500 that has nothing to do with Bootstrap):\n\n```bash\n# grep the PAC diagnostic log for the post-processor's result (most recent run is last)\ngrep -iE \"BootstrapV5UploadPostProcessor|SetPortalBootstrapV5Enabled\" \"\u003CPAC_LOG>\"\n```\n\nThree possible outcomes:\n\n| Log line | Meaning | Action |\n|----------|---------|--------|\n| `Set … BootstrapV5Enabled` \u002F success (`INF`) | Flip **applied** | ✅ Proceed; optionally confirm on the live site. |\n| `Skipping SetPortalBootstrapV5Enabled: no portal found for website \u003Cid> via Power Pages API` (`WRN`) | **No active portal** — flip never attempted | ❌ The site isn't activated. Activate it (see Phase 2.2 \u002F `\u002Fpower-pages:activate-site`), then re-run `pac pages upload`. |\n| `ERR`\u002Fexception from the post-processor | Flip **attempted but failed** (auth\u002FHTTP) | ❌ Re-confirm 7.1 manifest + permissions, then re-run upload. |\n\nThen **corroborate on the live site** (only meaningful if the log shows *applied*): re-render a known\npage and confirm the Bootstrap 5 bundle is served, or re-confirm the portal's Bootstrap V5 enabled\nstate via the Power Pages management surface. If the live URL returns a `5xx` with a Dataverse-connection\nnull-ref (`CrmOnlineOrganizationService.ToOrganizationService`), that is the **\"site not activated\"**\nsignature — match it against the log's `no portal found` line rather than treating it as a transient\nrestart.\n\n**Output**: Migrated site uploaded; flag-flip outcome read from `pac-log.txt` (applied \u002F skipped-no-portal\n\u002F errored) and, when applied, confirmed on the live site.\n\n---\n\n## Phase 8: Validate & Summarize\n\n**Goal**: Confirm the live site works on Bootstrap 5 and record the outcome.\n\n**Actions**:\n\n1. **Runtime smoke test** — invoke `\u002Ftest-site` against the site URL to crawl key pages, verify they\n   render, and capture console\u002Fnetwork errors.\n2. **Before\u002Fafter visual check** — spot-check the highest-traffic pages (home, navbar, any\n   panels\u002Fcards, forms, pagination) for layout regressions introduced by the migration.\n3. **Record skill usage** — follow `${PLUGIN_ROOT}\u002Freferences\u002Fskill-tracking-reference.md`, passing\n   `--projectRoot \"\u003CMIGRATED_FOLDER>\"` (the folder containing `powerpages.config.json`) and\n   `--skillName \"MigrateBootstrap\"`. Tracking only writes when the project is a **SPA site**\n   (`.powerpages-site\u002Fsite-settings\u002F` exists); for a non-SPA\u002Fnative download the script exits\n   silently as a no-op — that is expected, so call it unconditionally and don't treat the no-op as an\n   error. If tracking files are written, include them in the final commit.\n4. **Summary** — present:\n   - Files changed per category (auto-applied vs assisted vs flagged-for-manual).\n   - Residual items that still need human attention.\n   - Confirmation the Bootstrap 5 runtime flag is enabled.\n   - Location of the source snapshot (for rollback) and `MIGRATED_FOLDER`.\n5. **Suggest next steps** — manual QA pass, `\u002Ftest-site` re-runs, and (if promoting across\n   environments) the ALM skills (`\u002Fplan-alm`).\n\n**Output**: Site validated on Bootstrap 5, usage recorded, summary + residual list presented.\n\n---\n\n## Important Notes\n\n### Throughout All Phases\n\n- **Use TaskCreate\u002FTaskUpdate** to track progress at every phase.\n- **Ask for user confirmation** at the key decision points (below).\n- **Present errors clearly** — show the relevant command output and explain it before suggesting fixes.\n- **No automated rollback** after upload — rely on the Phase 2 source snapshot; report failures and\n  continue\u002Ftriage rather than auto-reverting.\n\n### Key Decision Points (Wait for User)\n\n1. Phase 1: If not authenticated, get environment URL; confirm\u002Fswitch target environment.\n2. Phase 2: If multiple sites, which website to download; confirm non-SPA (not code) site.\n3. Phase 4: Consent to run the migration engine.\n4. Phase 6: Per-category consent before applying residual fixes.\n5. Phase 7: Final consent before uploading (outward-facing).\n\n### Progress Tracking\n\nBefore starting Phase 1, create a task list with all phases using `TaskCreate`:\n\n| Task subject | activeForm | Description |\n|-------------|------------|-------------|\n| Verify prerequisites | Verifying prerequisites | PAC CLI, auth, environment, and command availability (`bootstrap-migrate`, `upload`) |\n| Acquire site and back up | Acquiring site | Download\u002Flocate the non-SPA site; snapshot the source |\n| Pre-migration assessment | Assessing scope | Inventory Bootstrap-3 usage; flag custom CSS \u002F Liquid risk |\n| Run migration engine | Running migration | `pac pages bootstrap-migrate` → `\u003Cfolder>V5` |\n| Review change report | Reviewing report | Parse `logs.txt`; group auto-applied vs hierarchy\u002Fmanual |\n| Apply residual fixes | Applying fixes | Per-category assisted fixes for the flagged hierarchy\u002FCSS items |\n| Upload and verify flag | Uploading and verifying | `pac pages upload`; verify the Bootstrap 5 runtime flag flipped |\n| Validate and summarize | Validating | `\u002Ftest-site`, visual check, record usage, summary |\n\nMark each task `in_progress` when starting and `completed` when done via `TaskUpdate`.\n\n---\n\n**Begin with Phase 1: Verify Prerequisites**\n",{"name":5,"model":50,"description":7,"allowed-tools":51,"argument-hint":52,"user-invocable":53},"opus","Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion, Skill, Task, TaskCreate, TaskUpdate, TaskList","Optional website name or local site folder path",true,"main","0a55a88fa2855404029d1e5450faf92878baf763","plugins\u002Fpower-pages\u002Fskills\u002Fmigrate-bootstrap",232,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills","https:\u002F\u002Fmicrosoft.github.io\u002Fpower-platform-skills\u002F","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-14 21:46:39",{"source":8,"skillName":5,"commands":65,"prompt":75,"zipAvailable":53},[66,69,72],{"tool":67,"command":68},"npx","npx skills add microsoft\u002Fpower-platform-skills --skill migrate-bootstrap",{"tool":70,"command":71},"bunx","bunx skills add microsoft\u002Fpower-platform-skills --skill migrate-bootstrap",{"tool":73,"command":74},"pnpm","pnpm dlx skills add microsoft\u002Fpower-platform-skills --skill migrate-bootstrap","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fpower-pages\u002Fskills\u002Fmigrate-bootstrap\u002FSKILL.md",[77,83],{"path":78,"resourceType":79,"resourceTypeDesc":80,"sizeBytes":81,"sourceHtmlUrl":82},"references\u002Fbootstrap-v5-manual-fixes.md","REFERENCE","参考文档",8938,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fpower-pages\u002Fskills\u002Fmigrate-bootstrap\u002Freferences\u002Fbootstrap-v5-manual-fixes.md",{"path":84,"resourceType":79,"resourceTypeDesc":80,"sizeBytes":85,"sourceHtmlUrl":86},"references\u002Fmigration-engine-reference.md",7039,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fpower-pages\u002Fskills\u002Fmigrate-bootstrap\u002Freferences\u002Fmigration-engine-reference.md",[88,96,116,139,157,171],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":95},"01M78JN2BFRRV1J54Q6WKZQ08D","compare-site-configurations","Compare Power Pages site configurations between two environments, such as dev, test and production, or between a local download and the live site, and explain which differences change site behavior. Use when a site works in one environment but not another (for example, works in dev but fails in test), to check configuration drift before promoting or deploying, or to see what changed between two sites. Produces a shareable HTML report and a JSON file that VS Code can import.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fpower-pages\u002Fskills\u002Fcompare-site-configurations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":45},"01M699WVHX0XN59EPBTTPEKYPG","setup","Use when Process Intelligence needs building, explicit cloud\u002Faccount\u002Fenvironment configuration, sign-in, connection diagnostics, or recovery from an authentication error.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fprocess-intelligence\u002Fskills\u002Fsetup\u002FSKILL.md",[],[98,103,104,105,106,107,28,108,109,110,39,111,112,113,114,115],"configuration","diagnostics","error","environment","cloud","connection","authentication","use","recovery","process","sign","read","intelligence",{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":127,"publishedAt":45},"01M699WSR9EX55YY1WD9J22FEG","report-issue","Use when the user wants a Process Intelligence bug-report draft or support summary for a failed operation.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fprocess-intelligence\u002Fskills\u002Freport-issue\u002FSKILL.md",[122],{"categoryNo":123,"categoryName":124,"taxonomyType":125,"taxonomyTypeDesc":126},"01JBSEEDCAT000000000000034","行政与办公人员","PROFESSION","适用职业",[128,129,130,131,110,28,132,133,112,134,115,135,136,137,138],"issue","report","report issue","bug-report","operation","draft","bug","summary","user","for","support",{"skillNo":140,"name":141,"nameZh":6,"description":142,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":143,"categories":144,"keywords":145,"publishedAt":45},"01M699WR26YQ9Q21KE6MJF5B2G","investigate-process","Use when a broad Process Mining business question, observed pattern or competing explanation needs investigation across analytical perspectives.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fprocess-intelligence\u002Fskills\u002Finvestigate-process\u002FSKILL.md",[],[146,112,147,148,110,149,150,28,151,152,153,114,154,155,156],"investigate","investigate process","question","process mining","business","across","perspectives","mining","pattern","investigation","analytical",{"skillNo":158,"name":159,"nameZh":6,"description":160,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":161,"categories":162,"keywords":163,"publishedAt":45},"01M699WP9SDG5ZR12P8VYNXKTN","derive-metric","Use when a requested measure is missing, a saved custom metric needs reuse, or an ephemeral formula or derived scalar is needed.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fprocess-intelligence\u002Fskills\u002Fderive-metric\u002FSKILL.md",[],[164,165,166,167,168,169,110,28,170,114],"metric","derive metric","missing","formula","custom","reuse","saved",{"skillNo":172,"name":173,"nameZh":6,"description":174,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":175,"categories":176,"keywords":177,"publishedAt":45},"01M699WMG5R8P6SMTDAS1TKF9E","compare-cohorts","Use when comparing process cohorts, departments, periods or before-and-after results under matched definitions.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fprocess-intelligence\u002Fskills\u002Fcompare-cohorts\u002FSKILL.md",[],[178,179,110,28,180,112,114],"compare","compare cohorts","results"]