[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M756MMMD9D3AD338VBRZNRS5":3,"skill-same:01M756MMMD9D3AD338VBRZNRS5":45},{"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":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M756MMMD9D3AD338VBRZNRS5","item-management",null,"Patterns for managing MSBuild item groups: Include\u002FRemove\u002FUpdate semantics, item metadata, batching with %(Metadata), transforms, per-item filtering, and cross-product batching pitfalls. Only activate in MSBuild\u002F.NET build context. USE FOR: diagnosing and fixing item group anti-patterns in .csproj files, reviewing item management for correctness, fixing CS2002 duplicate file warnings from SDK globbing, fixing targets that run more times than expected due to cross-product batching, fixing Include vs Update misuse on SDK-globbed items, fixing FileWrites registration for generated file clean support, moving generated files to IntermediateOutputPath. DO NOT USE FOR: target chain architecture (use target-authoring), property patterns (use property-patterns), incrementality (use incremental-build), general anti-patterns (use msbuild-antipatterns), non-MSBuild build systems.","weiflycc-cmd\u002Fskills","weiflycc-cmd","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F250846518?v=4","01M756C4PFGZJWKK04WFB9S5XF","威飛工作室","01M756C4QJJ66QDXN2RN6SXY87",0,"MIT","https:\u002F\u002Fgithub.com\u002Fweiflycc-cmd\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fdotnet-msbuild\u002Fskills\u002Fitem-management\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: item-management\ndescription: \"Patterns for managing MSBuild item groups: Include\u002FRemove\u002FUpdate semantics, item metadata, batching with %(Metadata), transforms, per-item filtering, and cross-product batching pitfalls. Only activate in MSBuild\u002F.NET build context. USE FOR: diagnosing and fixing item group anti-patterns in .csproj files, reviewing item management for correctness, fixing CS2002 duplicate file warnings from SDK globbing, fixing targets that run more times than expected due to cross-product batching, fixing Include vs Update misuse on SDK-globbed items, fixing FileWrites registration for generated file clean support, moving generated files to IntermediateOutputPath. DO NOT USE FOR: target chain architecture (use target-authoring), property patterns (use property-patterns), incrementality (use incremental-build), general anti-patterns (use msbuild-antipatterns), non-MSBuild build systems.\"\nlicense: MIT\n---\n\n# MSBuild Item Management Patterns\n\nCanonical patterns for working with item groups, from `Microsoft.Common.CurrentVersion.targets`.\n\n## Include \u002F Remove \u002F Update — Three Operations\n\n| Operation | Purpose | When to use |\n|---|---|---|\n| `Include` | Add new items to the group | Creating items with identity + metadata |\n| `Remove` | Remove items matching a pattern | Excluding files or clearing a group |\n| `Update` | Modify metadata on existing items | Adding\u002Fchanging metadata without re-adding |\n\n### Include — Add Items\n\n```xml\n\u003CItemGroup>\n  \u003CCompile Include=\"Generated\\*.cs\">\n    \u003CAutoGen>true\u003C\u002FAutoGen>\n  \u003C\u002FCompile>\n\u003C\u002FItemGroup>\n```\n\n### Remove — Subtract Items\n\n```xml\n\u003CItemGroup>\n  \u003C!-- Remove specific items -->\n  \u003CReference Remove=\"$(AdditionalExplicitAssemblyReferences)\" \u002F>\n\n  \u003C!-- Set subtraction: prior minus current -->\n  \u003C_CleanOrphanFileWrites Include=\"@(_CleanPriorFileWrites)\"\n      Exclude=\"@(_CleanCurrentFileWrites)\" \u002F>\n\n  \u003C!-- Clear an entire group -->\n  \u003C_Temporary Remove=\"@(_Temporary)\" \u002F>\n\u003C\u002FItemGroup>\n```\n\n### Update — Modify Existing Items\n\n```xml\n\u003CItemGroup>\n  \u003CEmbeddedResource Update=\"@(EmbeddedResource)\"\n      Condition=\"'%(NuGetPackageId)' == 'Microsoft.CodeAnalysis.Collections'\">\n    \u003CGenerateSource>true\u003C\u002FGenerateSource>\n    \u003CClassName>Microsoft.CodeAnalysis.Collections.SR\u003C\u002FClassName>\n  \u003C\u002FEmbeddedResource>\n\u003C\u002FItemGroup>\n```\n\n`Update` does not add items — it only modifies items already in the group.\n\n## Item Batching — %(Metadata)\n\nWhen `%(Metadata)` appears in target attributes or task parameters, MSBuild **batches** execution per unique metadata value.\n\n### Target-level batching (Outputs)\n\n```xml\n\u003CTarget Name=\"GenerateSatelliteAssemblies\"\n    Inputs=\"$(MSBuildAllProjects);@(_SatelliteAssemblyResourceInputs)\"\n    Outputs=\"$(IntermediateOutputPath)%(Culture)\\$(TargetName).resources.dll\">\n  \u003C!-- Runs once per unique Culture value -->\n\u003C\u002FTarget>\n```\n\n### Task-level batching\n\n```xml\n\u003CCopy SourceFiles=\"@(_SourceItems)\"\n    DestinationFiles=\"@(_SourceItems->'$(OutDir)%(TargetPath)')\">\n\u003C\u002FCopy>\n```\n\n### Per-item filtering with Condition\n\n```xml\n\u003CItemGroup>\n  \u003C_ResxOutput Include=\"@(EmbeddedResource->'%(OutputResource)')\"\n      Condition=\"'%(EmbeddedResource.WithCulture)' == 'false'\" \u002F>\n\u003C\u002FItemGroup>\n```\n\n### Batching rules\n\n- `%(Metadata)` in `Condition` or `Outputs` → target batches per unique value.\n- `%(Metadata)` in task parameters → task batches per unique value.\n- **Do not mix `%()` from different item groups** in the same expression — this causes a cross-product (see Common Pitfalls).\n\n## Item Transforms — @(Item->'expression')\n\nTransforms create new item lists by applying an expression to each item:\n\n```xml\n\u003C!-- Transform file paths to destinations -->\n\u003CCopy SourceFiles=\"@(IntermediateAssembly)\"\n    DestinationFiles=\"@(IntermediateAssembly->'$(OutDir)%(Filename)%(Extension)')\"\u002F>\n\n\u003C!-- Transform with separator for display -->\n\u003CMessage Text=\"Files: @(Compile->'%(Filename)', ', ')\" \u002F>\n```\n\n## Exclude Pattern — Set Subtraction on Include\n\n```xml\n\u003CItemGroup>\n  \u003CCompile Include=\"**\\*.cs\" Exclude=\"Generated\\**;Tests\\**\" \u002F>\n\u003C\u002FItemGroup>\n```\n\n`Exclude` only works on `Include` — it cannot be used with `Update` or `Remove`.\n\n## Conditional Item Inclusion\n\n```xml\n\u003C!-- Condition on ItemGroup — all or nothing -->\n\u003CItemGroup Condition=\"'$(NetCoreBuild)' == 'true'\">\n  \u003CPackageReference Include=\"System.IO.Pipelines\" \u002F>\n\u003C\u002FItemGroup>\n\n\u003C!-- Condition on individual items -->\n\u003CItemGroup>\n  \u003CPackageReference Include=\"System.IO.Pipelines\"\n      Condition=\"'$(NetCoreBuild)' == 'true'\" \u002F>\n\u003C\u002FItemGroup>\n```\n\n## PrivateAssets on Tool\u002FAnalyzer Packages\n\n```xml\n\u003CItemGroup>\n  \u003CPackageReference Include=\"Microsoft.CodeAnalysis.NetAnalyzers\" PrivateAssets=\"all\" \u002F>\n  \u003CPackageReference Include=\"StyleCop.Analyzers\" PrivateAssets=\"all\" \u002F>\n\u003C\u002FItemGroup>\n```\n\n## Common Pitfalls\n\n### Cross-product batching\n\nReferencing `%(Metadata)` from two different item groups creates O(N×M) executions:\n\n```xml\n\u003C!-- BAD: Cross-product of @(Source) × @(Config) -->\n\u003CExec Command=\"process %(Source.Identity) with %(Config.Identity)\" \u002F>\n\n\u003C!-- GOOD: Reference one group via batching, the other via property -->\n\u003CExec Command=\"process %(Source.Identity) with $(ConfigFile)\" \u002F>\n```\n\n### Generated files in source tree\n\nWrite to `$(IntermediateOutputPath)` (obj\u002F), not the source directory. Source-tree generation pollutes version control and can cause duplicate compilation via globs.\n\n### Missing FileWrites\n\nEvery file created during a target must be added to `@(FileWrites)` for `dotnet clean` support.\n","# MSBuild Item Management Patterns\n\nCanonical patterns for working with item groups, from `Microsoft.Common.CurrentVersion.targets`.\n\n## Include \u002F Remove \u002F Update — Three Operations\n\n| Operation | Purpose | When to use |\n|---|---|---|\n| `Include` | Add new items to the group | Creating items with identity + metadata |\n| `Remove` | Remove items matching a pattern | Excluding files or clearing a group |\n| `Update` | Modify metadata on existing items | Adding\u002Fchanging metadata without re-adding |\n\n### Include — Add Items\n\n```xml\n\u003CItemGroup>\n  \u003CCompile Include=\"Generated\\*.cs\">\n    \u003CAutoGen>true\u003C\u002FAutoGen>\n  \u003C\u002FCompile>\n\u003C\u002FItemGroup>\n```\n\n### Remove — Subtract Items\n\n```xml\n\u003CItemGroup>\n  \u003C!-- Remove specific items -->\n  \u003CReference Remove=\"$(AdditionalExplicitAssemblyReferences)\" \u002F>\n\n  \u003C!-- Set subtraction: prior minus current -->\n  \u003C_CleanOrphanFileWrites Include=\"@(_CleanPriorFileWrites)\"\n      Exclude=\"@(_CleanCurrentFileWrites)\" \u002F>\n\n  \u003C!-- Clear an entire group -->\n  \u003C_Temporary Remove=\"@(_Temporary)\" \u002F>\n\u003C\u002FItemGroup>\n```\n\n### Update — Modify Existing Items\n\n```xml\n\u003CItemGroup>\n  \u003CEmbeddedResource Update=\"@(EmbeddedResource)\"\n      Condition=\"'%(NuGetPackageId)' == 'Microsoft.CodeAnalysis.Collections'\">\n    \u003CGenerateSource>true\u003C\u002FGenerateSource>\n    \u003CClassName>Microsoft.CodeAnalysis.Collections.SR\u003C\u002FClassName>\n  \u003C\u002FEmbeddedResource>\n\u003C\u002FItemGroup>\n```\n\n`Update` does not add items — it only modifies items already in the group.\n\n## Item Batching — %(Metadata)\n\nWhen `%(Metadata)` appears in target attributes or task parameters, MSBuild **batches** execution per unique metadata value.\n\n### Target-level batching (Outputs)\n\n```xml\n\u003CTarget Name=\"GenerateSatelliteAssemblies\"\n    Inputs=\"$(MSBuildAllProjects);@(_SatelliteAssemblyResourceInputs)\"\n    Outputs=\"$(IntermediateOutputPath)%(Culture)\\$(TargetName).resources.dll\">\n  \u003C!-- Runs once per unique Culture value -->\n\u003C\u002FTarget>\n```\n\n### Task-level batching\n\n```xml\n\u003CCopy SourceFiles=\"@(_SourceItems)\"\n    DestinationFiles=\"@(_SourceItems->'$(OutDir)%(TargetPath)')\">\n\u003C\u002FCopy>\n```\n\n### Per-item filtering with Condition\n\n```xml\n\u003CItemGroup>\n  \u003C_ResxOutput Include=\"@(EmbeddedResource->'%(OutputResource)')\"\n      Condition=\"'%(EmbeddedResource.WithCulture)' == 'false'\" \u002F>\n\u003C\u002FItemGroup>\n```\n\n### Batching rules\n\n- `%(Metadata)` in `Condition` or `Outputs` → target batches per unique value.\n- `%(Metadata)` in task parameters → task batches per unique value.\n- **Do not mix `%()` from different item groups** in the same expression — this causes a cross-product (see Common Pitfalls).\n\n## Item Transforms — @(Item->'expression')\n\nTransforms create new item lists by applying an expression to each item:\n\n```xml\n\u003C!-- Transform file paths to destinations -->\n\u003CCopy SourceFiles=\"@(IntermediateAssembly)\"\n    DestinationFiles=\"@(IntermediateAssembly->'$(OutDir)%(Filename)%(Extension)')\"\u002F>\n\n\u003C!-- Transform with separator for display -->\n\u003CMessage Text=\"Files: @(Compile->'%(Filename)', ', ')\" \u002F>\n```\n\n## Exclude Pattern — Set Subtraction on Include\n\n```xml\n\u003CItemGroup>\n  \u003CCompile Include=\"**\\*.cs\" Exclude=\"Generated\\**;Tests\\**\" \u002F>\n\u003C\u002FItemGroup>\n```\n\n`Exclude` only works on `Include` — it cannot be used with `Update` or `Remove`.\n\n## Conditional Item Inclusion\n\n```xml\n\u003C!-- Condition on ItemGroup — all or nothing -->\n\u003CItemGroup Condition=\"'$(NetCoreBuild)' == 'true'\">\n  \u003CPackageReference Include=\"System.IO.Pipelines\" \u002F>\n\u003C\u002FItemGroup>\n\n\u003C!-- Condition on individual items -->\n\u003CItemGroup>\n  \u003CPackageReference Include=\"System.IO.Pipelines\"\n      Condition=\"'$(NetCoreBuild)' == 'true'\" \u002F>\n\u003C\u002FItemGroup>\n```\n\n## PrivateAssets on Tool\u002FAnalyzer Packages\n\n```xml\n\u003CItemGroup>\n  \u003CPackageReference Include=\"Microsoft.CodeAnalysis.NetAnalyzers\" PrivateAssets=\"all\" \u002F>\n  \u003CPackageReference Include=\"StyleCop.Analyzers\" PrivateAssets=\"all\" \u002F>\n\u003C\u002FItemGroup>\n```\n\n## Common Pitfalls\n\n### Cross-product batching\n\nReferencing `%(Metadata)` from two different item groups creates O(N×M) executions:\n\n```xml\n\u003C!-- BAD: Cross-product of @(Source) × @(Config) -->\n\u003CExec Command=\"process %(Source.Identity) with %(Config.Identity)\" \u002F>\n\n\u003C!-- GOOD: Reference one group via batching, the other via property -->\n\u003CExec Command=\"process %(Source.Identity) with $(ConfigFile)\" \u002F>\n```\n\n### Generated files in source tree\n\nWrite to `$(IntermediateOutputPath)` (obj\u002F), not the source directory. Source-tree generation pollutes version control and can cause duplicate compilation via globs.\n\n### Missing FileWrites\n\nEvery file created during a target must be added to `@(FileWrites)` for `dotnet clean` support.\n",{"name":5,"license":15,"description":7},"main","5810d492c9b301d8227f932bf87b5c954c4fa4d6","plugins\u002Fdotnet-msbuild\u002Fskills\u002Fitem-management","https:\u002F\u002Fgithub.com\u002Fweiflycc-cmd\u002Fskills","https:\u002F\u002Fgithub.com\u002Fweiflycc-cmd","weiflycc.com","2026-11-10 03:26:55",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add weiflycc-cmd\u002Fskills --skill item-management",{"tool":37,"command":38},"bunx","bunx skills add weiflycc-cmd\u002Fskills --skill item-management",{"tool":40,"command":41},"pnpm","pnpm dlx skills add weiflycc-cmd\u002Fskills --skill item-management","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fweiflycc-cmd\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fdotnet-msbuild\u002Fskills\u002Fitem-management\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M76SGT4WG5682JQJ0V3NSK6X","system-text-json-net11","Provides guidance on new System.Text.Json APIs introduced in .NET 11. It covers typed JsonTypeInfo access via GetTypeInfo\u003CT> and TryGetTypeInfo\u003CT> on JsonSerializerOptions, and the new JsonNamingPolicy.PascalCase static property. Use when serializing or deserializing JSON in .NET 11 applications and needing typed metadata access or PascalCase property naming.","https:\u002F\u002Fgithub.com\u002Fweiflycc-cmd\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fdotnet11\u002Fskills\u002Fsystem-text-json-net11\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M76SGPNZYYV9BCZJW7BF7J8A","nuget-trusted-publishing","Set up NuGet trusted publishing (OIDC) on a GitHub Actions repo — replaces long-lived API keys with short-lived tokens. USE FOR: trusted publishing, NuGet OIDC, keyless NuGet publish, migrate from NuGet API key, NuGet\u002Flogin, secure NuGet publishing. DO NOT USE FOR: publishing to private feeds or Azure Artifacts (OIDC is nuget.org only). INVOKES: shell (powershell or bash), edit, create, ask_user for guided repo setup.","https:\u002F\u002Fgithub.com\u002Fweiflycc-cmd\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fdotnet\u002Fskills\u002Fnuget-trusted-publishing\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M76SGHVNBNVM1DMVDYTMAE5G","dotnet-pinvoke","Correctly call native (C\u002FC++) libraries from .NET using P\u002FInvoke and LibraryImport. Covers function signatures, string marshalling, memory lifetime, SafeHandle, and cross-platform patterns. USE FOR: writing new P\u002FInvoke or LibraryImport declarations, reviewing or debugging existing native interop code, wrapping a C or C++ library for use in .NET, diagnosing crashes, memory leaks, or corruption at the managed\u002Fnative boundary. DO NOT USE FOR: COM interop, C++\u002FCLI mixed-mode assemblies, or pure managed code with no native dependencies.","https:\u002F\u002Fgithub.com\u002Fweiflycc-cmd\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fdotnet\u002Fskills\u002Fdotnet-pinvoke\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M76SGDB9Z3GSB1CFW314NC84","csharp-scripts","Run file-based C# apps with the .NET CLI when the user explicitly wants C#\u002F.NET code without creating a project. Use for C# language\u002FAPI experiments, one-file C# apps, small multi-file C# apps composed with `#:include`\u002F`#:exclude`, or C# file-based apps linked with `#:ref`. Do not use for language-agnostic throwaway scripts, generic computations, Python\u002FPowerShell-style automation, full projects, or existing app integration.","https:\u002F\u002Fgithub.com\u002Fweiflycc-cmd\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fdotnet\u002Fskills\u002Fcsharp-scripts\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M76SG805T8W764WAKB1NP3CJ","thread-abort-migration","Guides migration of .NET Framework Thread.Abort usage to cooperative cancellation in modern .NET. USE FOR: modernizing code that calls Thread.Abort, catching ThreadAbortException, replacing Thread.ResetAbort, replacing Thread.Interrupt for thread termination, resolving PlatformNotSupportedException or SYSLIB0006 after retargeting to .NET 6+, migrating ASP.NET Response.End or Response.Redirect(url, true) which internally call Thread.Abort. DO NOT USE FOR: code that only uses Thread.Join, Thread.Sleep, or Thread.Start without any abort, interrupt, or ThreadAbortException usage — these APIs work identically in modern .NET and need no migration. Also not for projects staying on .NET Framework, or Thread.Abort usage inside third-party libraries you do not control.","https:\u002F\u002Fgithub.com\u002Fweiflycc-cmd\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fdotnet-upgrade\u002Fskills\u002Fthread-abort-migration\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M76SG2588ZJBE5C51HYJJSKV","migrate-nullable-references","Enable nullable reference types in a C# project and systematically resolve all warnings. USE FOR: adopting NRTs in existing codebases, file-by-file or project-wide migration, fixing CS8602\u002FCS8618\u002FCS86xx warnings, annotating APIs for nullability, cleaning up null-forgiving operators, upgrading dependencies with new nullable annotations. DO NOT USE FOR: projects already fully migrated with zero warnings (unless auditing suppressions), fixing a handful of nullable warnings in code that already has NRTs enabled, suppressing warnings without fixing them, C# 7.3 or earlier projects. INVOKES: Get-NullableReadiness.ps1 scanner script.","https:\u002F\u002Fgithub.com\u002Fweiflycc-cmd\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fdotnet-upgrade\u002Fskills\u002Fmigrate-nullable-references\u002FSKILL.md",[],[]]