[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CT573BNEXZP99WE3J2QDXY":3,"skill-same:01M7CT573BNEXZP99WE3J2QDXY":63},{"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":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7CT573BNEXZP99WE3J2QDXY","vmr-codeflow-status",null,"Analyze VMR codeflow PR status for dotnet repositories. Use when investigating stale codeflow PRs, checking if fixes have flowed through the VMR pipeline, debugging dependency update issues in PRs authored by dotnet-maestro[bot], checking overall flow status for a repo, or diagnosing why backflow PRs are missing or blocked.","YYC-Cube\u002FYYC3-Knowledge-Base","YYC-Cube","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F235006543?v=4","01M79J2PH4SWD2X0825X6PN748","yyc3","01M79J2PHVK3F6ZBYT8K2SCZCW",1,"MIT","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-Tool-开发工具链\u002FYYC3-Tool-开发工具链-razor-v2\u002F.github\u002Fskills\u002Fvmr-codeflow-status\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: vmr-codeflow-status\ndescription: Analyze VMR codeflow PR status for dotnet repositories. Use when investigating stale codeflow PRs, checking if fixes have flowed through the VMR pipeline, debugging dependency update issues in PRs authored by dotnet-maestro[bot], checking overall flow status for a repo, or diagnosing why backflow PRs are missing or blocked.\n---\n\n# VMR Codeflow Status\n\nAnalyze the health of VMR codeflow PRs in both directions:\n- **Backflow**: `dotnet\u002Fdotnet` → product repos (e.g., `dotnet\u002Frazor`)\n- **Forward flow**: product repos → `dotnet\u002Fdotnet`\n\n> 🚨 **NEVER** use `gh pr review --approve` or `--request-changes`. Only `--comment` is allowed. Approval and blocking are human-only actions.\n\n**Workflow**: Run the script → read the human-readable output + `[CODEFLOW_SUMMARY]` JSON → synthesize recommendations yourself. The script collects data; you generate the advice.\n\n## Prerequisites\n\n- **GitHub CLI (`gh`)** — must be installed and authenticated (`gh auth login`)\n- Run scripts **from the skill directory** or use the full path to the script\n\n## When to Use This Skill\n\nUse this skill when:\n- A codeflow PR (from `dotnet-maestro[bot]`) has failing tests and you need to know if it's stale\n- You need to check if a specific fix has flowed through the VMR pipeline to a codeflow PR\n- A PR has a Maestro staleness warning (\"codeflow cannot continue\") or conflict\n- You need to understand what manual commits would be lost if a codeflow PR is closed\n- You want to check the overall state of flow for a repo (backflow and forward flow health)\n- You need to know why backflow PRs are missing or when the last VMR build was published\n- You're asked questions like \"is this codeflow PR up to date\", \"has the runtime revert reached this PR\", \"why is the codeflow blocked\", \"what is the state of flow for the sdk\", \"what's the flow status for net11\"\n\n## Two Modes\n\n| Mode | Use When | Required Params |\n|------|----------|-----------------|\n| **PR analysis** | Investigating a specific codeflow PR | `-PRNumber` (and optionally `-Repository`) |\n| **Flow health** (`-CheckMissing`) | Checking overall repo flow status | `-CheckMissing` (optional: `-Repository`, `-Branch`) |\n\n> ⚠️ **Common mistake**: Don't use `-PRNumber` and `-CheckMissing` together — they are separate modes. `-CheckMissing` scans branches discovered from open and recent backflow PRs (unless `-Branch` is provided), not a specific PR.\n\n## Quick Start\n\n```powershell\n# Check codeflow PR status (most common)\n.\u002Fscripts\u002FGet-CodeflowStatus.ps1 -PRNumber 52727 -Repository \"dotnet\u002Frazor\"\n\n# Trace a specific fix through the pipeline\n.\u002Fscripts\u002FGet-CodeflowStatus.ps1 -PRNumber 52727 -Repository \"dotnet\u002Frazor\" -TraceFix \"dotnet\u002Fruntime#123974\"\n\n# Show individual VMR commits that are missing\n.\u002Fscripts\u002FGet-CodeflowStatus.ps1 -PRNumber 52727 -Repository \"dotnet\u002Frazor\" -ShowCommits\n\n# Check overall flow health for a repo (backflow + forward flow)\n.\u002Fscripts\u002FGet-CodeflowStatus.ps1 -Repository \"dotnet\u002Froslyn\" -CheckMissing\n\n# Check a specific branch only\n.\u002Fscripts\u002FGet-CodeflowStatus.ps1 -Repository \"dotnet\u002Frazor\" -CheckMissing -Branch \"main\"\n```\n\n## Key Parameters\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| `-PRNumber` | Yes (unless `-CheckMissing`) | — | GitHub PR number to analyze |\n| `-Repository` | No | `dotnet\u002Frazor` | Target repo in `owner\u002Frepo` format |\n| `-TraceFix` | No | — | Trace a repo PR through the pipeline. Format: `owner\u002Frepo#number` (e.g., `dotnet\u002Fruntime#123974`) |\n| `-ShowCommits` | No | `$false` | Show individual VMR commits between PR snapshot and branch HEAD |\n| `-CheckMissing` | No | `$false` | Check overall flow health: missing backflow PRs, forward flow status, and official build freshness |\n| `-Branch` | No | — | With `-CheckMissing`, only check a specific branch (e.g., `main`, `release\u002F10.0`) |\n\n## What the Script Does\n\n### PR Analysis Mode (default)\n\n> **Design principle**: Assess current state from primary signals first, then use Maestro comments as historical context — not the other way around. Comments tell you the history, not the present.\n\n1. **PR Overview** — Basic PR info, flow direction (backflow vs forward flow)\n2. **Current State** — Independent assessment from primary signals: empty diff, force pushes, merge status. Produces a one-line verdict (NO-OP \u002F IN PROGRESS \u002F STALE \u002F ACTIVE \u002F MERGED \u002F CLOSED) before reading any comments\n3. **Codeflow Metadata** — Extracts VMR commit, subscription ID, build info from PR body\n4. **Snapshot Validation** — Cross-references PR body commit against Version.Details.xml and branch commits to detect stale metadata\n5. **Source Freshness** — Compares PR's VMR snapshot against current VMR branch HEAD; shows pending forward flow PRs\n6. **PR Branch Analysis** — Categorizes commits as auto-updates vs manual; detects codeflow-like manual commits\n7. **Codeflow History** — Maestro comments as historical context (conflict\u002Fstaleness warnings), cross-referenced against force push timestamps to determine if issues were already addressed\n8. **Traces fixes** (with `-TraceFix`) — Checks if a specific fix has flowed through VMR → codeflow PR\n9. **Emits structured summary** — `[CODEFLOW_SUMMARY]` JSON block with all key facts for the agent to reason over\n\n> **After the script runs**, you (the agent) generate recommendations. The script collects data; you synthesize the advice. See [Generating Recommendations](#generating-recommendations) below.\n\n### Flow Health Mode (`-CheckMissing`)\n1. **Checks official build freshness** — Queries `aka.ms` shortlinks for latest published VMR build dates per channel\n2. **Scans backflow PRs** — Finds branches where a backflow PR should exist but doesn't, and checks health of open PRs (conflict\u002Fstaleness\u002Fresolved status)\n3. **Scans forward flow** — Checks open forward flow PRs into `dotnet\u002Fdotnet` for staleness and conflicts\n4. **Produces summary** — Counts healthy\u002Fblocked\u002Fmissing PRs across both directions\n\n> ❌ **Never assume \"Unknown\" health means healthy.** When `gh` API calls fail (auth, rate limiting), the script returns \"Unknown\" status — this is explicitly excluded from healthy\u002Fcovered counts.\n\n> ⚠️ **aka.ms redirect behavior**: 301 is expected and treated as a valid product URL (→ ci.dot.net). Non-301 redirects (often 302, which goes to Bing) indicate an invalid URL. The script only accepts 301.\n\n## Interpreting Results\n\n### Current State (assessed first, from primary signals)\n- **✅ MERGED**: PR has been merged — no action needed\n- **✖️ CLOSED**: PR was closed without merging — Maestro should create a replacement\n- **📭 NO-OP**: Empty diff — PR likely already resolved, changes landed via other paths\n- **🔄 IN PROGRESS**: Recent force push within 24h — someone is actively working on it\n- **⏳ STALE**: No activity for >3 days — may need attention\n- **✅ ACTIVE**: PR has content and recent activity\n\n### Freshness\n- **✅ Up to date**: PR has the latest VMR snapshot\n- **⚠️ VMR is N commits ahead**: The PR is missing updates. Check if the missing commits contain the fix you need.\n- **📊 Forward flow coverage**: Shows how many missing repos have pending forward flow PRs that would close part of the gap once merged.\n\n### Snapshot Validation\n- **✅ Match**: PR body commit matches the branch's actual \"Backflow from\" commit\n- **⚠️ Mismatch**: PR body is stale — the script automatically uses the branch-derived commit for freshness checks\n- **ℹ️ Initial commit only**: PR body can't be verified yet (no \"Backflow from\" commit exists)\n\n### Codeflow History (Maestro comments as context)\n- **✅ No warnings**: Maestro can freely update the PR\n- **⚠️ Staleness warning**: A forward flow merged while this backflow PR was open. Maestro blocked further updates.\n- **🔴 Conflict detected**: Maestro found merge conflicts. Shows conflicting files and `darc vmr resolve-conflict` command.\n- **ℹ️ Force push after warning**: When a force push post-dates a conflict\u002Fstaleness warning, the issue may already be resolved. The script cross-references timestamps automatically.\n\n### Manual Commits\nManual commits on the PR branch are at risk if the PR is closed or force-triggered. The script lists them so you can decide whether to preserve them.\n\n### Fix Tracing\nWhen using `-TraceFix`:\n- **✅ Fix is in VMR manifest**: The fix has flowed to the VMR\n- **✅ Fix is in PR snapshot**: The codeflow PR already includes this fix\n- **❌ Fix is NOT in PR snapshot**: The PR needs a codeflow update to get this fix\n\n## Generating Recommendations\n\nAfter the script outputs the `[CODEFLOW_SUMMARY]` JSON block, **you** synthesize recommendations. Do not parrot the JSON — reason over it.\n\n### Decision logic\n\nCheck `isCodeflowPR` first — if `false`, skip all codeflow-specific advice:\n- **Not a codeflow PR** (`isCodeflowPR = false` or `flowDirection = \"unknown\"`): State this clearly. No darc commands, no codeflow recommendations. Treat as a normal PR.\n\nThen read `currentState`:\n\n| State | Action |\n|-------|--------|\n| `MERGED` | No action needed. Mention Maestro will create a new PR if VMR has newer content. |\n| `CLOSED` | Suggest triggering a new PR if `subscriptionId` is available. |\n| `NO-OP` | PR has no meaningful changes. Recommend closing or merging to clear state. If `subscriptionId` is available, offer force-trigger as a third option. |\n| `IN_PROGRESS` | Someone is actively working. Recommend waiting, then checking back. |\n| `STALE` | Needs attention — see warnings below for what's blocking. |\n| `ACTIVE` | PR is healthy — check freshness and warnings for nuance. |\n\nThen layer in context from `warnings`, `freshness`, and `commits`:\n\n- **Unresolved conflict** (`warnings.conflictCount > 0`, `conflictMayBeResolved = false`): Lead with \"resolve conflicts\" using `darc vmr resolve-conflict --subscription \u003Cid>`. Offer \"close & reopen\" as alternative.\n- **Conflict may be resolved** (`conflictMayBeResolved = true`): Note the force push post-dates the conflict warning. Suggest verifying, then merging.\n- **Staleness warning active** (`stalenessCount > 0`, `stalenessMayBeResolved = false`): Codeflow is blocked. Options: merge as-is, force trigger, or close & reopen.\n- **Manual commits present** (`commits.manual > 0`): Warn that force-trigger or close will lose them. If `commits.codeflowLikeManual > 0`, note the freshness gap may be partially covered.\n- **Behind on freshness** (`freshness.aheadBy > 0`): Mention the PR is missing updates. If staleness is blocking, a force trigger is needed. Otherwise, Maestro should auto-update.\n\n### Darc commands to include\n\nWhen recommending actions, include the relevant `darc` command with the actual `subscriptionId` from the summary. Be precise about what each command does:\n\n| Command | What it does | When to use |\n|---------|-------------|-------------|\n| `darc trigger-subscriptions --id \u003Cid>` | Normal trigger — only works if subscription isn't stale. Creates a new PR if none exists. | PR was closed, or no PR exists |\n| `darc trigger-subscriptions --id \u003Cid> --force` | Force trigger — **overwrites the existing PR branch** with fresh VMR content. Does not create a new PR. | PR exists but is stale\u002Fno-op and you want to reuse it |\n| `darc vmr resolve-conflict --subscription \u003Cid>` | Resolve conflicts locally and push to the PR branch | PR has merge conflicts |\n\n> ⚠️ **Common mistake**: Don't say \"close then force-trigger\" — force-trigger pushes to the *existing* PR. If you close first, use a normal trigger instead (which creates a new PR). The two paths are: (A) force-trigger to refresh the existing PR, or (B) close + normal-trigger to get a new PR.\n\n### Tone\n\nBe direct. Lead with the most important action. Use 2-4 bullet points, not long paragraphs. Include the darc command inline so the user can copy-paste.\n\n## Darc Commands for Remediation\n\nAfter analyzing the codeflow status, common next steps involve `darc` commands:\n\n```bash\n# Force trigger the subscription to get a fresh codeflow update\ndarc trigger-subscriptions --id \u003Csubscription-id> --force\n\n# Normal trigger (only works if not stale)\ndarc trigger-subscriptions --id \u003Csubscription-id>\n\n# Check subscription details\ndarc get-subscriptions --target-repo dotnet\u002Frazor --source-repo dotnet\u002Fdotnet\n\n# Get BAR build details\ndarc get-build --id \u003Cbar-build-id>\n\n# Resolve codeflow conflicts locally\ndarc vmr resolve-conflict --subscription \u003Csubscription-id>\n```\n\nInstall darc via `eng\\common\\darc-init.ps1` in any arcade-enabled repository.\n\n### When the script reports \"Maestro may be stuck\"\n\nWhen the script shows a missing backflow PR with \"Maestro may be stuck\" (builds are fresh but no PR was created), follow these diagnostic steps:\n\n1. **Check the subscription** to find when it last consumed a build:\n   ```bash\n   darc get-subscriptions --target-repo \u003Crepo> --source-repo dotnet\u002Fdotnet\n   ```\n   Look at the `Last Build` field — if it's weeks old while the channel has newer builds, the subscription is stuck.\n\n2. **Compare against the latest channel build** to confirm the gap:\n   ```bash\n   darc get-latest-build --repo dotnet\u002Fdotnet --channel \"\u003Cchannel-name>\"\n   ```\n   Channel names follow patterns like `.NET 11.0.1xx SDK`, `.NET 10.0.1xx SDK`, `.NET 11.0.1xx SDK Preview 1`.\n\n3. **Trigger the subscription manually** to unstick it:\n   ```bash\n   darc trigger-subscriptions --id \u003Csubscription-id>\n   ```\n\n4. **If triggering doesn't produce a PR within a few minutes**, the issue may be deeper — check Maestro health or open an issue on `dotnet\u002Farcade`.\n\n## References\n\n- **VMR codeflow concepts**: See [references\u002Fvmr-codeflow-reference.md](references\u002Fvmr-codeflow-reference.md)\n- **VMR build topology & staleness diagnosis**: See [references\u002Fvmr-build-topology.md](references\u002Fvmr-build-topology.md) — explains how to diagnose widespread backflow staleness by checking VMR build health, the bootstrap chicken-and-egg problem, and the channel\u002Fsubscription flow\n- **Codeflow PR documentation**: [dotnet\u002Fdotnet Codeflow-PRs.md](https:\u002F\u002Fgithub.com\u002Fdotnet\u002Fdotnet\u002Fblob\u002Fmain\u002Fdocs\u002FCodeflow-PRs.md)\n","# VMR Codeflow Status\n\nAnalyze the health of VMR codeflow PRs in both directions:\n- **Backflow**: `dotnet\u002Fdotnet` → product repos (e.g., `dotnet\u002Frazor`)\n- **Forward flow**: product repos → `dotnet\u002Fdotnet`\n\n> 🚨 **NEVER** use `gh pr review --approve` or `--request-changes`. Only `--comment` is allowed. Approval and blocking are human-only actions.\n\n**Workflow**: Run the script → read the human-readable output + `[CODEFLOW_SUMMARY]` JSON → synthesize recommendations yourself. The script collects data; you generate the advice.\n\n## Prerequisites\n\n- **GitHub CLI (`gh`)** — must be installed and authenticated (`gh auth login`)\n- Run scripts **from the skill directory** or use the full path to the script\n\n## When to Use This Skill\n\nUse this skill when:\n- A codeflow PR (from `dotnet-maestro[bot]`) has failing tests and you need to know if it's stale\n- You need to check if a specific fix has flowed through the VMR pipeline to a codeflow PR\n- A PR has a Maestro staleness warning (\"codeflow cannot continue\") or conflict\n- You need to understand what manual commits would be lost if a codeflow PR is closed\n- You want to check the overall state of flow for a repo (backflow and forward flow health)\n- You need to know why backflow PRs are missing or when the last VMR build was published\n- You're asked questions like \"is this codeflow PR up to date\", \"has the runtime revert reached this PR\", \"why is the codeflow blocked\", \"what is the state of flow for the sdk\", \"what's the flow status for net11\"\n\n## Two Modes\n\n| Mode | Use When | Required Params |\n|------|----------|-----------------|\n| **PR analysis** | Investigating a specific codeflow PR | `-PRNumber` (and optionally `-Repository`) |\n| **Flow health** (`-CheckMissing`) | Checking overall repo flow status | `-CheckMissing` (optional: `-Repository`, `-Branch`) |\n\n> ⚠️ **Common mistake**: Don't use `-PRNumber` and `-CheckMissing` together — they are separate modes. `-CheckMissing` scans branches discovered from open and recent backflow PRs (unless `-Branch` is provided), not a specific PR.\n\n## Quick Start\n\n```powershell\n# Check codeflow PR status (most common)\n.\u002Fscripts\u002FGet-CodeflowStatus.ps1 -PRNumber 52727 -Repository \"dotnet\u002Frazor\"\n\n# Trace a specific fix through the pipeline\n.\u002Fscripts\u002FGet-CodeflowStatus.ps1 -PRNumber 52727 -Repository \"dotnet\u002Frazor\" -TraceFix \"dotnet\u002Fruntime#123974\"\n\n# Show individual VMR commits that are missing\n.\u002Fscripts\u002FGet-CodeflowStatus.ps1 -PRNumber 52727 -Repository \"dotnet\u002Frazor\" -ShowCommits\n\n# Check overall flow health for a repo (backflow + forward flow)\n.\u002Fscripts\u002FGet-CodeflowStatus.ps1 -Repository \"dotnet\u002Froslyn\" -CheckMissing\n\n# Check a specific branch only\n.\u002Fscripts\u002FGet-CodeflowStatus.ps1 -Repository \"dotnet\u002Frazor\" -CheckMissing -Branch \"main\"\n```\n\n## Key Parameters\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| `-PRNumber` | Yes (unless `-CheckMissing`) | — | GitHub PR number to analyze |\n| `-Repository` | No | `dotnet\u002Frazor` | Target repo in `owner\u002Frepo` format |\n| `-TraceFix` | No | — | Trace a repo PR through the pipeline. Format: `owner\u002Frepo#number` (e.g., `dotnet\u002Fruntime#123974`) |\n| `-ShowCommits` | No | `$false` | Show individual VMR commits between PR snapshot and branch HEAD |\n| `-CheckMissing` | No | `$false` | Check overall flow health: missing backflow PRs, forward flow status, and official build freshness |\n| `-Branch` | No | — | With `-CheckMissing`, only check a specific branch (e.g., `main`, `release\u002F10.0`) |\n\n## What the Script Does\n\n### PR Analysis Mode (default)\n\n> **Design principle**: Assess current state from primary signals first, then use Maestro comments as historical context — not the other way around. Comments tell you the history, not the present.\n\n1. **PR Overview** — Basic PR info, flow direction (backflow vs forward flow)\n2. **Current State** — Independent assessment from primary signals: empty diff, force pushes, merge status. Produces a one-line verdict (NO-OP \u002F IN PROGRESS \u002F STALE \u002F ACTIVE \u002F MERGED \u002F CLOSED) before reading any comments\n3. **Codeflow Metadata** — Extracts VMR commit, subscription ID, build info from PR body\n4. **Snapshot Validation** — Cross-references PR body commit against Version.Details.xml and branch commits to detect stale metadata\n5. **Source Freshness** — Compares PR's VMR snapshot against current VMR branch HEAD; shows pending forward flow PRs\n6. **PR Branch Analysis** — Categorizes commits as auto-updates vs manual; detects codeflow-like manual commits\n7. **Codeflow History** — Maestro comments as historical context (conflict\u002Fstaleness warnings), cross-referenced against force push timestamps to determine if issues were already addressed\n8. **Traces fixes** (with `-TraceFix`) — Checks if a specific fix has flowed through VMR → codeflow PR\n9. **Emits structured summary** — `[CODEFLOW_SUMMARY]` JSON block with all key facts for the agent to reason over\n\n> **After the script runs**, you (the agent) generate recommendations. The script collects data; you synthesize the advice. See [Generating Recommendations](#generating-recommendations) below.\n\n### Flow Health Mode (`-CheckMissing`)\n1. **Checks official build freshness** — Queries `aka.ms` shortlinks for latest published VMR build dates per channel\n2. **Scans backflow PRs** — Finds branches where a backflow PR should exist but doesn't, and checks health of open PRs (conflict\u002Fstaleness\u002Fresolved status)\n3. **Scans forward flow** — Checks open forward flow PRs into `dotnet\u002Fdotnet` for staleness and conflicts\n4. **Produces summary** — Counts healthy\u002Fblocked\u002Fmissing PRs across both directions\n\n> ❌ **Never assume \"Unknown\" health means healthy.** When `gh` API calls fail (auth, rate limiting), the script returns \"Unknown\" status — this is explicitly excluded from healthy\u002Fcovered counts.\n\n> ⚠️ **aka.ms redirect behavior**: 301 is expected and treated as a valid product URL (→ ci.dot.net). Non-301 redirects (often 302, which goes to Bing) indicate an invalid URL. The script only accepts 301.\n\n## Interpreting Results\n\n### Current State (assessed first, from primary signals)\n- **✅ MERGED**: PR has been merged — no action needed\n- **✖️ CLOSED**: PR was closed without merging — Maestro should create a replacement\n- **📭 NO-OP**: Empty diff — PR likely already resolved, changes landed via other paths\n- **🔄 IN PROGRESS**: Recent force push within 24h — someone is actively working on it\n- **⏳ STALE**: No activity for >3 days — may need attention\n- **✅ ACTIVE**: PR has content and recent activity\n\n### Freshness\n- **✅ Up to date**: PR has the latest VMR snapshot\n- **⚠️ VMR is N commits ahead**: The PR is missing updates. Check if the missing commits contain the fix you need.\n- **📊 Forward flow coverage**: Shows how many missing repos have pending forward flow PRs that would close part of the gap once merged.\n\n### Snapshot Validation\n- **✅ Match**: PR body commit matches the branch's actual \"Backflow from\" commit\n- **⚠️ Mismatch**: PR body is stale — the script automatically uses the branch-derived commit for freshness checks\n- **ℹ️ Initial commit only**: PR body can't be verified yet (no \"Backflow from\" commit exists)\n\n### Codeflow History (Maestro comments as context)\n- **✅ No warnings**: Maestro can freely update the PR\n- **⚠️ Staleness warning**: A forward flow merged while this backflow PR was open. Maestro blocked further updates.\n- **🔴 Conflict detected**: Maestro found merge conflicts. Shows conflicting files and `darc vmr resolve-conflict` command.\n- **ℹ️ Force push after warning**: When a force push post-dates a conflict\u002Fstaleness warning, the issue may already be resolved. The script cross-references timestamps automatically.\n\n### Manual Commits\nManual commits on the PR branch are at risk if the PR is closed or force-triggered. The script lists them so you can decide whether to preserve them.\n\n### Fix Tracing\nWhen using `-TraceFix`:\n- **✅ Fix is in VMR manifest**: The fix has flowed to the VMR\n- **✅ Fix is in PR snapshot**: The codeflow PR already includes this fix\n- **❌ Fix is NOT in PR snapshot**: The PR needs a codeflow update to get this fix\n\n## Generating Recommendations\n\nAfter the script outputs the `[CODEFLOW_SUMMARY]` JSON block, **you** synthesize recommendations. Do not parrot the JSON — reason over it.\n\n### Decision logic\n\nCheck `isCodeflowPR` first — if `false`, skip all codeflow-specific advice:\n- **Not a codeflow PR** (`isCodeflowPR = false` or `flowDirection = \"unknown\"`): State this clearly. No darc commands, no codeflow recommendations. Treat as a normal PR.\n\nThen read `currentState`:\n\n| State | Action |\n|-------|--------|\n| `MERGED` | No action needed. Mention Maestro will create a new PR if VMR has newer content. |\n| `CLOSED` | Suggest triggering a new PR if `subscriptionId` is available. |\n| `NO-OP` | PR has no meaningful changes. Recommend closing or merging to clear state. If `subscriptionId` is available, offer force-trigger as a third option. |\n| `IN_PROGRESS` | Someone is actively working. Recommend waiting, then checking back. |\n| `STALE` | Needs attention — see warnings below for what's blocking. |\n| `ACTIVE` | PR is healthy — check freshness and warnings for nuance. |\n\nThen layer in context from `warnings`, `freshness`, and `commits`:\n\n- **Unresolved conflict** (`warnings.conflictCount > 0`, `conflictMayBeResolved = false`): Lead with \"resolve conflicts\" using `darc vmr resolve-conflict --subscription \u003Cid>`. Offer \"close & reopen\" as alternative.\n- **Conflict may be resolved** (`conflictMayBeResolved = true`): Note the force push post-dates the conflict warning. Suggest verifying, then merging.\n- **Staleness warning active** (`stalenessCount > 0`, `stalenessMayBeResolved = false`): Codeflow is blocked. Options: merge as-is, force trigger, or close & reopen.\n- **Manual commits present** (`commits.manual > 0`): Warn that force-trigger or close will lose them. If `commits.codeflowLikeManual > 0`, note the freshness gap may be partially covered.\n- **Behind on freshness** (`freshness.aheadBy > 0`): Mention the PR is missing updates. If staleness is blocking, a force trigger is needed. Otherwise, Maestro should auto-update.\n\n### Darc commands to include\n\nWhen recommending actions, include the relevant `darc` command with the actual `subscriptionId` from the summary. Be precise about what each command does:\n\n| Command | What it does | When to use |\n|---------|-------------|-------------|\n| `darc trigger-subscriptions --id \u003Cid>` | Normal trigger — only works if subscription isn't stale. Creates a new PR if none exists. | PR was closed, or no PR exists |\n| `darc trigger-subscriptions --id \u003Cid> --force` | Force trigger — **overwrites the existing PR branch** with fresh VMR content. Does not create a new PR. | PR exists but is stale\u002Fno-op and you want to reuse it |\n| `darc vmr resolve-conflict --subscription \u003Cid>` | Resolve conflicts locally and push to the PR branch | PR has merge conflicts |\n\n> ⚠️ **Common mistake**: Don't say \"close then force-trigger\" — force-trigger pushes to the *existing* PR. If you close first, use a normal trigger instead (which creates a new PR). The two paths are: (A) force-trigger to refresh the existing PR, or (B) close + normal-trigger to get a new PR.\n\n### Tone\n\nBe direct. Lead with the most important action. Use 2-4 bullet points, not long paragraphs. Include the darc command inline so the user can copy-paste.\n\n## Darc Commands for Remediation\n\nAfter analyzing the codeflow status, common next steps involve `darc` commands:\n\n```bash\n# Force trigger the subscription to get a fresh codeflow update\ndarc trigger-subscriptions --id \u003Csubscription-id> --force\n\n# Normal trigger (only works if not stale)\ndarc trigger-subscriptions --id \u003Csubscription-id>\n\n# Check subscription details\ndarc get-subscriptions --target-repo dotnet\u002Frazor --source-repo dotnet\u002Fdotnet\n\n# Get BAR build details\ndarc get-build --id \u003Cbar-build-id>\n\n# Resolve codeflow conflicts locally\ndarc vmr resolve-conflict --subscription \u003Csubscription-id>\n```\n\nInstall darc via `eng\\common\\darc-init.ps1` in any arcade-enabled repository.\n\n### When the script reports \"Maestro may be stuck\"\n\nWhen the script shows a missing backflow PR with \"Maestro may be stuck\" (builds are fresh but no PR was created), follow these diagnostic steps:\n\n1. **Check the subscription** to find when it last consumed a build:\n   ```bash\n   darc get-subscriptions --target-repo \u003Crepo> --source-repo dotnet\u002Fdotnet\n   ```\n   Look at the `Last Build` field — if it's weeks old while the channel has newer builds, the subscription is stuck.\n\n2. **Compare against the latest channel build** to confirm the gap:\n   ```bash\n   darc get-latest-build --repo dotnet\u002Fdotnet --channel \"\u003Cchannel-name>\"\n   ```\n   Channel names follow patterns like `.NET 11.0.1xx SDK`, `.NET 10.0.1xx SDK`, `.NET 11.0.1xx SDK Preview 1`.\n\n3. **Trigger the subscription manually** to unstick it:\n   ```bash\n   darc trigger-subscriptions --id \u003Csubscription-id>\n   ```\n\n4. **If triggering doesn't produce a PR within a few minutes**, the issue may be deeper — check Maestro health or open an issue on `dotnet\u002Farcade`.\n\n## References\n\n- **VMR codeflow concepts**: See [references\u002Fvmr-codeflow-reference.md](references\u002Fvmr-codeflow-reference.md)\n- **VMR build topology & staleness diagnosis**: See [references\u002Fvmr-build-topology.md](references\u002Fvmr-build-topology.md) — explains how to diagnose widespread backflow staleness by checking VMR build health, the bootstrap chicken-and-egg problem, and the channel\u002Fsubscription flow\n- **Codeflow PR documentation**: [dotnet\u002Fdotnet Codeflow-PRs.md](https:\u002F\u002Fgithub.com\u002Fdotnet\u002Fdotnet\u002Fblob\u002Fmain\u002Fdocs\u002FCodeflow-PRs.md)\n",{"name":5,"description":7},"main","87afe6ce96220accf50a345dea46784c8c9f210e","YYC3-Tool-开发工具链\u002FYYC3-Tool-开发工具链-razor-v2\u002F.github\u002Fskills\u002Fvmr-codeflow-status",0,"https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base","https:\u002F\u002Fkb.yyc3.top\u002F","https:\u002F\u002Fgithub.com\u002FYYC-Cube","万象归元于云枢 | 深栈智启新纪元","2026-11-10 10:37:32",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill vmr-codeflow-status",{"tool":39,"command":40},"bunx","bunx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill vmr-codeflow-status",{"tool":42,"command":43},"pnpm","pnpm dlx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill vmr-codeflow-status","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-Tool-开发工具链\u002FYYC3-Tool-开发工具链-razor-v2\u002F.github\u002Fskills\u002Fvmr-codeflow-status\u002FSKILL.md",true,[47,53,57],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Fvmr-build-topology.md","REFERENCE","参考文档",10518,"https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-Tool-开发工具链\u002FYYC3-Tool-开发工具链-razor-v2\u002F.github\u002Fskills\u002Fvmr-codeflow-status\u002Freferences\u002Fvmr-build-topology.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Fvmr-codeflow-reference.md",5783,"https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-Tool-开发工具链\u002FYYC3-Tool-开发工具链-razor-v2\u002F.github\u002Fskills\u002Fvmr-codeflow-status\u002Freferences\u002Fvmr-codeflow-reference.md",{"path":58,"resourceType":59,"resourceTypeDesc":60,"sizeBytes":61,"sourceHtmlUrl":62},"scripts\u002FGet-CodeflowStatus.ps1","SCRIPT","脚本",67466,"https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-Tool-开发工具链\u002FYYC3-Tool-开发工具链-razor-v2\u002F.github\u002Fskills\u002Fvmr-codeflow-status\u002Fscripts\u002FGet-CodeflowStatus.ps1",[64,71,78,85,92,99],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7CTDWHERCXPQCP0K03A86AS","vercel-sandbox","Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include \"Vercel Sandbox browser\", \"microVM Chrome\", \"agent-browser in sandbox\", \"browser automation on Vercel\", or any task requiring Chrome in a Vercel Sandbox.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fvercel-sandbox\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7CTD8D2BNJY54S65M47HEJA","slack","Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include \"check my Slack\", \"what channels have unreads\", \"send a message to\", \"search Slack for\", \"extract from Slack\", \"find who said\", or any task requiring programmatic Slack interaction.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fslack\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7CTCSSB8ZP3Q58C3YZDZK1W","electron","Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include \"automate Slack app\", \"control VS Code\", \"interact with Discord app\", \"test this Electron app\", \"connect to desktop app\", or any task requiring automation of a native Electron application.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Felectron\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7CTCBJY76688V4DCZGWFHGQ","dogfood","Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to \"dogfood\", \"QA\", \"exploratory test\", \"find issues\", \"bug hunt\", \"test this app\u002Fsite\u002Fplatform\", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fdogfood\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7CTC4H0FFGVEAQR9PA4GA1A","agent-browser","Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to \"open a website\", \"fill out a form\", \"click a button\", \"take a screenshot\", \"scrape data from a page\", \"test this web app\", \"login to a site\", \"automate browser actions\", or any task requiring programmatic web interaction.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fagent-browser\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":19},"01M7CTBKVFYBG78FDSABSDJTTQ","shadcn","Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. Provides project context, component docs, and usage examples. Applies when working with shadcn\u002Fui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for \"shadcn init\", \"create an app with --preset\", \"switch to --preset\", and for building a design system or applying a DESIGN.md or brand spec to shadcn\u002Fui.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-UI-界面组件\u002FYYC3-UI-界面组件-ui\u002Fskills\u002Fshadcn\u002FSKILL.md",[],[]]