skills.rest
Azure
AzureOFFICIAL
Explore all skills by this author →
Website𝕏@AzureGitHub

azsdk-common-apiview-feedback-resolution

Analyzes and resolves APIView review feedback on Azure SDK pull requests using TypeSpec updates.

2.6k|2.2k|Updated Dec 6, 2011
Search Tags:#typespec#azure sdk#feedback resolution#API review#Code generation#Pull request#apiview
One-click install
npx skills add https://github.com/Azure/azure-sdk-for-java --skill azsdk-common-apiview-feedback-resolution
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: azsdk-common-apiview-feedback-resolution
Source: https://github.com/Azure/azure-sdk-for-java/tree/main/.github/skills/azsdk-common-apiview-feedback-resolution
Command: npx skills add https://github.com/Azure/azure-sdk-for-java --skill azsdk-common-apiview-feedback-resolution

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Azure SDK pull requests often receive APIView review comments about API surface changes, and manually triaging, categorizing, and fixing that feedback across TypeSpec definitions and generated code is slow and error-prone.

Core Features & Use Cases

  • Comment Retrieval and Categorization: Fetches APIView reviewer comments from an SDK PR and groups them into Critical, Suggestions, and Informational categories.
  • Automated Resolution: Applies TypeSpec and code customization fixes locally, or delegates complex feedback to the CCA pipeline via a GitHub issue.
  • Validation and Regeneration: Runs TypeSpec validation, regenerates the SDK, and guides build, test, and re-review steps.
  • Use Case: A reviewer flags that 'ComputeProvisioningState' should be renamed to 'ProvisioningState' on your SDK PR; the skill retrieves the comment, applies the rename through customization tooling, validates, and regenerates the SDK.

Quick Start

Ask the assistant to resolve the APIView comments on your SDK pull request by providing the PR or APIView review link.

Frequently Asked Questions about azsdk-common-apiview-feedback-resolution

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resolve APIView comments on my Azure SDK pull request?▼

Provide the SDK PR or APIView review link, and the skill retrieves comments with azsdk_apiview_get_comments, categorizes them as Critical, Suggestions, or Informational, then applies TypeSpec or code customization fixes before validating and regenerating the SDK.

How do I apply a rename requested in API review feedback?▼

Use the azsdk_customized_code_update tool to apply the rename through TypeSpec or code customization locally. For complex changes, delegate via azsdk_typespec_delegate_apiview_feedback, which creates a GitHub issue assigned to Copilot in the specs repo.

Does this skill work without the azure-sdk-mcp server?▼

No, the azure-sdk-mcp server is required. There is no CLI fallback for retrieving APIView comments or applying TypeSpec changes, so the MCP server must be connected before running the workflow.

What happens after feedback is delegated to the CCA pipeline?▼

A GitHub issue is created in the specs repo and assigned to Copilot, which produces a spec PR, then SDK generation pipelines create SDK PRs and an updated APIView revision. The skill shares the issue link and can track pipeline status and resulting SDK PRs.

When should I not use this skill for code review feedback?▼

Do not use it for general code review or non-APIView feedback. It is scoped specifically to APIView review comments on Azure SDK pull requests and API surface changes, not general PR review comments or build errors.

Related Skills

Explore More Software Engineering Skills→
microsoftmicrosoft
3.6k

mcp-code-reviewer

Review MCP pull requests with security, correctness, architecture, and testing lenses.

Official
Advanced
0xAndoroid0xAndoroid

fix-github-comments

Identify unresolved GitHub PR review threads, apply fixes, commit, push, and resolve them.

Community
Advanced
bravebrave
3.6k

impl-review

Implements reviewer-requested changes on a GitHub pull request branch and pushes validated commits.

Official
Advanced
ronniegeraghtyronniegeraghty
3

code-review-comments

Annotate generated Azure SDK code with inline REVIEW comments.

Community
Intermediate