[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6BTCDAHX2C335XR9CVKSMWG":3,"skill-same:01M6BTCDAHX2C335XR9CVKSMWG":62},{"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":34,"linkOnly":35,"markdownContent":36,"markdownBody":37,"frontMatter":38,"refName":39,"commitSha":40,"skillDirectory":41,"forksCount":42,"repositoryHtmlUrl":43,"repositoryHomepageUrl":6,"ownerHtmlUrl":44,"ownerBlogUrl":45,"ownerDescription":46,"updatedAt":47,"install":48,"resources":61},"01M6BTCDAHX2C335XR9CVKSMWG","mgmt-review-comment-resolution",null,"Resolve review comments on Azure management-plane .NET SDK PRs. Handles renaming types\u002Fproperties, changing property types, and other API surface adjustments by updating TypeSpec client.tsp and regenerating.","Azure\u002Fazure-sdk-for-net","Azure","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6844498?v=4","01M6BT15ZBDTV4D9RM7HCC4D8A","Microsoft Azure","01M6BT163EEHB7Y52MKZJ322Q8",6072,"MIT","https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fmgmt-review-comment-resolution\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33],"review","mgmt review comment resolution","resolution","sdk","azure","typespec","api","resolve review","management","properties","client","types","comments","plane","prs","2026-11-10 10:12:30",false,"---\nname: mgmt-review-comment-resolution\ndescription: Resolve review comments on Azure management-plane .NET SDK PRs. Handles renaming types\u002Fproperties, changing property types, and other API surface adjustments by updating TypeSpec client.tsp and regenerating.\n---\n\n# Skill: mgmt-review-comment-resolution\n\nResolve review comments on Azure management-plane SDK PRs by making changes in the TypeSpec spec repo (`client.tsp`) and regenerating the SDK.\n\n## When Invoked\n\nTrigger phrases: \"resolve review comments\", \"fix review comments\", \"resolve PR comments\", \"rename types\", \"fix naming\", \"resolve naming comments\", \"fix API surface\".\n\n## Overview\n\nManagement-plane SDK code is generated from TypeSpec definitions in `azure-rest-api-specs`. Review comments on SDK PRs often request changes to the generated API surface — renaming types, renaming properties, or changing property types to be more user-friendly. These changes are made in the spec repo's `client.tsp` using TypeSpec decorators (primarily `@@clientName`), then the SDK is regenerated.\n\n### Key Concepts\n\n- **`@@clientName(TypeSpecName, \"CSharpName\", \"csharp\")`** — renames a TypeSpec model\u002Funion\u002Fenum\u002Fproperty to a different name in the generated C# SDK. This is the primary tool for resolving naming comments.\n- **`@@clientName` only works on types defined in the service's TypeSpec** — you can only target models, unions, enums, and interfaces that are explicitly declared in the service's `.tsp` files. If a type is not defined there (e.g., it comes from ARM common types or TypeSpec templates), `@@clientName` cannot target it. See \"Renaming via SDK Custom Code\" below.\n- **`@@clientName` cannot target aliases** — if a type is defined as an `alias`, `@@clientName` cannot target it. See \"Handling Unsupported Cases\" below.\n- **Only `client.tsp` may be changed** in the spec repo — do not modify any other `.tsp` files or config files. If resolving a comment would require changes to other files, skip that change and inform the user with the reason after processing all other comments. Since only `client.tsp` is modified, swagger regeneration is never needed.\n\n## Types of Review Comments\n\n### 1. Type Names Too Generic\n\nReview comments may flag type names that are too generic and could collide with types from other SDKs or lack sufficient context.\n\n**Goal:** Make the name more descriptive by adding context — this could be the RP name, the resource name, or other domain-specific context. The right prefix depends on what makes the name unambiguous and meaningful.\n\n**Examples:**\n| Original | Renamed | Context Added |\n|---|---|---|\n| `ProvisioningState` | `ManagedOpsProvisioningState` | RP name |\n| `ServiceInformation` | `ManagedOpsServiceInformation` | RP name |\n| `EncryptionProperties` | `VaultEncryptionProperties` | Resource name |\n| `ConnectionState` | `PrivateEndpointConnectionState` | Feature name |\n\n**How to decide the prefix:** Read the review comment carefully — it may suggest a specific prefix. If not, choose the most natural context that makes the name unambiguous within the SDK's namespace. When uncertain, **ask the user** what prefix or name they prefer.\n\n### 2. Property Renames\n\nProperties can also be renamed using `@@clientName` on the model's property:\n\n```typespec\n@@clientName(MyModel.oldPropertyName, \"NewPropertyName\", \"csharp\");\n```\n\n### 3. Property Type Changes\n\nSome review comments ask for property types to be changed (e.g., `string` → `ResourceIdentifier`, `string` → `TimeSpan`). Use the `@@alternateType` decorator in `client.tsp` to change the generated C# type:\n\n```typespec\n@@alternateType(MyModel.myProperty, armResourceIdentifier, \"csharp\");\n@@alternateType(MyModel.durationProperty, duration, \"csharp\");\n```\n\nThis changes the property's type in the generated C# SDK without modifying other `.tsp` files. If `@@alternateType` cannot handle the requested type change, skip the change and inform the user with the reason after processing all other comments.\n\n## Workflow\n\n### Step 1: Read and Understand Review Comments\n\nFetch the PR's review comments using GitHub MCP tools. For each unresolved comment:\n1. Identify what change is requested (rename type, rename property, change type, etc.)\n2. Find the corresponding TypeSpec type\u002Fproperty in the spec\n3. Determine the appropriate new name or change\n4. **Determine if the type is defined in the service's TypeSpec**: Search all `.tsp` files under the spec folder for a `model`, `union`, or `enum` declaration with the same name.\n   - If defined → the rename will use `@@clientName` in `client.tsp` (Step 3)\n   - If NOT defined → the rename must use SDK-side custom code (Step 3b)\n\nIf a comment is ambiguous about what the new name should be, **ask the user** before proceeding.\n\n### Step 2: Locate the Spec Files\n\n1. Find `tsp-location.yaml` in the SDK package directory:\n   ```\n   sdk\u002F\u003Cservice>\u002FAzure.ResourceManager.\u003CService>\u002Ftsp-location.yaml\n   ```\n2. This file contains:\n   - `directory`: path to the TypeSpec spec (e.g., `specification\u002Fmanagedoperations\u002FManagedOps.Management`)\n   - `commit`: the spec repo commit SHA\n   - `repo`: the spec repo (e.g., `Azure\u002Fazure-rest-api-specs`)\n\n3. Key spec files:\n   - `client.tsp` — where `@@clientName` and `@@alternateType` decorators go (this is the only `.tsp` file you should modify)\n   - Other `.tsp` files — read-only reference for understanding models, unions, and aliases\n\n### Step 3: Apply Changes in the Spec Repo (for types defined in TypeSpec)\n\nThis step applies only to types that are defined in the service's TypeSpec files. For types NOT defined in the service's TypeSpec, skip to **Step 3b**.\n\nLocate the spec repo. It may be:\n- A local clone (typically at `..\u002Fazure-rest-api-specs` relative to the SDK repo)\n- If not available locally, clone it or ask the user for the path\n\nIf there is an existing spec PR branch, check it out. If there is no spec PR or branch yet, create a new branch from the commit referenced in `tsp-location.yaml`.\n\nAdd `@@clientName` decorators to `client.tsp`. Read the existing `client.tsp` to find the correct `using` statement for the service namespace (e.g., `using Microsoft.ManagedOps;`, `using Azure.ResourceManager.Compute;`, etc.), then add decorators targeting the types to rename:\n\n```typespec\n@@clientName(GenericTypeName, \"MoreDescriptiveTypeName\", \"csharp\");\n@@clientName(MyModel.genericProperty, \"moreDescriptiveProperty\", \"csharp\");\n```\n\nMake sure the `using` statement for the service namespace is present so that type names resolve correctly. Check the `namespace` declaration in `main.tsp` or other `.tsp` files to find the correct namespace.\n\n### Step 3b: Apply Changes via SDK Custom Code (for types NOT defined in TypeSpec)\n\nTypes that are not defined in the service's TypeSpec (e.g., from ARM common types or TypeSpec templates) cannot be renamed via `@@clientName`. Instead, create SDK-side customization files to rename them.\n\n1. Create a customization file in the SDK package's `src\u002FCustomize\u002FModels\u002F` directory (create the directory if it doesn't exist).\n2. Define a `partial class` (or `partial struct` for value types) with the **desired name**, and apply the `[CodeGenType(\"OriginalGeneratedName\")]` attribute to map it to the generated type.\n\n**Example:** To rename `OptionalPropertiesUpdateableProperties` to `DurableTaskPrivateEndpointConnectionPatchProperties`:\n\n```csharp\n\u002F\u002F src\u002FCustomize\u002FModels\u002FDurableTaskPrivateEndpointConnectionPatchProperties.cs\nusing Azure.ResourceManager.DurableTask.Models;\n\nnamespace Azure.ResourceManager.DurableTask.Models\n{\n    [CodeGenType(\"OptionalPropertiesUpdateableProperties\")]\n    public partial class DurableTaskPrivateEndpointConnectionPatchProperties\n    {\n    }\n}\n```\n\nAfter creating customization files, proceed to **Step 6** (Regenerate the SDK) — Steps 4 and 5 (commit spec changes and update `tsp-location.yaml`) are only needed if `client.tsp` was also modified.\n\n### Step 4: Commit and Push Spec Changes\n\nCommit `client.tsp` changes and push to the spec PR branch.\n\n### Step 5: Update SDK tsp-location.yaml\n\nUpdate the `commit` field in `tsp-location.yaml` to point to the new spec commit SHA:\n\n```yaml\ndirectory: specification\u002F\u003Cservice>\u002F\u003CServiceName>.Management\ncommit: \u003Cnew-commit-sha>\nrepo: Azure\u002Fazure-rest-api-specs\n```\n\n### Step 6: Regenerate the SDK\n\n```powershell\ncd sdk\u002F\u003Cservice>\u002FAzure.ResourceManager.\u003CService>\u002Fsrc\ndotnet build \u002Ft:GenerateCode\n```\n\n### Step 7: Build and Verify\n\n```powershell\n# Build the library and tests (mgmt libraries always have a solution file)\ncd sdk\u002F\u003Cservice>\u002FAzure.ResourceManager.\u003CService>\ndotnet build\n\n# Export API listing\ncd \u003Crepo-root>\npwsh eng\u002Fscripts\u002FExport-API.ps1 \u003Cservice-directory>\n```\n\nIf tests fail to build due to old type\u002Fproperty names, update the test files to use the new names.\n\n### Step 8: Verify the Changes\n\nCheck the API surface file (`api\u002F*.cs`) to confirm the review comments have been addressed — old names are gone and new names are present.\n\n### Step 9: Commit, Push, and Resolve Comments\n\n1. Commit and push the regenerated SDK to the SDK PR branch\n2. Resolve the corresponding review comments on the SDK PR using GitHub GraphQL API\n\n## Handling Unsupported Cases\n\nSome changes cannot be done purely through `@@clientName` or `@@alternateType` in `client.tsp`. When you encounter any of the following, **skip the change** and continue processing other comments. After all processable changes are done, inform the user about the skipped changes with the reason, and let them choose how to proceed:\n\n- **Aliases** — `@@clientName` cannot target TypeSpec aliases (e.g., `alias foo = \"A\" | \"B\" | string;`). Explain to the user that the alias needs to be converted to a named type (e.g., `union`) in the spec `.tsp` file first.\n- **Changes requiring spec file modifications beyond `client.tsp`** — any change that cannot be expressed via `client.tsp` decorators or SDK custom code alone (e.g., structural changes, flattening\u002Funflattening models, adding\u002Fremoving properties, or changing inheritance).\n- **Ambiguous naming** — if a review comment says \"rename this\" but doesn't specify the new name, ask the user what name they prefer.\n\n## Common Pitfalls\n\n1. **Missing `using` statement** in `client.tsp` — the type names won't resolve and `@@clientName` will silently fail. Check the `namespace` declaration in the spec's `.tsp` files to find the correct namespace.\n2. **Modifying files other than `client.tsp`** — only `client.tsp` should be modified in the spec repo. If other file changes are needed, skip and inform the user.\n3. **Stale commit SHA** — always update `tsp-location.yaml` to point to the pushed spec commit before regenerating.\n4. **Test files** — after renaming types, test and sample files may still reference old names and need manual updates.\n5. **Not building tests** — always build the solution (which includes tests), not just the library, to catch stale references.\n","# Skill: mgmt-review-comment-resolution\n\nResolve review comments on Azure management-plane SDK PRs by making changes in the TypeSpec spec repo (`client.tsp`) and regenerating the SDK.\n\n## When Invoked\n\nTrigger phrases: \"resolve review comments\", \"fix review comments\", \"resolve PR comments\", \"rename types\", \"fix naming\", \"resolve naming comments\", \"fix API surface\".\n\n## Overview\n\nManagement-plane SDK code is generated from TypeSpec definitions in `azure-rest-api-specs`. Review comments on SDK PRs often request changes to the generated API surface — renaming types, renaming properties, or changing property types to be more user-friendly. These changes are made in the spec repo's `client.tsp` using TypeSpec decorators (primarily `@@clientName`), then the SDK is regenerated.\n\n### Key Concepts\n\n- **`@@clientName(TypeSpecName, \"CSharpName\", \"csharp\")`** — renames a TypeSpec model\u002Funion\u002Fenum\u002Fproperty to a different name in the generated C# SDK. This is the primary tool for resolving naming comments.\n- **`@@clientName` only works on types defined in the service's TypeSpec** — you can only target models, unions, enums, and interfaces that are explicitly declared in the service's `.tsp` files. If a type is not defined there (e.g., it comes from ARM common types or TypeSpec templates), `@@clientName` cannot target it. See \"Renaming via SDK Custom Code\" below.\n- **`@@clientName` cannot target aliases** — if a type is defined as an `alias`, `@@clientName` cannot target it. See \"Handling Unsupported Cases\" below.\n- **Only `client.tsp` may be changed** in the spec repo — do not modify any other `.tsp` files or config files. If resolving a comment would require changes to other files, skip that change and inform the user with the reason after processing all other comments. Since only `client.tsp` is modified, swagger regeneration is never needed.\n\n## Types of Review Comments\n\n### 1. Type Names Too Generic\n\nReview comments may flag type names that are too generic and could collide with types from other SDKs or lack sufficient context.\n\n**Goal:** Make the name more descriptive by adding context — this could be the RP name, the resource name, or other domain-specific context. The right prefix depends on what makes the name unambiguous and meaningful.\n\n**Examples:**\n| Original | Renamed | Context Added |\n|---|---|---|\n| `ProvisioningState` | `ManagedOpsProvisioningState` | RP name |\n| `ServiceInformation` | `ManagedOpsServiceInformation` | RP name |\n| `EncryptionProperties` | `VaultEncryptionProperties` | Resource name |\n| `ConnectionState` | `PrivateEndpointConnectionState` | Feature name |\n\n**How to decide the prefix:** Read the review comment carefully — it may suggest a specific prefix. If not, choose the most natural context that makes the name unambiguous within the SDK's namespace. When uncertain, **ask the user** what prefix or name they prefer.\n\n### 2. Property Renames\n\nProperties can also be renamed using `@@clientName` on the model's property:\n\n```typespec\n@@clientName(MyModel.oldPropertyName, \"NewPropertyName\", \"csharp\");\n```\n\n### 3. Property Type Changes\n\nSome review comments ask for property types to be changed (e.g., `string` → `ResourceIdentifier`, `string` → `TimeSpan`). Use the `@@alternateType` decorator in `client.tsp` to change the generated C# type:\n\n```typespec\n@@alternateType(MyModel.myProperty, armResourceIdentifier, \"csharp\");\n@@alternateType(MyModel.durationProperty, duration, \"csharp\");\n```\n\nThis changes the property's type in the generated C# SDK without modifying other `.tsp` files. If `@@alternateType` cannot handle the requested type change, skip the change and inform the user with the reason after processing all other comments.\n\n## Workflow\n\n### Step 1: Read and Understand Review Comments\n\nFetch the PR's review comments using GitHub MCP tools. For each unresolved comment:\n1. Identify what change is requested (rename type, rename property, change type, etc.)\n2. Find the corresponding TypeSpec type\u002Fproperty in the spec\n3. Determine the appropriate new name or change\n4. **Determine if the type is defined in the service's TypeSpec**: Search all `.tsp` files under the spec folder for a `model`, `union`, or `enum` declaration with the same name.\n   - If defined → the rename will use `@@clientName` in `client.tsp` (Step 3)\n   - If NOT defined → the rename must use SDK-side custom code (Step 3b)\n\nIf a comment is ambiguous about what the new name should be, **ask the user** before proceeding.\n\n### Step 2: Locate the Spec Files\n\n1. Find `tsp-location.yaml` in the SDK package directory:\n   ```\n   sdk\u002F\u003Cservice>\u002FAzure.ResourceManager.\u003CService>\u002Ftsp-location.yaml\n   ```\n2. This file contains:\n   - `directory`: path to the TypeSpec spec (e.g., `specification\u002Fmanagedoperations\u002FManagedOps.Management`)\n   - `commit`: the spec repo commit SHA\n   - `repo`: the spec repo (e.g., `Azure\u002Fazure-rest-api-specs`)\n\n3. Key spec files:\n   - `client.tsp` — where `@@clientName` and `@@alternateType` decorators go (this is the only `.tsp` file you should modify)\n   - Other `.tsp` files — read-only reference for understanding models, unions, and aliases\n\n### Step 3: Apply Changes in the Spec Repo (for types defined in TypeSpec)\n\nThis step applies only to types that are defined in the service's TypeSpec files. For types NOT defined in the service's TypeSpec, skip to **Step 3b**.\n\nLocate the spec repo. It may be:\n- A local clone (typically at `..\u002Fazure-rest-api-specs` relative to the SDK repo)\n- If not available locally, clone it or ask the user for the path\n\nIf there is an existing spec PR branch, check it out. If there is no spec PR or branch yet, create a new branch from the commit referenced in `tsp-location.yaml`.\n\nAdd `@@clientName` decorators to `client.tsp`. Read the existing `client.tsp` to find the correct `using` statement for the service namespace (e.g., `using Microsoft.ManagedOps;`, `using Azure.ResourceManager.Compute;`, etc.), then add decorators targeting the types to rename:\n\n```typespec\n@@clientName(GenericTypeName, \"MoreDescriptiveTypeName\", \"csharp\");\n@@clientName(MyModel.genericProperty, \"moreDescriptiveProperty\", \"csharp\");\n```\n\nMake sure the `using` statement for the service namespace is present so that type names resolve correctly. Check the `namespace` declaration in `main.tsp` or other `.tsp` files to find the correct namespace.\n\n### Step 3b: Apply Changes via SDK Custom Code (for types NOT defined in TypeSpec)\n\nTypes that are not defined in the service's TypeSpec (e.g., from ARM common types or TypeSpec templates) cannot be renamed via `@@clientName`. Instead, create SDK-side customization files to rename them.\n\n1. Create a customization file in the SDK package's `src\u002FCustomize\u002FModels\u002F` directory (create the directory if it doesn't exist).\n2. Define a `partial class` (or `partial struct` for value types) with the **desired name**, and apply the `[CodeGenType(\"OriginalGeneratedName\")]` attribute to map it to the generated type.\n\n**Example:** To rename `OptionalPropertiesUpdateableProperties` to `DurableTaskPrivateEndpointConnectionPatchProperties`:\n\n```csharp\n\u002F\u002F src\u002FCustomize\u002FModels\u002FDurableTaskPrivateEndpointConnectionPatchProperties.cs\nusing Azure.ResourceManager.DurableTask.Models;\n\nnamespace Azure.ResourceManager.DurableTask.Models\n{\n    [CodeGenType(\"OptionalPropertiesUpdateableProperties\")]\n    public partial class DurableTaskPrivateEndpointConnectionPatchProperties\n    {\n    }\n}\n```\n\nAfter creating customization files, proceed to **Step 6** (Regenerate the SDK) — Steps 4 and 5 (commit spec changes and update `tsp-location.yaml`) are only needed if `client.tsp` was also modified.\n\n### Step 4: Commit and Push Spec Changes\n\nCommit `client.tsp` changes and push to the spec PR branch.\n\n### Step 5: Update SDK tsp-location.yaml\n\nUpdate the `commit` field in `tsp-location.yaml` to point to the new spec commit SHA:\n\n```yaml\ndirectory: specification\u002F\u003Cservice>\u002F\u003CServiceName>.Management\ncommit: \u003Cnew-commit-sha>\nrepo: Azure\u002Fazure-rest-api-specs\n```\n\n### Step 6: Regenerate the SDK\n\n```powershell\ncd sdk\u002F\u003Cservice>\u002FAzure.ResourceManager.\u003CService>\u002Fsrc\ndotnet build \u002Ft:GenerateCode\n```\n\n### Step 7: Build and Verify\n\n```powershell\n# Build the library and tests (mgmt libraries always have a solution file)\ncd sdk\u002F\u003Cservice>\u002FAzure.ResourceManager.\u003CService>\ndotnet build\n\n# Export API listing\ncd \u003Crepo-root>\npwsh eng\u002Fscripts\u002FExport-API.ps1 \u003Cservice-directory>\n```\n\nIf tests fail to build due to old type\u002Fproperty names, update the test files to use the new names.\n\n### Step 8: Verify the Changes\n\nCheck the API surface file (`api\u002F*.cs`) to confirm the review comments have been addressed — old names are gone and new names are present.\n\n### Step 9: Commit, Push, and Resolve Comments\n\n1. Commit and push the regenerated SDK to the SDK PR branch\n2. Resolve the corresponding review comments on the SDK PR using GitHub GraphQL API\n\n## Handling Unsupported Cases\n\nSome changes cannot be done purely through `@@clientName` or `@@alternateType` in `client.tsp`. When you encounter any of the following, **skip the change** and continue processing other comments. After all processable changes are done, inform the user about the skipped changes with the reason, and let them choose how to proceed:\n\n- **Aliases** — `@@clientName` cannot target TypeSpec aliases (e.g., `alias foo = \"A\" | \"B\" | string;`). Explain to the user that the alias needs to be converted to a named type (e.g., `union`) in the spec `.tsp` file first.\n- **Changes requiring spec file modifications beyond `client.tsp`** — any change that cannot be expressed via `client.tsp` decorators or SDK custom code alone (e.g., structural changes, flattening\u002Funflattening models, adding\u002Fremoving properties, or changing inheritance).\n- **Ambiguous naming** — if a review comment says \"rename this\" but doesn't specify the new name, ask the user what name they prefer.\n\n## Common Pitfalls\n\n1. **Missing `using` statement** in `client.tsp` — the type names won't resolve and `@@clientName` will silently fail. Check the `namespace` declaration in the spec's `.tsp` files to find the correct namespace.\n2. **Modifying files other than `client.tsp`** — only `client.tsp` should be modified in the spec repo. If other file changes are needed, skip and inform the user.\n3. **Stale commit SHA** — always update `tsp-location.yaml` to point to the pushed spec commit before regenerating.\n4. **Test files** — after renaming types, test and sample files may still reference old names and need manual updates.\n5. **Not building tests** — always build the solution (which includes tests), not just the library, to catch stale references.\n",{"name":5,"description":7},"main","dbc5eb654c3492137a4fbeeb6776c804f0042063",".github\u002Fskills\u002Fmgmt-review-comment-resolution",5228,"https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net","https:\u002F\u002Fgithub.com\u002FAzure","https:\u002F\u002Fdocs.microsoft.com\u002Fen-us\u002Fazure\u002F","APIs, SDKs and open source projects from Microsoft Azure","2026-11-14 22:39:26",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add Azure\u002Fazure-sdk-for-net --skill mgmt-review-comment-resolution",{"tool":54,"command":55},"bunx","bunx skills add Azure\u002Fazure-sdk-for-net --skill mgmt-review-comment-resolution",{"tool":57,"command":58},"pnpm","pnpm dlx skills add Azure\u002Fazure-sdk-for-net --skill mgmt-review-comment-resolution","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fmgmt-review-comment-resolution\u002FSKILL.md",true,[],[63,91,126,149,172,188],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":79,"publishedAt":34},"01M6BTE1QTJPYDAN115GS2EHDQ","update-chat-api","Use when: updating, exporting, refreshing, or validating the public API baseline for Azure.Messaging.WebPubSub.Chat after a public API change.","https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Fblob\u002Fmain\u002Fsdk\u002Fwebpubsub\u002F.github\u002Fskills\u002Fupdate-chat-api\u002FSKILL.md",[69,74],{"categoryNo":70,"categoryName":71,"taxonomyType":72,"taxonomyTypeDesc":73},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":75,"categoryName":76,"taxonomyType":77,"taxonomyTypeDesc":78},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[80,25,81,82,83,23,84,85,86,87,88,89,90],"update","update chat api","chat","change","messaging","baseline","public","use","public api","for","when",{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":104,"publishedAt":34},"01M6BTDYJS2RSGZR2T2BTJJ6YC","search-documents","E2E workflow skill for Azure.Search.Documents SDK (TypeSpec + heavy customization). Handles full release cycles and partial updates: SHA update; code generation; build; customization fixes; ServiceVersion sync; testing; API export; changelog; version; samples; formatting; release metadata. WHEN: create new package version for Azure.Search.Documents; regenerate Azure.Search.Documents; fix Azure.Search.Documents bug; release Azure.Search.Documents; update Azure.Search.Documents spec. Do not use for Azure.ResourceManager.Search or Azure.Provisioning.Search.","https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Fblob\u002Fmain\u002Fsdk\u002Fsearch\u002FAzure.Search.Documents\u002F.github\u002Fskills\u002Fsearch-documents\u002FSKILL.md",[97,100,103],{"categoryNo":98,"categoryName":99,"taxonomyType":72,"taxonomyTypeDesc":73},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":101,"categoryName":102,"taxonomyType":72,"taxonomyTypeDesc":73},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":75,"categoryName":76,"taxonomyType":77,"taxonomyTypeDesc":78},[105,106,107,108,109,22,110,111,23,24,112,80,113,114,115,116,117,118,119,25,120,121,122,123,124,90,125],"documents","search","search documents","testing","spec","workflow","sync","create","code","release","changelog","package","Code Generation","e2e","provisioning","fix","bug","workflow skill","updates","new package","new",{"skillNo":127,"name":128,"nameZh":6,"description":129,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":130,"categories":131,"keywords":132,"publishedAt":34},"01M6BTDVJGZ0N7F7DXR5Z7E0QH","search-documents-version-diff","Diff the current Azure.Search.Documents public API surface against a previous published version and detect preview-to-preview regressions where the SDK customization layer was not bubbled up after a TypeSpec change. Use whenever the user asks to compare Azure.Search.Documents betas, verify no Azure.Search.Documents preview features dropped, regression audit between Azure.Search.Documents versions, sanity-check a release branch for Azure.Search.Documents, or investigate a missing Azure.Search.Documents preview feature — even if they don't say the word \"diff\". Specifically catches dropped wrappers (QueryAnswer\u002FQueryCaption\u002FQueryRewrites style), lost SearchOptions aggregator redirectors, `@@access(\"internal\")` flips, deleted-instead-of-gated `#if AZURE_SEARCH_PREVIEW` blocks, dropped `ServiceVersion` enum values, and convenience-to-protocol downgrades.","https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Fblob\u002Fmain\u002Fsdk\u002Fsearch\u002FAzure.Search.Documents\u002F.github\u002Fskills\u002Fsearch-documents-version-diff\u002FSKILL.md",[],[105,106,133,107,134,135,22,83,23,24,114,136,137,25,138,139,140,141,142,143,144,145,88,146,147,148],"search documents version diff","version","diff","protocol","audit","verify","investigate","access","regression","branch","up","preview","aggregator","sanity","layer","features",{"skillNo":150,"name":151,"nameZh":6,"description":152,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":153,"categories":154,"keywords":156,"publishedAt":34},"01M6BTDRCG0SXKPKCFWR75FY8T","search-documents-typespec-validation","TypeSpec validation skill for Azure.Search.Documents SDK. Performs a COMPLETE validation of ALL operations, ALL models, ALL enums, and ALL properties against the TypeSpec definition at any pinned commit. Works for any API version. Generates a full gap report: missing features, extra features, naming mismatches, and recommended fix location. WHEN: \"validate Azure.Search.Documents SDK against TypeSpec\", \"detect Azure.Search.Documents typespec feature gaps\", \"what is missing from the Azure.Search.Documents SDK\", \"compare Azure.Search.Documents SDK to spec\", \"full spec coverage audit for Azure.Search.Documents\". Do NOT use for version-to-version diff or regression detection — use search-documents-version-diff instead.","https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Fblob\u002Fmain\u002Fsdk\u002Fsearch\u002FAzure.Search.Documents\u002F.github\u002Fskills\u002Fsearch-documents-typespec-validation\u002FSKILL.md",[155],{"categoryNo":101,"categoryName":102,"taxonomyType":72,"taxonomyTypeDesc":73},[105,24,157,106,158,107,109,22,159,160,161,162,23,163,137,164,25,141,165,166,120,167,168,169,148,170,171,90],"validation","search documents typespec validation","to spec","commit","validate","gap report","report","detection","extra","coverage","do","full","at","api version","definition",{"skillNo":173,"name":174,"nameZh":6,"description":175,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":176,"categories":177,"keywords":178,"publishedAt":34},"01M6BTDP9JS9KNT1H9ED8AGZF5","test-skill_file","Roll dice using a random number generator.","https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Fblob\u002Fmain\u002Fsdk\u002Fai\u002FAzure.AI.Projects.Agents\u002Ftests\u002FTestData\u002Froll-dice\u002FSKILL.md",[],[179,180,181,182,183,184,185,186,187],"test","Test Skill","file","test skill file","roll dice","dice","random","generator","number",{"skillNo":189,"name":190,"nameZh":6,"description":191,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":192,"categories":193,"keywords":194,"publishedAt":34},"01M6BTDMF2VK2CM53SSHZNWX7T","roll-dice","Roll dice using a random number generator. Use when asked to roll a die (d6, d20, etc.), roll dice, or generate a random dice roll.","https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Fblob\u002Fmain\u002Fsdk\u002Fai\u002FAzure.AI.Projects.Agents\u002Ftests\u002FSamples\u002Froll-dice\u002FSKILL.md",[],[183,184,195,87,185,186,187,90],"generate"]