AgentSkillsCN

microsoft-code-reference

查阅 Microsoft API 参考文档，寻找可用的代码示例，并验证 SDK 代码的正确性。当您需要使用 Azure SDK、.NET 库或 Microsoft API 时，可借助此工具快速找到合适的 API 方法、核对参数、获取可用示例，或排查疑难问题。通过查询官方文档，有效避免出现虚构方法、错误签名，以及过时的使用模式。

SKILL.md
--- frontmatter
name: microsoft-code-reference
description:
  Look up Microsoft API references, find working code samples, and verify SDK
  code is correct. Use when working with Azure SDKs, .NET libraries, or
  Microsoft APIs—to find the right method, check parameters, get working
  examples, or troubleshoot errors. Catches hallucinated methods, wrong
  signatures, and deprecated patterns by querying official docs.
compatibility:
  Requires Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp)

Microsoft Code Reference

Tools

NeedToolExample
API method/class lookupmicrosoft_docs_search"BlobClient UploadAsync Azure.Storage.Blobs"
Working code samplemicrosoft_code_sample_searchquery: "upload blob managed identity", language: "python"
Full API referencemicrosoft_docs_fetchFetch URL from microsoft_docs_search (for overloads, full signatures)

Finding Code Samples

Use microsoft_code_sample_search to get official, working examples:

code
microsoft_code_sample_search(query: "upload file to blob storage", language: "csharp")
microsoft_code_sample_search(query: "authenticate with managed identity", language: "python")
microsoft_code_sample_search(query: "send message service bus", language: "javascript")

When to use:

  • •Before writing code—find a working pattern to follow
  • •After errors—compare your code against a known-good sample
  • •Unsure of initialization/setup—samples show complete context

API Lookups

code
# Verify method exists (include namespace for precision)
"BlobClient UploadAsync Azure.Storage.Blobs"
"GraphServiceClient Users Microsoft.Graph"

# Find class/interface
"DefaultAzureCredential class Azure.Identity"

# Find correct package
"Azure Blob Storage NuGet package"
"azure-storage-blob pip package"

Fetch full page when method has multiple overloads or you need complete parameter details.

Error Troubleshooting

Use microsoft_code_sample_search to find working code samples and compare with your implementation. For specific errors, use microsoft_docs_search and microsoft_docs_fetch:

Error TypeQuery
Method not found"[ClassName] methods [Namespace]"
Type not found"[TypeName] NuGet package namespace"
Wrong signature"[ClassName] [MethodName] overloads" → fetch full page
Deprecated warning"[OldType] migration v12"
Auth failure"DefaultAzureCredential troubleshooting"
403 Forbidden"[ServiceName] RBAC permissions"

When to Verify

Always verify when:

  • •Method name seems "too convenient" (UploadFile vs actual Upload)
  • •Mixing SDK versions (v11 CloudBlobClient vs v12 BlobServiceClient)
  • •Package name doesn't follow conventions (Azure.* for .NET, azure-* for Python)
  • •Using an API for the first time

Validation Workflow

Before generating code using Microsoft SDKs, verify it's correct:

  1. •Confirm method or package exists — microsoft_docs_search(query: "[ClassName] [MethodName] [Namespace]")
  2. •Fetch full details (for overloads/complex params) — microsoft_docs_fetch(url: "...")
  3. •Find working sample — microsoft_code_sample_search(query: "[task]", language: "[lang]")

For simple lookups, step 1 alone may suffice. For complex API usage, complete all three steps.