[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CV63CEHT1XGPR6F4C82Q3T":3,"skill-same:01M7CV63CEHT1XGPR6F4C82Q3T":64},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M7CV63CEHT1XGPR6F4C82Q3T","dotnet-breaking-changes",null,"Use before changing .NET\u002FC# code whose callers you do not control: a NuGet library, or a repo with PublicAPI.Shipped\u002FUnshipped.txt, ApiCompat, multiple TargetFrameworks, InternalsVisibleTo, or generated (.g.cs) partials. Green builds miss silent breaks from optional parameters, parameter names, sealing, const values, nullability, and #if. USE FOR: \"without breaking existing callers\"; adding a public method, overload, optional parameter, or interface member to a shipped library; renaming a public method or an internal helper a friend assembly uses; consolidating duplicated logic; changing a signature, nullability, default, or attribute; adding a target framework; RS0016\u002FRS0017 or ApiCompat errors; \"is this PR breaking?\". For a rename, extract, or merge, also invoke csharp-refactoring. DO NOT USE FOR: an executable whose callers all live in one project; renaming a local variable or private member, even in a shipped library; formatting; framework\u002FSDK\u002FNuGet upgrades (use dotnet-upgrade).","deadmade\u002Fdead-agent-skills","deadmade","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F130925709?v=4","01M7CTQ65AGYR4J9K9TX0YR9V3","01M7CTQ66B4VMJFEDZP4EKKE6K",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fcsharp-skills\u002Flibrary\u002Fdotnet-breaking-changes\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: dotnet-breaking-changes\ndescription: >\n  Use before changing .NET\u002FC# code whose callers you do not control: a NuGet library, or a repo with\n  PublicAPI.Shipped\u002FUnshipped.txt, ApiCompat, multiple TargetFrameworks, InternalsVisibleTo, or\n  generated (.g.cs) partials. Green builds miss silent breaks from optional parameters, parameter\n  names, sealing, const values, nullability, and #if.\n  USE FOR: \"without breaking existing callers\"; adding a public method, overload, optional\n  parameter, or interface member to a shipped library; renaming a public method or an internal\n  helper a friend assembly uses; consolidating duplicated logic; changing a signature,\n  nullability, default, or attribute; adding a target framework; RS0016\u002FRS0017 or ApiCompat errors;\n  \"is this PR breaking?\". For a rename, extract, or merge, also invoke csharp-refactoring.\n  DO NOT USE FOR: an executable whose callers all live in one project; renaming a local variable\n  or private member, even in a shipped library; formatting; framework\u002FSDK\u002FNuGet upgrades\n  (use dotnet-upgrade).\nlicense: MIT\n---\n\n# .NET breaking changes: the contract is wider than the file\n\nWhen you edit .NET code, the observable contract is usually **larger than the snippet in front of you**.\nA change that compiles and keeps tests green can still break a downstream consumer, another target\nframework, a friend assembly, or regenerate away on the next build. This applies to a feature or a bug\nfix as much as a refactor, and to **additions** — a new public member, overload, or target framework — as\nmuch as removals: added surface is a permanent contract obligation, and added behavior on a multi-targeted\nor partial type must stay correct on every target and survive the next regeneration. (For the\nbehavior-preserving refactoring *process*, use the `csharp-refactoring` skill; this skill is the\ncompatibility knowledge it — and any other change — taps into.)\n\n## Inspect first — find which surfaces this repo actually has\n\nThe most valuable move is to **look before you leap**: find which hidden surfaces exist here, then check\nonly those. Don't recite these or assume — the markers present dictate the plan; markers absent tell you a\nsurface is not in play.\n\n```bash\n# Public-API gate (which one? they are NOT interchangeable)\ngit ls-files \"**\u002FPublicAPI.Shipped.txt\" \"**\u002FPublicAPI.Unshipped.txt\"                 # PublicApiAnalyzers\ngrep -rl \"EnablePackageValidation\\|ApiCompat\" --include=*.props --include=*.targets --include=*.csproj .\n# Multi-targeting and conditional code\ngrep -rl \"\u003CTargetFrameworks>\" --include=*.csproj --include=*.props . ; grep -rn \"#if \" --include=*.cs .\n# Generated \u002F partial code\ngit ls-files \"*.g.cs\" \"*.generated.cs\" ; grep -rln \"partial class\\|partial record\\|partial struct\" --include=*.cs .\n# Friend assemblies\ngrep -rn \"InternalsVisibleTo\" --include=*.cs --include=*.csproj --include=*.props .\n```\n\nThen read only the reference(s) for the surfaces you actually found. For every `InternalsVisibleTo`\nname, check whether that project is in the solution: a friend **not** built here is an external\nconsumer of every internal it can see, exactly like a public caller, and a green solution build proves\nnothing about it.\n\nBefore editing, confirm the request's premise is true in the code. For \"consolidate\", \"deduplicate\", or\n\"add X\" requests, trace the actual calls: if one type already delegates to the other, or the member\nalready exists, the work is done — change nothing and report the delegating call (see Stop and escalate).\n\n## The hidden surfaces (depth in references\u002F)\n\nPublic API (1) is the **default** surface to check on any library edit; the other three are\n**conditional** — pursue them only when the inspect-first markers above show they are in play.\n\n1. **Public API.** Renaming\u002Fmoving\u002Fremoving\u002Fre-signing a public member — or changing nullability, a\n   generic constraint, or a trimming\u002FAOT attribute — is a breaking change a green test run will not catch.\n   Repos gate this **two non-interchangeable ways**: source-level (`PublicApiAnalyzers` + `PublicAPI.*.txt`,\n   which you maintain) and binary\u002Fpackage-level (`ApiCompat` \u002F `\u003CEnablePackageValidation>`). Respect the\n   gate that exists; if none exists, review the surface by hand and flag it — do **not** bolt on analyzer\n   infrastructure as a side effect. Move a public type via a `[TypeForwardedTo]` forwarder; a *rename*\n   needs an `[Obsolete]` shim, not a forwarder. See `references\u002Fpublic-api.md`.\n\n2. **Multi-targeting and `#if`.** Code that multi-targets (`\u003CTargetFrameworks>`) or compiles conditionally\n   (`#if NET8_0_OR_GREATER`, platform\u002FCoreCLR\u002FMono\u002FNativeAOT branches) can build for the target your editor\n   shows and break one it never invoked. Inspect every branch — including inactive ones — preserve\n   intentional divergence, and re-gate each TFM\u002FRID. See `references\u002Fmulti-targeting.md`.\n\n3. **Source-generated and partial code.** A type is often `partial` across several files, and part may be\n   **generated** (source generators, Razor, `*.g.cs`). Include every partial declaration; treat generated\n   files as derived and change the generator input\u002Ftemplate unless the repo checks the output in as source.\n   See `references\u002Fsource-generation.md`.\n\n4. **InternalsVisibleTo.** `internal` is not private across a solution: test and friend assemblies bind to\n   internals (and, when strong-named, to a public key). An internal rename\u002Fmove\u002Fremoval can break a\n   consumer with no reference in the declaring project. A friend built outside this repo cannot be\n   updated, so keep the old internal name as an `[Obsolete]` forwarder. See `references\u002Finternals-visible-to.md`.\n\n## Decisions a green build will not make for you\n\nEach row below compiles every caller and passes every test, yet breaks a consumer. Do not stop at a\ngreen build or test run. Use the safe shape instead.\n\nWhen the safe shape departs from the literal request — an overload instead of the requested optional\nparameter, a forwarder kept instead of a deleted or renamed member, or no change at all — say so in your\nfinal answer in one or two sentences: what you did instead, and which consumer it would have broken\n(e.g. \"already-compiled callers would throw `MissingMethodException`\"). A silent substitution reads as\nignoring the request.\n\nTreat that substitution as one atomic deliverable: implement the safe shape, preserve the old contract\nand shipped baseline, test both old and new entry points, and explain the compatibility reason. After the\nlast edit, inspect the diff or reopen the implementation file before claiming success. A green test run\ndoes not prove a failed patch applied when the unchanged fixture already passes those tests.\n\nDo not use labels such as \"for binary compatibility\" as the whole explanation. Name the exact old\nentry point that remains, the consumer that still binds to it, and the concrete failure avoided. For\nexample: \"Kept `Parse(string?, int)` unchanged because already-compiled consumers still request that\nexact method and would throw `MissingMethodException` if it disappeared.\" For source-only breaks, name\nthe affected syntax (`raw:` named arguments, derivation from a newly sealed class, or nullable callers)\ninstead. This causal sentence is part of the implementation, not optional release-note polish.\n\n| Tempting change | Why it breaks | Safe shape |\n|-----------------|---------------|------------|\n| Add an optional parameter to a shipped method (`Foo(a)` → `Foo(a, b = null)`) | **Binary break**: the old signature is gone, so already-compiled consumers throw `MissingMethodException` until they recompile | Keep `Foo(a)` unchanged and add a new overload `Foo(a, b)` with `b` required on that overload; omission continues to select the old method. Record only the new overload |\n| Fix RS0017 by editing or deleting a line in `PublicAPI.Shipped.txt` | Shipped lines are the released contract; rewriting one hides the break the gate exists to report | Leave shipped lines alone. Restore the shipped member and record new surface in `PublicAPI.Unshipped.txt` |\n| Add a member to a shipped public interface | Every existing implementer, including ones in other packages, stops compiling | Add a default interface implementation (requires runtime support: not on `netstandard2.0` or .NET Framework targets), or add a new interface. A default member is callable only through the interface, so also add a public member on any concrete type that must expose it, and record both |\n| Rename a shipped member | Source and binary break | Add the new name, keep the old one as an `[Obsolete]` forwarder, and record only the new member |\n| Rename or remove an `internal` member when `InternalsVisibleTo` names an assembly not in the solution | That friend was compiled against the old name and cannot be updated from this repo; it fails at bind time | Add the new name, migrate in-repo callers, keep the old internal name as an `[Obsolete]` forwarder, keep the grant, and name the protected friend in the answer |\n| Rename a parameter of a shipped member | Callers passing it by name (`raw: x`) stop compiling and late-bound\u002F`dynamic` callers fail; positional callers in this repo hide it. PublicAPI analyzers report it as RS0016 + RS0017 | Keep the shipped name — no overload can carry a different name for the same signature. Leave it unchanged and edit nothing else; you may offer (not make) a clearer XML `\u003Cparam>` doc, or the rename at the next major version |\n| Seal a class, make a member non-virtual, or narrow a parameter's nullability | Derived types, overrides, or nullable callers break | Treat as a breaking change; escalate rather than edit |\n| Change a `const` value or an optional parameter's default | The old value is compiled into callers and persists until they recompile | Preserve the shipped constant\u002Fdefault; introduce a separately named member (which may be `static readonly`) or a new overload for new behavior. Replacing an existing `const` with `static readonly` is itself source-breaking |\n| Change a value under `#if` for one target | Only consumers of that target see it; tests edited to match will not catch it | Treat as a behavior change for that target and call it out |\n\nWhenever you kept an old entry point or departed from the literal request, the final answer must\ncontain this line, filled in — terse bullets such as \"preserved for binary consumers\" do not satisfy it:\n\n> **Compatibility:** Kept `\u003Cexact old signature>` unchanged because `\u003Cwho still binds to it>` would\n> `\u003Cconcrete failure>` if it changed. `\u003CWhat you did instead of the literal request, and why.>`\n\nBefore finishing a compatibility-preserving edit, make the delta easy to audit:\n\n1. Name the **new** entry point or behavior and the **exact old** entry point that remains.\n2. Name the in-repo caller, generated template, or friend assembly you migrated, plus any external\n   consumer you could not migrate and therefore protected with a forwarder.\n3. State which baseline stayed unchanged and which new surface was recorded.\n4. Report the exact compatibility check that exercised the old entry point as well as the new one.\n\nFor a no-change outcome, lead with `No files changed.` and identify the decisive evidence before any\ngeneral explanation: the existing delegation, shipped signature, parameter name, or nullability line.\n\nWhen asked **\"is this a breaking change?\"** or to review a diff, make no edits unless asked and answer\nin this shape, scaled to the diff:\n\n1. One verdict line first (e.g. \"Do not merge as-is: N changes break consumers\").\n2. One numbered item per consumer-visible change: what changed, **binary** (already-compiled\n   consumers fail), **source** (consumers fail to recompile), or **behavioral** (same signature,\n   different result, possibly on only one target), who breaks, **why CI stayed green** (a shipped\n   API line rewritten, a test edited to match, or a change the analyzer does not track, such as\n   `sealed` or a private `const`), and the safe shape. State each as fact or not at all: a\n   behavioral claim needs a concrete input whose old and new results differ; if unsure, probe both\n   versions with a one-line program — framework parsers already tolerate much (e.g. `bool.TryParse`\n   ignores surrounding whitespace), and a no-op rewrite is not a break.\n3. One closing \"Not breaking:\" line covering every remaining hunk with its reason (internal-only\n   edits, probed no-ops), instead of side notes inside the numbered items.\n\nCover only surfaces the diff touches; do not add trimming, AOT, or tooling commentary it does not raise.\n\n## Verify before reporting\n\nBuild and test **every** target framework (`dotnet test -f \u003Ctfm>` for each), not only the default. If\nthe project sets `EnablePackageValidation`, run `dotnet pack` — package validation runs only after\n`Pack`, never on build. Report exactly which commands ran and their result.\n\n## Stop and escalate (do not silently proceed)\n\n- The requested change is **already in place** — e.g. the \"duplicated\" code already delegates to one\n  implementation, or the overload already exists. Say so and change nothing; do not invent a\n  refactor to have something to show.\n- A **public\u002Fshipped API** would change and you cannot verify compatibility — no shim\u002Fforwarder path and\n  no PublicApiAnalyzers\u002FApiCompat\u002Fpackage-validation gate to catch a break.\n- The edit changes an **observable annotation** (nullability, `[DynamicallyAccessedMembers]`,\n  `[RequiresUnreferencedCode]`, generic constraints) on a public member.\n- The change can be made consistent across **some but not all** target frameworks or platforms.\n- The only way to apply it is editing **generated output** that the next build will overwrite.\n\nWhen you change nothing (the request is already done or has no safe shape), a bare \"no\" looks like\nignoring the request. Make the final answer show the work, in this order: \"No files changed.\" and why;\nthe evidence that decided it (the shipped `PublicAPI.Shipped.txt` line, or the call that already\ndelegates, with its file); who would break, or where the single implementation already lives; what the\nuser *can* do instead, if anything; and the validation you ran.\n\n## Reference files\n\nLoad a reference only for a surface the inspect-first step actually found:\n\n- **[references\u002Fpublic-api.md](references\u002Fpublic-api.md)** — the two API gates and why they are not\n  interchangeable, nullable\u002Ftrimming\u002FAOT as observable API, `[Obsolete]` shims and type-forwarders,\n  suppression baselines.\n- **[references\u002Fmulti-targeting.md](references\u002Fmulti-targeting.md)** — TFMs, `#if` and platform symbols,\n  RIDs, and how to inspect and re-gate every target.\n- **[references\u002Fsource-generation.md](references\u002Fsource-generation.md)** — partial types, generated output\n  vs checked-in source, editing the generator input. (See also `dotnet-msbuild\u002Fincluding-generated-files`.)\n- **[references\u002Finternals-visible-to.md](references\u002Finternals-visible-to.md)** — friend\u002Ftest assemblies\n  and strong-name keys.\n","# .NET breaking changes: the contract is wider than the file\n\nWhen you edit .NET code, the observable contract is usually **larger than the snippet in front of you**.\nA change that compiles and keeps tests green can still break a downstream consumer, another target\nframework, a friend assembly, or regenerate away on the next build. This applies to a feature or a bug\nfix as much as a refactor, and to **additions** — a new public member, overload, or target framework — as\nmuch as removals: added surface is a permanent contract obligation, and added behavior on a multi-targeted\nor partial type must stay correct on every target and survive the next regeneration. (For the\nbehavior-preserving refactoring *process*, use the `csharp-refactoring` skill; this skill is the\ncompatibility knowledge it — and any other change — taps into.)\n\n## Inspect first — find which surfaces this repo actually has\n\nThe most valuable move is to **look before you leap**: find which hidden surfaces exist here, then check\nonly those. Don't recite these or assume — the markers present dictate the plan; markers absent tell you a\nsurface is not in play.\n\n```bash\n# Public-API gate (which one? they are NOT interchangeable)\ngit ls-files \"**\u002FPublicAPI.Shipped.txt\" \"**\u002FPublicAPI.Unshipped.txt\"                 # PublicApiAnalyzers\ngrep -rl \"EnablePackageValidation\\|ApiCompat\" --include=*.props --include=*.targets --include=*.csproj .\n# Multi-targeting and conditional code\ngrep -rl \"\u003CTargetFrameworks>\" --include=*.csproj --include=*.props . ; grep -rn \"#if \" --include=*.cs .\n# Generated \u002F partial code\ngit ls-files \"*.g.cs\" \"*.generated.cs\" ; grep -rln \"partial class\\|partial record\\|partial struct\" --include=*.cs .\n# Friend assemblies\ngrep -rn \"InternalsVisibleTo\" --include=*.cs --include=*.csproj --include=*.props .\n```\n\nThen read only the reference(s) for the surfaces you actually found. For every `InternalsVisibleTo`\nname, check whether that project is in the solution: a friend **not** built here is an external\nconsumer of every internal it can see, exactly like a public caller, and a green solution build proves\nnothing about it.\n\nBefore editing, confirm the request's premise is true in the code. For \"consolidate\", \"deduplicate\", or\n\"add X\" requests, trace the actual calls: if one type already delegates to the other, or the member\nalready exists, the work is done — change nothing and report the delegating call (see Stop and escalate).\n\n## The hidden surfaces (depth in references\u002F)\n\nPublic API (1) is the **default** surface to check on any library edit; the other three are\n**conditional** — pursue them only when the inspect-first markers above show they are in play.\n\n1. **Public API.** Renaming\u002Fmoving\u002Fremoving\u002Fre-signing a public member — or changing nullability, a\n   generic constraint, or a trimming\u002FAOT attribute — is a breaking change a green test run will not catch.\n   Repos gate this **two non-interchangeable ways**: source-level (`PublicApiAnalyzers` + `PublicAPI.*.txt`,\n   which you maintain) and binary\u002Fpackage-level (`ApiCompat` \u002F `\u003CEnablePackageValidation>`). Respect the\n   gate that exists; if none exists, review the surface by hand and flag it — do **not** bolt on analyzer\n   infrastructure as a side effect. Move a public type via a `[TypeForwardedTo]` forwarder; a *rename*\n   needs an `[Obsolete]` shim, not a forwarder. See `references\u002Fpublic-api.md`.\n\n2. **Multi-targeting and `#if`.** Code that multi-targets (`\u003CTargetFrameworks>`) or compiles conditionally\n   (`#if NET8_0_OR_GREATER`, platform\u002FCoreCLR\u002FMono\u002FNativeAOT branches) can build for the target your editor\n   shows and break one it never invoked. Inspect every branch — including inactive ones — preserve\n   intentional divergence, and re-gate each TFM\u002FRID. See `references\u002Fmulti-targeting.md`.\n\n3. **Source-generated and partial code.** A type is often `partial` across several files, and part may be\n   **generated** (source generators, Razor, `*.g.cs`). Include every partial declaration; treat generated\n   files as derived and change the generator input\u002Ftemplate unless the repo checks the output in as source.\n   See `references\u002Fsource-generation.md`.\n\n4. **InternalsVisibleTo.** `internal` is not private across a solution: test and friend assemblies bind to\n   internals (and, when strong-named, to a public key). An internal rename\u002Fmove\u002Fremoval can break a\n   consumer with no reference in the declaring project. A friend built outside this repo cannot be\n   updated, so keep the old internal name as an `[Obsolete]` forwarder. See `references\u002Finternals-visible-to.md`.\n\n## Decisions a green build will not make for you\n\nEach row below compiles every caller and passes every test, yet breaks a consumer. Do not stop at a\ngreen build or test run. Use the safe shape instead.\n\nWhen the safe shape departs from the literal request — an overload instead of the requested optional\nparameter, a forwarder kept instead of a deleted or renamed member, or no change at all — say so in your\nfinal answer in one or two sentences: what you did instead, and which consumer it would have broken\n(e.g. \"already-compiled callers would throw `MissingMethodException`\"). A silent substitution reads as\nignoring the request.\n\nTreat that substitution as one atomic deliverable: implement the safe shape, preserve the old contract\nand shipped baseline, test both old and new entry points, and explain the compatibility reason. After the\nlast edit, inspect the diff or reopen the implementation file before claiming success. A green test run\ndoes not prove a failed patch applied when the unchanged fixture already passes those tests.\n\nDo not use labels such as \"for binary compatibility\" as the whole explanation. Name the exact old\nentry point that remains, the consumer that still binds to it, and the concrete failure avoided. For\nexample: \"Kept `Parse(string?, int)` unchanged because already-compiled consumers still request that\nexact method and would throw `MissingMethodException` if it disappeared.\" For source-only breaks, name\nthe affected syntax (`raw:` named arguments, derivation from a newly sealed class, or nullable callers)\ninstead. This causal sentence is part of the implementation, not optional release-note polish.\n\n| Tempting change | Why it breaks | Safe shape |\n|-----------------|---------------|------------|\n| Add an optional parameter to a shipped method (`Foo(a)` → `Foo(a, b = null)`) | **Binary break**: the old signature is gone, so already-compiled consumers throw `MissingMethodException` until they recompile | Keep `Foo(a)` unchanged and add a new overload `Foo(a, b)` with `b` required on that overload; omission continues to select the old method. Record only the new overload |\n| Fix RS0017 by editing or deleting a line in `PublicAPI.Shipped.txt` | Shipped lines are the released contract; rewriting one hides the break the gate exists to report | Leave shipped lines alone. Restore the shipped member and record new surface in `PublicAPI.Unshipped.txt` |\n| Add a member to a shipped public interface | Every existing implementer, including ones in other packages, stops compiling | Add a default interface implementation (requires runtime support: not on `netstandard2.0` or .NET Framework targets), or add a new interface. A default member is callable only through the interface, so also add a public member on any concrete type that must expose it, and record both |\n| Rename a shipped member | Source and binary break | Add the new name, keep the old one as an `[Obsolete]` forwarder, and record only the new member |\n| Rename or remove an `internal` member when `InternalsVisibleTo` names an assembly not in the solution | That friend was compiled against the old name and cannot be updated from this repo; it fails at bind time | Add the new name, migrate in-repo callers, keep the old internal name as an `[Obsolete]` forwarder, keep the grant, and name the protected friend in the answer |\n| Rename a parameter of a shipped member | Callers passing it by name (`raw: x`) stop compiling and late-bound\u002F`dynamic` callers fail; positional callers in this repo hide it. PublicAPI analyzers report it as RS0016 + RS0017 | Keep the shipped name — no overload can carry a different name for the same signature. Leave it unchanged and edit nothing else; you may offer (not make) a clearer XML `\u003Cparam>` doc, or the rename at the next major version |\n| Seal a class, make a member non-virtual, or narrow a parameter's nullability | Derived types, overrides, or nullable callers break | Treat as a breaking change; escalate rather than edit |\n| Change a `const` value or an optional parameter's default | The old value is compiled into callers and persists until they recompile | Preserve the shipped constant\u002Fdefault; introduce a separately named member (which may be `static readonly`) or a new overload for new behavior. Replacing an existing `const` with `static readonly` is itself source-breaking |\n| Change a value under `#if` for one target | Only consumers of that target see it; tests edited to match will not catch it | Treat as a behavior change for that target and call it out |\n\nWhenever you kept an old entry point or departed from the literal request, the final answer must\ncontain this line, filled in — terse bullets such as \"preserved for binary consumers\" do not satisfy it:\n\n> **Compatibility:** Kept `\u003Cexact old signature>` unchanged because `\u003Cwho still binds to it>` would\n> `\u003Cconcrete failure>` if it changed. `\u003CWhat you did instead of the literal request, and why.>`\n\nBefore finishing a compatibility-preserving edit, make the delta easy to audit:\n\n1. Name the **new** entry point or behavior and the **exact old** entry point that remains.\n2. Name the in-repo caller, generated template, or friend assembly you migrated, plus any external\n   consumer you could not migrate and therefore protected with a forwarder.\n3. State which baseline stayed unchanged and which new surface was recorded.\n4. Report the exact compatibility check that exercised the old entry point as well as the new one.\n\nFor a no-change outcome, lead with `No files changed.` and identify the decisive evidence before any\ngeneral explanation: the existing delegation, shipped signature, parameter name, or nullability line.\n\nWhen asked **\"is this a breaking change?\"** or to review a diff, make no edits unless asked and answer\nin this shape, scaled to the diff:\n\n1. One verdict line first (e.g. \"Do not merge as-is: N changes break consumers\").\n2. One numbered item per consumer-visible change: what changed, **binary** (already-compiled\n   consumers fail), **source** (consumers fail to recompile), or **behavioral** (same signature,\n   different result, possibly on only one target), who breaks, **why CI stayed green** (a shipped\n   API line rewritten, a test edited to match, or a change the analyzer does not track, such as\n   `sealed` or a private `const`), and the safe shape. State each as fact or not at all: a\n   behavioral claim needs a concrete input whose old and new results differ; if unsure, probe both\n   versions with a one-line program — framework parsers already tolerate much (e.g. `bool.TryParse`\n   ignores surrounding whitespace), and a no-op rewrite is not a break.\n3. One closing \"Not breaking:\" line covering every remaining hunk with its reason (internal-only\n   edits, probed no-ops), instead of side notes inside the numbered items.\n\nCover only surfaces the diff touches; do not add trimming, AOT, or tooling commentary it does not raise.\n\n## Verify before reporting\n\nBuild and test **every** target framework (`dotnet test -f \u003Ctfm>` for each), not only the default. If\nthe project sets `EnablePackageValidation`, run `dotnet pack` — package validation runs only after\n`Pack`, never on build. Report exactly which commands ran and their result.\n\n## Stop and escalate (do not silently proceed)\n\n- The requested change is **already in place** — e.g. the \"duplicated\" code already delegates to one\n  implementation, or the overload already exists. Say so and change nothing; do not invent a\n  refactor to have something to show.\n- A **public\u002Fshipped API** would change and you cannot verify compatibility — no shim\u002Fforwarder path and\n  no PublicApiAnalyzers\u002FApiCompat\u002Fpackage-validation gate to catch a break.\n- The edit changes an **observable annotation** (nullability, `[DynamicallyAccessedMembers]`,\n  `[RequiresUnreferencedCode]`, generic constraints) on a public member.\n- The change can be made consistent across **some but not all** target frameworks or platforms.\n- The only way to apply it is editing **generated output** that the next build will overwrite.\n\nWhen you change nothing (the request is already done or has no safe shape), a bare \"no\" looks like\nignoring the request. Make the final answer show the work, in this order: \"No files changed.\" and why;\nthe evidence that decided it (the shipped `PublicAPI.Shipped.txt` line, or the call that already\ndelegates, with its file); who would break, or where the single implementation already lives; what the\nuser *can* do instead, if anything; and the validation you ran.\n\n## Reference files\n\nLoad a reference only for a surface the inspect-first step actually found:\n\n- **[references\u002Fpublic-api.md](references\u002Fpublic-api.md)** — the two API gates and why they are not\n  interchangeable, nullable\u002Ftrimming\u002FAOT as observable API, `[Obsolete]` shims and type-forwarders,\n  suppression baselines.\n- **[references\u002Fmulti-targeting.md](references\u002Fmulti-targeting.md)** — TFMs, `#if` and platform symbols,\n  RIDs, and how to inspect and re-gate every target.\n- **[references\u002Fsource-generation.md](references\u002Fsource-generation.md)** — partial types, generated output\n  vs checked-in source, editing the generator input. (See also `dotnet-msbuild\u002Fincluding-generated-files`.)\n- **[references\u002Finternals-visible-to.md](references\u002Finternals-visible-to.md)** — friend\u002Ftest assemblies\n  and strong-name keys.\n",{"name":5,"license":14,"description":23},"Use before changing .NET\u002FC# code whose callers you do not control: a NuGet library, or a repo with PublicAPI.Shipped\u002FUnshipped.txt, ApiCompat, multiple TargetFrameworks, InternalsVisibleTo, or generated (.g.cs) partials. Green builds miss silent breaks from optional parameters, parameter names, sealing, const values, nullability, and #if. USE FOR: \"without breaking existing callers\"; adding a public method, overload, optional parameter, or interface member to a shipped library; renaming a public method or an internal helper a friend assembly uses; consolidating duplicated logic; changing a signature, nullability, default, or attribute; adding a target framework; RS0016\u002FRS0017 or ApiCompat errors; \"is this PR breaking?\". For a rename, extract, or merge, also invoke csharp-refactoring. DO NOT USE FOR: an executable whose callers all live in one project; renaming a local variable or private member, even in a shipped library; formatting; framework\u002FSDK\u002FNuGet upgrades (use dotnet-upgrade).\n","main","ccab8dffc0ecc173838f51e4c5f0d3b51a704f41","plugins\u002Fopt-in\u002Fimplementation\u002Fcsharp-skills\u002Flibrary\u002Fdotnet-breaking-changes","https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills","https:\u002F\u002Fgithub.com\u002Fdeadmade","https:\u002F\u002Fdeadmade.github.io\u002F","Blood, an Ocean of blood","2026-11-14 02:03:31",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add deadmade\u002Fdead-agent-skills --skill dotnet-breaking-changes",{"tool":38,"command":39},"bunx","bunx skills add deadmade\u002Fdead-agent-skills --skill dotnet-breaking-changes",{"tool":41,"command":42},"pnpm","pnpm dlx skills add deadmade\u002Fdead-agent-skills --skill dotnet-breaking-changes","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fcsharp-skills\u002Flibrary\u002Fdotnet-breaking-changes\u002FSKILL.md",true,[46,52,56,60],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Finternals-visible-to.md","REFERENCE","参考文档",2327,"https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fcsharp-skills\u002Flibrary\u002Fdotnet-breaking-changes\u002Freferences\u002Finternals-visible-to.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fmulti-targeting.md",2821,"https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fcsharp-skills\u002Flibrary\u002Fdotnet-breaking-changes\u002Freferences\u002Fmulti-targeting.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fpublic-api.md",5657,"https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fcsharp-skills\u002Flibrary\u002Fdotnet-breaking-changes\u002Freferences\u002Fpublic-api.md",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"references\u002Fsource-generation.md",2003,"https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fcsharp-skills\u002Flibrary\u002Fdotnet-breaking-changes\u002Freferences\u002Fsource-generation.md",[65,72,81,89,96,103],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M7CVRBFTXSTTQ7F5P6PJEFYA","rust-best-practices","Guide for writing idiomatic Rust code based on Apollo GraphQL's best practices handbook. Use this skill when: (1) writing new Rust code or functions, (2) reviewing or refactoring existing Rust code, (3) deciding between borrowing vs cloning or ownership patterns, (4) implementing error handling with Result types, (5) optimizing Rust code for performance, (6) writing tests or documentation for Rust projects.","https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Frust-skills\u002Fskills\u002Frust-best-practices\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":76,"licenseFileUrl":77,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M7CVR0W7B8EGTNPSPA7FPC4Z","postgres-database-migration","Use this skill for planning, testing, and safely executing PostgreSQL schema migrations — especially when working with production data or shared databases.\n\n**Trigger when user asks to:**\n- Test a schema migration before applying it to production\n- Add, remove, or rename columns safely on a live table\n- Change a column's data type without downtime\n- Add or drop indexes, constraints, or foreign keys on large tables\n- Understand which ALTER TABLE operations lock the table\n- Roll back a failed migration\n- Plan a zero-downtime migration strategy\n- Fork a database to test a migration safely\n\nCovers: lock-level reference for every common DDL operation, safe migration patterns, fork-based testing, zero-downtime column changes, index creation, constraint addition, backfill strategies, pre\u002Fpost-migration validation, and rollback planning.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fpostgres\u002Fskills\u002Fpostgres-database-migration\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fpostgres\u002Fskills\u002Fpostgres-database-migration\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":76,"licenseFileUrl":85,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M7CVQWK20ASAZN5VETZC8J99","postgres-best-practices","Best practices and guidelines for working with Postgres. Covers schema design, indexing strategies, query optimization, migrations, and common pitfalls. Use when writing SQL, designing database schemas, optimizing queries, or setting up a Postgres database.","https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fpostgres\u002Fskills\u002Fpostgres-best-practices\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fpostgres\u002Fskills\u002Fpostgres-best-practices\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":18},"01M7CVQ5CY7AQHY7A2Y99RE6A7","writing-mstest-tests","ALWAYS USE when asked to fix, rewrite, update, improve, modernize, show corrected code for, or explain existing MSTest tests or MSTest-specific configuration. Use for \"review\" when corrected code or edits are wanted, even for one pasted assertion or passing tests with bad failure output. Covers expected\u002Factual labels; generic Boolean, collection, string, numeric, null, identity, exception, hard-cast, and object[] checks; TestContext\u002Flifecycle; timeout\u002Fcancellation; OS\u002FCI conditions, retry, cleanup, parallelization, MSTest.Sdk project setup, and MSTESTxxxx. Honor the installed MSTest version. DO NOT USE to design new test cases (code-testing), perform report-only audits, create project files rather than explain MSTest setup, run tests, migrate frameworks, or handle non-MSTest\u002Fnon-.NET code.","https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fcsharp-skills\u002Flibrary\u002Fwriting-mstest-tests\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":18},"01M7CVPWJZ63GB0810F0SCGZ1K","winforms-expert","Create, modify, debug, or review Windows Forms applications only when the request contains a concrete Windows Forms marker. USE FOR: WinForms, Windows Forms, System.Windows.Forms, WinForms Form or UserControl designer files (*.Designer.cs or *.Designer.vb), Visual Studio WinForms Designer, TableLayoutPanel, BindingSource, DataGridView, Control.InvokeAsync, component-tray ownership, or custom control serialization. DO NOT USE FOR: WPF or WPF XAML, including Window.InputBindings, KeyBinding, commands, or DataContext; .NET MAUI; Avalonia; or any request where none of the listed Windows Forms markers is present.","https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fcsharp-skills\u002Flibrary\u002Fwinforms-expert\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":18},"01M7CVPR0QFZ1HMJ6GZRBQAQ7W","vectorization","Design, implement, optimize, and review SIMD code in .NET. USE FOR: vectorizing scalar loops with TensorPrimitives, Vector64\u002F128\u002F256\u002F512, or platform hardware intrinsics; reviewing existing SIMD code, including the generic Vector type, for contract equivalence, tail handling, memory safety, portability, fallbacks, and measured performance. DO NOT USE FOR: performance work unrelated to SIMD or vectorization.","https:\u002F\u002Fgithub.com\u002Fdeadmade\u002Fdead-agent-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fopt-in\u002Fimplementation\u002Fcsharp-skills\u002Flibrary\u002Fvectorization\u002FSKILL.md",[],[]]