[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M69B6J924HHBDH1G30RG9DT3":3,"skill-same:01M69B6J924HHBDH1G30RG9DT3":76},{"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":47,"linkOnly":48,"markdownContent":49,"markdownBody":50,"frontMatter":51,"refName":52,"commitSha":53,"skillDirectory":54,"forksCount":55,"repositoryHtmlUrl":56,"repositoryHomepageUrl":57,"ownerHtmlUrl":58,"ownerBlogUrl":59,"ownerDescription":60,"updatedAt":61,"install":62,"resources":75},"01M69B6J924HHBDH1G30RG9DT3","validation-project",null,"Creates a validation project for testing a specific vscode-cmake-tools pull request. Use this skill when asked to create a validation project, test a PR, validate a pull request, or set up a PR validation environment. The skill creates a structured project directory with documentation, metadata, and checklists for systematically validating PR changes.","microsoft\u002Fvscode-cmake-tools","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M69B5ZETEJ3WM91BA2ZYMTYT",1688,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cmake-tools\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fvalidation-project\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],"project","validation project","validation","when","testing","request","for","with","up","use","environment","Tools","SET","pull","create","cmake","pull request","pr","documentation","validate","vscode","test","directory","2026-11-10 10:12:30",false,"---\nname: validation-project\ndescription: >\n  Creates a validation project for testing a specific vscode-cmake-tools pull request.\n  Use this skill when asked to create a validation project, test a PR,\n  validate a pull request, or set up a PR validation environment.\n  The skill creates a structured project directory with documentation,\n  metadata, and checklists for systematically validating PR changes.\n---\n\n# Create Validation Project\n\nYou are a validation engineer. Your job is to create a well-structured validation project that helps systematically test a specific GitHub pull request against the microsoft\u002Fvscode-cmake-tools repository.\n\n## Workflow\n\n### Step 1: Gather PR Information\n\nWhen the user provides a PR reference (e.g., `#123`, a PR URL, or `microsoft\u002Fvscode-cmake-tools#123`), use the GitHub MCP server tools to fetch:\n\n- PR title, body\u002Fdescription, and state\n- Changed files list (via `get_files`)\n- Head branch, base branch, and **head commit SHA**\n- Whether the PR is from a fork (compare `head.repo.full_name` vs `base.repo.full_name`)\n- PR labels and linked issues (if any)\n\nIf no repository is specified and the context is ambiguous, default to `microsoft\u002Fvscode-cmake-tools`.\n\n#### Step 1b: Fetch Linked Issues\n\nIf the PR description or body references issues (e.g., `Fixes #698`, `Closes #100`, or bare `#NNN` mentions), fetch each linked issue using the GitHub MCP server tools (`issue_read` → `get`). Linked issues are a critical source of:\n\n- **Repro steps:** The issue often contains more detailed, user-reported repro steps than the PR description. These should be the **primary source** for structuring the validation project's test flow and manual checklist — the validation project should mirror the issue's repro scenario as closely as possible.\n- **Environment details:** The issue may specify platform (Windows-only, Linux-only), required tools, or specific project structures needed to trigger the bug.\n- **Expected vs. actual behavior:** Use the issue's expected\u002Factual description to define pass\u002Ffail criteria in the checklist.\n- **Screenshots or logs:** These help understand what the user saw and what the fix should change.\n\nWhen an issue provides repro steps, prefer its scenario over inventing a new one. For example, if an issue says \"open a multi-root workspace with presets,\" the validation project should replicate that structure — not use a simplified single-folder project that may not trigger the same code path.\n\n### Step 2: Create Project Directory\n\nCreate the validation project inside the **validation-projects** directory (default: `C:\\Users\\\u003Cuser directory>\\validation-projects`).\n\nThe validation project directory **is** the test project — all test project files (`CMakeLists.txt`, `CMakePresets.json`, source files, `.vscode\u002Fsettings.json`, etc.) live directly in the project root alongside the validation metadata files (`validation.json`, `manual-checklist.md`).\n\n**Directory naming convention:**\n- Format: `vscode-cmake-tools-pr-{number}-{short-slug}`\n- Example: `vscode-cmake-tools-pr-456-fix-preset-reload-loop`\n- Rules:\n  - Lowercase everything\n  - Sanitize special characters (replace non-alphanumeric with hyphens)\n  - Cap the slug portion at 40 characters\n  - Remove trailing hyphens\n- If the directory already exists, ask the user whether to overwrite or create a suffixed version\n\n### Step 3: Generate validation.json\n\nCreate a `validation.json` metadata file in the project root with this structure:\n\n```json\n{\n  \"pr\": {\n    \"number\": 123,\n    \"title\": \"Fix preset reloading loop when preset files are symlinks\",\n    \"url\": \"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cmake-tools\u002Fpull\u002F123\",\n    \"owner\": \"microsoft\",\n    \"repo\": \"vscode-cmake-tools\",\n    \"headBranch\": \"fix\u002Fpreset-reload-loop\",\n    \"baseBranch\": \"main\",\n    \"headSha\": \"abc123def456...\",\n    \"isFork\": false,\n    \"linkedIssues\": [\"#100\"]\n  },\n  \"validation\": {\n    \"status\": \"planned\",\n    \"createdAt\": \"2026-04-16T12:00:00Z\",\n    \"updatedAt\": \"2026-04-16T12:00:00Z\",\n    \"result\": null,\n    \"notes\": \"\"\n  }\n}\n```\n\nValid status values: `planned`, `in_progress`, `passed`, `failed`, `obsolete`. This can be used for personal tracking.\n\n### Step 4: Generate README.md\n\nCreate a comprehensive `README.md` with these sections:\n\n```markdown\n# Validation: PR #{number} — {title}\n\n> **Status:** ? Planned\n> **PR:** [microsoft\u002Fvscode-cmake-tools#{number}]({url})\n> **Issue:** [microsoft\u002Fvscode-cmake-tools#{issueNumber}]({issueUrl})  ← include if linked issue exists\n> **Target branch:** {baseBranch} ← {headBranch}\n> **Pinned commit:** `{headSha}`\n> **Created:** {date}\n\n## Summary\n\n{Summarize what the PR does based on the PR description and changed files.\nExplain the problem it solves or the feature it introduces.\nIf a linked issue exists, reference it and explain its relationship to the PR.}\n\n## Changed Files\n\n{List the files changed in the PR with brief descriptions of what changed.\nGroup by layer when helpful — e.g., \"Driver layer\", \"Presets\", \"UI\", \"Config\", \"Tests\".}\n\n## Prerequisites\n\n- VS Code (latest stable or Insiders)\n- CMake 3.20+ (or as required by presets `cmakeMinimumRequired`)\n- A C\u002FC++ compiler (GCC, Clang, or MSVC)\n- Ninja or another generator (as needed by the test scenario)\n{Include any additional environment requirements mentioned in the linked issue\n(e.g., \"Windows-only\", \"requires Visual Studio 2022\", \"multi-root workspace\").}\n\n## Repro Steps\n\n{If the PR fixes a bug, describe how to reproduce the original issue\nby opening this directory in VS Code with a pre-fix build of CMake Tools.\n**Prefer the linked issue's repro steps** over inventing new ones — they represent\nthe actual user-reported scenario and are most likely to trigger the bug.\nIf the PR adds a feature, describe how to exercise the new functionality.\nIf repro steps cannot be confidently derived from the PR, clearly state\nwhat assumptions were made and what the user should verify or fill in.}\n\n## Validation Approach\n\n{Describe how this validation project tests the PR's changes:\n- What specific behaviors to verify\n- What inputs\u002Fscenarios to test\n- What the expected outcomes are\n- Whether to test in presets mode, kits\u002Fvariants mode, or both\n- Whether to test with single-config and\u002For multi-config generators\n- How to set up the environment to test}\n\n## Regression Testing\n\n{Describe what existing behavior must NOT break:\n- Key workflows that touch the same code paths\n- Edge cases to watch for\n- Existing tests that should still pass (`yarn unitTests`, `yarn backendTests`)\n- Related features that could be affected\n- Cross-platform concerns (Windows\u002FmacOS\u002FLinux)}\n\n## Manual Checklist\n\nSee `manual-checklist.md` for a step-by-step testing checklist.\n```\n\n**Important rules for README generation:**\n- If repro steps are not clear from the PR, say so explicitly and mark sections with `\u003C!-- TODO: fill in -->` comments\n- Link back to the PR and any linked issues\n- Be specific — don't write generic testing advice; tailor everything to this PR's actual changes\n- When the PR touches shared logic, note whether testing should cover both presets mode and kits\u002Fvariants mode, and both single-config and multi-config generators\n\n### Step 5: Generate manual-checklist.md\n\nCreate a `manual-checklist.md` with actionable test steps. Each test step must include\n**two expected-result lines** — one for when the PR build is loaded (the fix\u002Ffeature is\nactive) and one for when it is NOT loaded (baseline\u002Frelease build). This lets the validator\nconfirm the bug exists on baseline AND confirm the fix resolves it on the PR build, which\nis the gold standard for validating a PR.\n\n```markdown\n# Manual Validation Checklist — PR #{number}\n\n## Pre-Validation Setup\n- [ ] PR build of CMake Tools extension is loaded in VS Code (via VSIX or development host)\n- [ ] Baseline (release) build of CMake Tools is available for comparison testing\n- [ ] Prerequisites from `README.md` are satisfied (CMake, compiler, generator)\n- [ ] This validation project directory is open in VS Code\n\n## Core Validation\n{Generate specific checklist items based on what the PR changes.\nEach item should be a concrete, testable action with two expected results:\none for the PR build (fix applied) and one for baseline (no fix).}\n\n- [ ] {Test step 1}\n  - ? **With PR build:** {expected result when the fix\u002Ffeature is active}\n  - ? **Without PR build (baseline):** {expected result on release\u002Fmain — typically the bug behavior}\n- [ ] {Test step 2}\n  - ? **With PR build:** {expected result}\n  - ? **Without PR build (baseline):** {expected result}\n\n## Regression Checks\n{Generate checklist items for verifying existing behavior isn't broken.\nRegression checks should produce the SAME result with and without the PR build.}\n\n- [ ] {Regression check 1}\n  - ? **With PR build:** {expected result — same as baseline}\n  - ⚪ **Without PR build (baseline):** {expected result — same as PR build}\n- [ ] {Regression check 2}\n  - ? **With PR build:** {expected result — same as baseline}\n  - ⚪ **Without PR build (baseline):** {expected result — same as PR build}\n\n## Edge Cases\n- [ ] {Edge case 1}\n  - ? **With PR build:** {expected result}\n  - ? **Without PR build (baseline):** {expected result}\n- [ ] {Edge case 2}\n  - ? **With PR build:** {expected result}\n  - ? **Without PR build (baseline):** {expected result}\n\n## Result\n- [ ] **PASS** — All checks passed, PR is validated\n- [ ] **FAIL** — Issues found (document below)\n\n### Issues Found\n{Space for documenting any problems discovered during validation}\n```\n\n**Formatting rules for expected results:**\n- Use ? for the PR build line and ? for the baseline line in **Core Validation** and **Edge Cases** (where behavior should differ).\n- Use ? for the PR build line and ⚪ for the baseline line in **Regression Checks** (where behavior should be identical).\n- If a test step only makes sense with the PR build (e.g., testing a brand-new feature that has no baseline equivalent), use only the ? line and note that the feature doesn't exist on baseline.\n- Be specific about the observable difference — don't just say \"works\" vs \"doesn't work\". Describe what the user will actually see (error messages, UI state, output values, etc.).\n\n### Step 6: Generate test project files\n\nPlace all test project files **directly in the validation project root** — do not create a nested `test-project\\` subdirectory. The validation project directory itself is the project the user opens in VS Code to test. Validation metadata files (`validation.json`, `manual-checklist.md`) coexist alongside the test project files in the same directory.\n\nThe test project is **not** about building the CMake Tools extension itself — assume the user already has a working PR build (VSIX or dev host). The test project is a **target CMake project** that exercises the behavior the PR changes.\n\n#### What to generate\n\nCreate the simplest CMake project that triggers the behavior under test. Every test project must include:\n\n1. **`CMakeLists.txt`** — A minimal CMake project. Set `cmake_minimum_required` and `project()` appropriately. Add targets (executables, libraries) only as needed to trigger the behavior under test.\n\n2. **`CMakePresets.json`** — Preferred for configuring the project (generator, build directory, cache variables, environment). Use presets unless the PR specifically tests kits\u002Fvariants mode behavior.\n\n3. **Source files** (if the project needs to build) — Keep them trivial (e.g., hello-world `main.cpp`). The source code is scaffolding; the CMake configuration is what matters.\n\n4. **`.vscode\u002Fsettings.json`** — Include when:\n   - The PR changes behavior related to `cmake.*` VS Code settings\n   - You need to set `\"cmake.useCMakePresets\": \"always\"` (when using `CMakePresets.json`)\n   - You need to set `\"cmake.useCMakePresets\": \"never\"` (when testing kits\u002Fvariants mode)\n   - You need to configure specific `cmake.*` settings that trigger the behavior under test\n   Include comments explaining what each setting does and what to expect before vs. after the fix.\n\n5. **Additional config files as needed** — e.g., `CMakeUserPresets.json` (for user-preset testing), `.vscode\u002Ftasks.json` (for task provider testing), toolchain files, or `CTestTestfile.cmake` — only if the PR specifically involves that type of configuration.\n\nNote: The `README.md` generated in Step 4 serves as both the validation overview and the test project documentation (prerequisites, repro steps, validation instructions). Do not create a separate README for the test project.\n\n#### Mode-aware testing\n\nThe CMake Tools extension has two operating modes. The test project must exercise the correct mode(s) based on what the PR changes:\n\n- **Presets mode** (`cmake.useCMakePresets: \"always\"`): Uses `CMakePresets.json` \u002F `CMakeUserPresets.json`. Test this mode when the PR touches preset loading, expansion, resolution, or any code gated on `useCMakePresets === true`.\n- **Kits\u002Fvariants mode** (`cmake.useCMakePresets: \"never\"`): Uses kits (compiler selection) and variants (build type). Test this mode when the PR touches kit scanning, kit selection, variant handling, or any code gated on `useCMakePresets === false`.\n- **Both modes**: When the PR touches shared logic (driver code, build runner, environment merging, target resolution), create configurations for both modes. Use separate `.vscode\u002Fsettings.json` comments or preset variants to document which mode each test exercises.\n\n#### Generator-aware testing\n\n- **Single-config generators** (Ninja, Unix Makefiles): Use `CMAKE_BUILD_TYPE` at configure time. Test when the PR involves configure-time build type logic.\n- **Multi-config generators** (Ninja Multi-Config, Visual Studio, Xcode): Use `--config` at build time. Test when the PR involves build-time configuration selection.\n- When the PR touches generator-agnostic code, include presets or instructions for testing with both types.\n\n#### Principles\n\n- **Minimal and focused.** Only include what's needed to trigger the behavior. Don't add unrelated targets, dependencies, or complexity.\n- **Pre-wired to trigger the bug.** Configuration should be set up so that simply opening the project in VS Code and running CMake: Configure (or the relevant command) exercises the changed behavior. The user shouldn't need to manually edit config files first.\n- **Include regression scenarios when appropriate.** If the PR changes shared code paths, include a second preset or configuration variant that tests an unaffected path to verify no regression.\n- **Mark unknowns.** If you can't determine the exact reproduction setup from the PR, add `\u003C!-- TODO: ... -->` comments explaining what the user needs to fill in.\n\n### Step 7: Summary\n\nAfter creating all files, present a summary:\n\n```\n✅ Validation project created: {directory-name}\n\nFiles:\n  ? README.md              — Project overview, repro steps, and validation plan\n  ? manual-checklist.md     — Step-by-step testing checklist\n  ? validation.json         — Machine-readable PR metadata\n  ? CMakeLists.txt          — CMake project definition\n  ? CMakePresets.json       — CMake presets configuration\n  ? src\u002Fmain.cpp            — Minimal source file(s)\n  ? .vscode\u002Fsettings.json   — VS Code \u002F CMake Tools settings (if applicable)\n\nNext steps:\n  1. Open the project directory in VS Code with the PR build of CMake Tools loaded\n  2. Follow README.md to repro the issue and validate the fix\n  3. Work through manual-checklist.md for full coverage\n  4. Update validation.json status as you go\n```\n\n## Guidelines\n\n- Always pin to a specific commit SHA for reproducibility\n- Be honest when information is insufficient — mark gaps clearly rather than guessing\n- Tailor all content to the specific PR; avoid generic boilerplate\n- Keep file paths Windows-compatible (backslashes, no special characters)\n- If the user provides additional context about what to test, incorporate it\n- When updating an existing validation project, preserve user-added content\n","# Create Validation Project\n\nYou are a validation engineer. Your job is to create a well-structured validation project that helps systematically test a specific GitHub pull request against the microsoft\u002Fvscode-cmake-tools repository.\n\n## Workflow\n\n### Step 1: Gather PR Information\n\nWhen the user provides a PR reference (e.g., `#123`, a PR URL, or `microsoft\u002Fvscode-cmake-tools#123`), use the GitHub MCP server tools to fetch:\n\n- PR title, body\u002Fdescription, and state\n- Changed files list (via `get_files`)\n- Head branch, base branch, and **head commit SHA**\n- Whether the PR is from a fork (compare `head.repo.full_name` vs `base.repo.full_name`)\n- PR labels and linked issues (if any)\n\nIf no repository is specified and the context is ambiguous, default to `microsoft\u002Fvscode-cmake-tools`.\n\n#### Step 1b: Fetch Linked Issues\n\nIf the PR description or body references issues (e.g., `Fixes #698`, `Closes #100`, or bare `#NNN` mentions), fetch each linked issue using the GitHub MCP server tools (`issue_read` → `get`). Linked issues are a critical source of:\n\n- **Repro steps:** The issue often contains more detailed, user-reported repro steps than the PR description. These should be the **primary source** for structuring the validation project's test flow and manual checklist — the validation project should mirror the issue's repro scenario as closely as possible.\n- **Environment details:** The issue may specify platform (Windows-only, Linux-only), required tools, or specific project structures needed to trigger the bug.\n- **Expected vs. actual behavior:** Use the issue's expected\u002Factual description to define pass\u002Ffail criteria in the checklist.\n- **Screenshots or logs:** These help understand what the user saw and what the fix should change.\n\nWhen an issue provides repro steps, prefer its scenario over inventing a new one. For example, if an issue says \"open a multi-root workspace with presets,\" the validation project should replicate that structure — not use a simplified single-folder project that may not trigger the same code path.\n\n### Step 2: Create Project Directory\n\nCreate the validation project inside the **validation-projects** directory (default: `C:\\Users\\\u003Cuser directory>\\validation-projects`).\n\nThe validation project directory **is** the test project — all test project files (`CMakeLists.txt`, `CMakePresets.json`, source files, `.vscode\u002Fsettings.json`, etc.) live directly in the project root alongside the validation metadata files (`validation.json`, `manual-checklist.md`).\n\n**Directory naming convention:**\n- Format: `vscode-cmake-tools-pr-{number}-{short-slug}`\n- Example: `vscode-cmake-tools-pr-456-fix-preset-reload-loop`\n- Rules:\n  - Lowercase everything\n  - Sanitize special characters (replace non-alphanumeric with hyphens)\n  - Cap the slug portion at 40 characters\n  - Remove trailing hyphens\n- If the directory already exists, ask the user whether to overwrite or create a suffixed version\n\n### Step 3: Generate validation.json\n\nCreate a `validation.json` metadata file in the project root with this structure:\n\n```json\n{\n  \"pr\": {\n    \"number\": 123,\n    \"title\": \"Fix preset reloading loop when preset files are symlinks\",\n    \"url\": \"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cmake-tools\u002Fpull\u002F123\",\n    \"owner\": \"microsoft\",\n    \"repo\": \"vscode-cmake-tools\",\n    \"headBranch\": \"fix\u002Fpreset-reload-loop\",\n    \"baseBranch\": \"main\",\n    \"headSha\": \"abc123def456...\",\n    \"isFork\": false,\n    \"linkedIssues\": [\"#100\"]\n  },\n  \"validation\": {\n    \"status\": \"planned\",\n    \"createdAt\": \"2026-04-16T12:00:00Z\",\n    \"updatedAt\": \"2026-04-16T12:00:00Z\",\n    \"result\": null,\n    \"notes\": \"\"\n  }\n}\n```\n\nValid status values: `planned`, `in_progress`, `passed`, `failed`, `obsolete`. This can be used for personal tracking.\n\n### Step 4: Generate README.md\n\nCreate a comprehensive `README.md` with these sections:\n\n```markdown\n# Validation: PR #{number} — {title}\n\n> **Status:** ? Planned\n> **PR:** [microsoft\u002Fvscode-cmake-tools#{number}]({url})\n> **Issue:** [microsoft\u002Fvscode-cmake-tools#{issueNumber}]({issueUrl})  ← include if linked issue exists\n> **Target branch:** {baseBranch} ← {headBranch}\n> **Pinned commit:** `{headSha}`\n> **Created:** {date}\n\n## Summary\n\n{Summarize what the PR does based on the PR description and changed files.\nExplain the problem it solves or the feature it introduces.\nIf a linked issue exists, reference it and explain its relationship to the PR.}\n\n## Changed Files\n\n{List the files changed in the PR with brief descriptions of what changed.\nGroup by layer when helpful — e.g., \"Driver layer\", \"Presets\", \"UI\", \"Config\", \"Tests\".}\n\n## Prerequisites\n\n- VS Code (latest stable or Insiders)\n- CMake 3.20+ (or as required by presets `cmakeMinimumRequired`)\n- A C\u002FC++ compiler (GCC, Clang, or MSVC)\n- Ninja or another generator (as needed by the test scenario)\n{Include any additional environment requirements mentioned in the linked issue\n(e.g., \"Windows-only\", \"requires Visual Studio 2022\", \"multi-root workspace\").}\n\n## Repro Steps\n\n{If the PR fixes a bug, describe how to reproduce the original issue\nby opening this directory in VS Code with a pre-fix build of CMake Tools.\n**Prefer the linked issue's repro steps** over inventing new ones — they represent\nthe actual user-reported scenario and are most likely to trigger the bug.\nIf the PR adds a feature, describe how to exercise the new functionality.\nIf repro steps cannot be confidently derived from the PR, clearly state\nwhat assumptions were made and what the user should verify or fill in.}\n\n## Validation Approach\n\n{Describe how this validation project tests the PR's changes:\n- What specific behaviors to verify\n- What inputs\u002Fscenarios to test\n- What the expected outcomes are\n- Whether to test in presets mode, kits\u002Fvariants mode, or both\n- Whether to test with single-config and\u002For multi-config generators\n- How to set up the environment to test}\n\n## Regression Testing\n\n{Describe what existing behavior must NOT break:\n- Key workflows that touch the same code paths\n- Edge cases to watch for\n- Existing tests that should still pass (`yarn unitTests`, `yarn backendTests`)\n- Related features that could be affected\n- Cross-platform concerns (Windows\u002FmacOS\u002FLinux)}\n\n## Manual Checklist\n\nSee `manual-checklist.md` for a step-by-step testing checklist.\n```\n\n**Important rules for README generation:**\n- If repro steps are not clear from the PR, say so explicitly and mark sections with `\u003C!-- TODO: fill in -->` comments\n- Link back to the PR and any linked issues\n- Be specific — don't write generic testing advice; tailor everything to this PR's actual changes\n- When the PR touches shared logic, note whether testing should cover both presets mode and kits\u002Fvariants mode, and both single-config and multi-config generators\n\n### Step 5: Generate manual-checklist.md\n\nCreate a `manual-checklist.md` with actionable test steps. Each test step must include\n**two expected-result lines** — one for when the PR build is loaded (the fix\u002Ffeature is\nactive) and one for when it is NOT loaded (baseline\u002Frelease build). This lets the validator\nconfirm the bug exists on baseline AND confirm the fix resolves it on the PR build, which\nis the gold standard for validating a PR.\n\n```markdown\n# Manual Validation Checklist — PR #{number}\n\n## Pre-Validation Setup\n- [ ] PR build of CMake Tools extension is loaded in VS Code (via VSIX or development host)\n- [ ] Baseline (release) build of CMake Tools is available for comparison testing\n- [ ] Prerequisites from `README.md` are satisfied (CMake, compiler, generator)\n- [ ] This validation project directory is open in VS Code\n\n## Core Validation\n{Generate specific checklist items based on what the PR changes.\nEach item should be a concrete, testable action with two expected results:\none for the PR build (fix applied) and one for baseline (no fix).}\n\n- [ ] {Test step 1}\n  - ? **With PR build:** {expected result when the fix\u002Ffeature is active}\n  - ? **Without PR build (baseline):** {expected result on release\u002Fmain — typically the bug behavior}\n- [ ] {Test step 2}\n  - ? **With PR build:** {expected result}\n  - ? **Without PR build (baseline):** {expected result}\n\n## Regression Checks\n{Generate checklist items for verifying existing behavior isn't broken.\nRegression checks should produce the SAME result with and without the PR build.}\n\n- [ ] {Regression check 1}\n  - ? **With PR build:** {expected result — same as baseline}\n  - ⚪ **Without PR build (baseline):** {expected result — same as PR build}\n- [ ] {Regression check 2}\n  - ? **With PR build:** {expected result — same as baseline}\n  - ⚪ **Without PR build (baseline):** {expected result — same as PR build}\n\n## Edge Cases\n- [ ] {Edge case 1}\n  - ? **With PR build:** {expected result}\n  - ? **Without PR build (baseline):** {expected result}\n- [ ] {Edge case 2}\n  - ? **With PR build:** {expected result}\n  - ? **Without PR build (baseline):** {expected result}\n\n## Result\n- [ ] **PASS** — All checks passed, PR is validated\n- [ ] **FAIL** — Issues found (document below)\n\n### Issues Found\n{Space for documenting any problems discovered during validation}\n```\n\n**Formatting rules for expected results:**\n- Use ? for the PR build line and ? for the baseline line in **Core Validation** and **Edge Cases** (where behavior should differ).\n- Use ? for the PR build line and ⚪ for the baseline line in **Regression Checks** (where behavior should be identical).\n- If a test step only makes sense with the PR build (e.g., testing a brand-new feature that has no baseline equivalent), use only the ? line and note that the feature doesn't exist on baseline.\n- Be specific about the observable difference — don't just say \"works\" vs \"doesn't work\". Describe what the user will actually see (error messages, UI state, output values, etc.).\n\n### Step 6: Generate test project files\n\nPlace all test project files **directly in the validation project root** — do not create a nested `test-project\\` subdirectory. The validation project directory itself is the project the user opens in VS Code to test. Validation metadata files (`validation.json`, `manual-checklist.md`) coexist alongside the test project files in the same directory.\n\nThe test project is **not** about building the CMake Tools extension itself — assume the user already has a working PR build (VSIX or dev host). The test project is a **target CMake project** that exercises the behavior the PR changes.\n\n#### What to generate\n\nCreate the simplest CMake project that triggers the behavior under test. Every test project must include:\n\n1. **`CMakeLists.txt`** — A minimal CMake project. Set `cmake_minimum_required` and `project()` appropriately. Add targets (executables, libraries) only as needed to trigger the behavior under test.\n\n2. **`CMakePresets.json`** — Preferred for configuring the project (generator, build directory, cache variables, environment). Use presets unless the PR specifically tests kits\u002Fvariants mode behavior.\n\n3. **Source files** (if the project needs to build) — Keep them trivial (e.g., hello-world `main.cpp`). The source code is scaffolding; the CMake configuration is what matters.\n\n4. **`.vscode\u002Fsettings.json`** — Include when:\n   - The PR changes behavior related to `cmake.*` VS Code settings\n   - You need to set `\"cmake.useCMakePresets\": \"always\"` (when using `CMakePresets.json`)\n   - You need to set `\"cmake.useCMakePresets\": \"never\"` (when testing kits\u002Fvariants mode)\n   - You need to configure specific `cmake.*` settings that trigger the behavior under test\n   Include comments explaining what each setting does and what to expect before vs. after the fix.\n\n5. **Additional config files as needed** — e.g., `CMakeUserPresets.json` (for user-preset testing), `.vscode\u002Ftasks.json` (for task provider testing), toolchain files, or `CTestTestfile.cmake` — only if the PR specifically involves that type of configuration.\n\nNote: The `README.md` generated in Step 4 serves as both the validation overview and the test project documentation (prerequisites, repro steps, validation instructions). Do not create a separate README for the test project.\n\n#### Mode-aware testing\n\nThe CMake Tools extension has two operating modes. The test project must exercise the correct mode(s) based on what the PR changes:\n\n- **Presets mode** (`cmake.useCMakePresets: \"always\"`): Uses `CMakePresets.json` \u002F `CMakeUserPresets.json`. Test this mode when the PR touches preset loading, expansion, resolution, or any code gated on `useCMakePresets === true`.\n- **Kits\u002Fvariants mode** (`cmake.useCMakePresets: \"never\"`): Uses kits (compiler selection) and variants (build type). Test this mode when the PR touches kit scanning, kit selection, variant handling, or any code gated on `useCMakePresets === false`.\n- **Both modes**: When the PR touches shared logic (driver code, build runner, environment merging, target resolution), create configurations for both modes. Use separate `.vscode\u002Fsettings.json` comments or preset variants to document which mode each test exercises.\n\n#### Generator-aware testing\n\n- **Single-config generators** (Ninja, Unix Makefiles): Use `CMAKE_BUILD_TYPE` at configure time. Test when the PR involves configure-time build type logic.\n- **Multi-config generators** (Ninja Multi-Config, Visual Studio, Xcode): Use `--config` at build time. Test when the PR involves build-time configuration selection.\n- When the PR touches generator-agnostic code, include presets or instructions for testing with both types.\n\n#### Principles\n\n- **Minimal and focused.** Only include what's needed to trigger the behavior. Don't add unrelated targets, dependencies, or complexity.\n- **Pre-wired to trigger the bug.** Configuration should be set up so that simply opening the project in VS Code and running CMake: Configure (or the relevant command) exercises the changed behavior. The user shouldn't need to manually edit config files first.\n- **Include regression scenarios when appropriate.** If the PR changes shared code paths, include a second preset or configuration variant that tests an unaffected path to verify no regression.\n- **Mark unknowns.** If you can't determine the exact reproduction setup from the PR, add `\u003C!-- TODO: ... -->` comments explaining what the user needs to fill in.\n\n### Step 7: Summary\n\nAfter creating all files, present a summary:\n\n```\n✅ Validation project created: {directory-name}\n\nFiles:\n  ? README.md              — Project overview, repro steps, and validation plan\n  ? manual-checklist.md     — Step-by-step testing checklist\n  ? validation.json         — Machine-readable PR metadata\n  ? CMakeLists.txt          — CMake project definition\n  ? CMakePresets.json       — CMake presets configuration\n  ? src\u002Fmain.cpp            — Minimal source file(s)\n  ? .vscode\u002Fsettings.json   — VS Code \u002F CMake Tools settings (if applicable)\n\nNext steps:\n  1. Open the project directory in VS Code with the PR build of CMake Tools loaded\n  2. Follow README.md to repro the issue and validate the fix\n  3. Work through manual-checklist.md for full coverage\n  4. Update validation.json status as you go\n```\n\n## Guidelines\n\n- Always pin to a specific commit SHA for reproducibility\n- Be honest when information is insufficient — mark gaps clearly rather than guessing\n- Tailor all content to the specific PR; avoid generic boilerplate\n- Keep file paths Windows-compatible (backslashes, no special characters)\n- If the user provides additional context about what to test, incorporate it\n- When updating an existing validation project, preserve user-added content\n",{"name":5,"description":7},"main","e0969b894e56d8ea5e6641d48a82e5ba3babcc38",".github\u002Fskills\u002Fvalidation-project",559,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cmake-tools","https:\u002F\u002Faka.ms\u002Fvscode-cmake-tools","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-11 06:52:38",{"source":8,"skillName":5,"commands":63,"prompt":73,"zipAvailable":74},[64,67,70],{"tool":65,"command":66},"npx","npx skills add microsoft\u002Fvscode-cmake-tools --skill validation-project",{"tool":68,"command":69},"bunx","bunx skills add microsoft\u002Fvscode-cmake-tools --skill validation-project",{"tool":71,"command":72},"pnpm","pnpm dlx skills add microsoft\u002Fvscode-cmake-tools --skill validation-project","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cmake-tools\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fvalidation-project\u002FSKILL.md",true,[],[77,97,115,151,169,186],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":84,"publishedAt":47},"01M69B6FDXF7VSNN4VH8MJ2230","presets-vs-kits","Use when writing or reviewing code that must work in both CMake Presets and Kits\u002FVariants modes. Covers configure, build, test, environment, and generator paths. Triggers: \"presets vs kits\", \"useCMakePresets\", \"works in both modes\".","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cmake-tools\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fpresets-vs-kits\u002FSKILL.md",[83],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[85,86,45,39,87,88,89,34,33,90,91,92,93,94,95,96,27],"presets vs kits","writing","code","configure","work","build","triggers","paths","reviewing code","generator","modes","variants",{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":47},"01M69B6CQT3K9X5HSCQ10ZX54T","pr-readiness","Verify that a pull request into microsoft\u002Fvscode-cmake-tools meets contribution requirements. Use when preparing, reviewing, or finalizing a PR to check for a descriptive title, a meaningful description, a properly formatted CHANGELOG entry, code correctness, regression risks, adherence to existing patterns, and whether documentation updates are needed.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cmake-tools\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fpr-readiness\u002FSKILL.md",[],[41,104,105,9,44,42,40,39,87,106,37,107,108,33,109,110,111,112,30,113,114,27],"pr readiness","readiness","changelog","regression","check","requirements","contribution","correctness","updates","Existing","title",{"skillNo":116,"name":117,"nameZh":6,"description":118,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":119,"categories":120,"keywords":136,"publishedAt":47},"01M69B69SPZQSR8YNAZMMNERE4","backend-tests","Use when writing unit tests under test\u002Funit-tests\u002Fbackend\u002F*.test.ts that run in Node with Mocha+Chai and no VS Code API. For pure logic: parsers, helpers, env merging. Triggers: \"backend test\", \"unit test\", \"mocha test without vscode\".","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cmake-tools\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fbackend-tests\u002FSKILL.md",[121,122,125,128,133],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":123,"categoryName":124,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":126,"categoryName":127,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":129,"categoryName":130,"taxonomyType":131,"taxonomyTypeDesc":132},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",{"categoryNo":134,"categoryName":135,"taxonomyType":131,"taxonomyTypeDesc":132},"01JBSEEDCAT000000000000036","内容创作者",[137,138,139,86,45,44,140,141,87,142,143,144,33,91,145,146,147,148,30,149,27,150],"backend tests","backend","tests","unit tests","run","api","parsers","node","chai","unit","unit-tests","mocha","unit test","helpers",{"skillNo":152,"name":153,"nameZh":6,"description":154,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":155,"categories":156,"keywords":157,"publishedAt":47},"01M69B67VACEFYYR745B6WBF4J","add-setting","Use when adding a new cmake.* configuration setting. Touches package.json (contributes.configuration), package.nls.json, src\u002Fconfig.ts (interface + getter), docs\u002Fcmake-settings.md, and CHANGELOG.md. Triggers: \"add setting\", \"new setting\", \"add configuration\".","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cmake-tools\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fadd-setting\u002FSKILL.md",[],[158,159,160,161,39,106,162,163,164,165,33,166,91,167,27,168],"add setting","add","docs","config","package","src","json","settings","configuration","interface","new",{"skillNo":170,"name":171,"nameZh":6,"description":172,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":173,"categories":174,"keywords":175,"publishedAt":47},"01M69B64R9S01TGSH17SSHW9V6","add-diagnostic-parser","Use when adding a compiler or tool output parser for the Problems panel. Touches src\u002Fdiagnostics\u002F\u003Cname>.ts, src\u002Fdiagnostics\u002Fbuild.ts, package.json (cmake.enabledOutputParsers), and package.nls.json. Triggers: \"add parser\", \"new diagnostic parser\", \"parse compiler output\".","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cmake-tools\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fadd-diagnostic-parser\u002FSKILL.md",[],[176,177,159,178,179,180,39,162,181,163,182,33,90,91,183,184,30,185,27,168],"add diagnostic parser","parser","add diagnostic","diagnostic","diagnostics","compiler","tool","panel","output","parse",{"skillNo":187,"name":188,"nameZh":6,"description":189,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":190,"categories":191,"keywords":192,"publishedAt":47},"01M69B622J8838QDVAQMQ0854Z","add-command","Use when adding a new cmake.* command to CMake Tools. Touches package.json (contributes.commands), package.nls.json, src\u002Fextension.ts (funs array), and CHANGELOG.md. Triggers: \"add command\", \"register command\", \"new command palette entry\".","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cmake-tools\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fadd-command\u002FSKILL.md",[],[193,194,159,39,195,106,162,35,163,164,33,196,91,197,198,199,200,27,168],"add command","command","command palette","commands","extension","register","palette","entry"]