| name | apiview-feedback-resolution |
| license | MIT |
| metadata | {"version":"1.0.0","distribution":"shared"} |
| description | Analyze and resolve APIView review feedback on Azure SDK PRs. **UTILITY SKILL**. USE FOR: APIView comments, API review feedback, SDK API surface changes. DO NOT USE FOR: general code review, non-APIView feedback. INVOKES: azure-sdk-mcp:azsdk_apiview_get_comments, azure-sdk-mcp:azsdk_typespec_customized_code_update. |
| compatibility | azure-sdk-mcp server, SDK pull request with APIView review link |
APIView Feedback Resolution
Prerequisites: azure-sdk-mcp server required; no CLI fallback. Without MCP, this skill cannot retrieve APIView comments or apply TypeSpec changes. Connect the azure-sdk-mcp server before use.
MCP Tools
| Tool | Purpose |
|---|
azure-sdk-mcp:azsdk_apiview_get_comments | Get APIView comments |
azure-sdk-mcp:azsdk_typespec_customized_code_update | Apply TypeSpec changes locally |
azure-sdk-mcp:azsdk_typespec_delegate_apiview_feedback | Delegate to CCA pipeline |
azure-sdk-mcp:azsdk_run_typespec_validation | Validate TypeSpec |
azure-sdk-mcp:azsdk_package_generate_code | Regenerate SDK |
Steps
- Retrieve — Get APIView URL from SDK PR, run
azsdk_apiview_get_comments.
- Categorize — Group as Critical/Suggestions/Informational per feedback steps.
- Resolve — Use
azsdk_typespec_customized_code_update for TypeSpec changes; delegate via azsdk_typespec_delegate_apiview_feedback for complex cases.
- Validate — Run validation, regenerate SDK, build and test.
- Confirm — Verify all items addressed. If delegated, follow post-delegation follow-up. Request re-review.
Examples
- "Resolve the APIView comments on my SDK pull request"
- "What feedback did the API reviewer leave?"
Troubleshooting
- No comments: Verify PR has APIView link and MCP server is connected.
- Validation fails: Re-run after fixing TypeSpec errors.
- MCP unavailable: Requires
azure-sdk-mcp server; no CLI fallback. Connect the server and retry.
