$ ~/registry/skill/microsoft-extensions-copilot-agents-skills-anthropic-sdk-upgrader

SKILL

anthropic-sdk-upgrader

Name: anthropic-sdk-upgrader
Author: microsoft

帮助开发者升级 Anthropic SDK、迁移版本并解决相关依赖与类型问题。

星标

★ 187,604

来源

GitHub

更新于

2026-07-17

// 安全评估需留意

仅提示词，不执行代码
开源可审计

总评

该技能材料显示其为纯提示词型、开源来源关联到 GitHub 仓库，未声明需要密钥或固定远程端点，整体风险较低。其描述涉及升级依赖与查看发布说明，但从已知材料看未直接包含可执行工具权限，因此更接近文档/流程指导类技能。

凭证密钥低风险

材料明确写明无需密钥或环境变量，未见要求提供 API token、账号凭证或其他敏感认证信息。

网络外发低风险

系统检查项标记为 prompt-only，且未声明远程端点；README 仅提到可参考 GitHub Releases 页面，未显示该技能自身具备数据外发能力。

代码执行低风险

从客观检查项看这是纯提示词技能，不是可执行 MCP 工具；文档中虽出现 npm install 等命令示例，但这是升级说明内容，不等于该技能自动执行本机代码。

数据访问低风险

未见声明可读取、写入或枚举本地文件/系统资源；对 package.json、类型定义和临时目录的提及属于操作建议，材料未证明该技能实际拥有数据访问权限。

来源供应链需留意

来源指向 GitHub 且标记为开源，这是积极信号；但仓库信息与技能名称的对应关系不够清晰，社区采用为 0 star、许可证未声明、维护状态未知，存在一定来源与维护可验证性不足。

安全建议

将其视为升级流程指导技能使用，不要据此自动执行 README 中的命令。
在实际升级前，人工核对其对应仓库、许可证和最近维护记录。
若后续平台为该技能接入文件或命令权限，应先最小化授权并在隔离环境中运行。

审计模型: gpt-5.4 · 2026-06-17

// 安装

复制安装指令，让 AI 自动完成配置 · 推荐新手

请帮我安装 askskill 上的 "anthropic-sdk-upgrader" 技能：
1. 下载 https://raw.githubusercontent.com/microsoft/vscode/main/extensions/copilot/.agents/skills/anthropic-sdk-upgrader/SKILL.md
2. 保存为 ~/.claude/skills/anthropic-sdk-upgrader/SKILL.md
3. 装好后重载技能，告诉我可以用了

// 下载

下载 SKILL.md机读安装清单 ↗

// 用法示例

升级到最新 SDK

输入

请帮我把项目中的 @anthropic-ai/sdk 升级到最新稳定版，检查破坏性变更，更新代码示例，并列出需要修改的依赖与类型定义。

预期产出

一份升级方案，包含版本变更说明、代码修改建议、依赖更新列表与注意事项。

迁移 claude-agent-sdk

输入

我正在使用旧版 @anthropic-ai/claude-agent-sdk，请帮我迁移到最新版，说明 API 差异，重写初始化与调用示例，并指出可能的兼容性问题。

预期产出

一份迁移指南，包含新旧 API 对照、示例重写和兼容性风险说明。

排查升级冲突

输入

升级 Anthropic 相关包后出现依赖冲突和 TypeScript 类型报错，请分析可能原因，给出逐步排查方案，并提供可行的修复建议。

预期产出

一份问题诊断与修复建议，涵盖冲突来源、排查步骤和推荐解决方案。

// 文档

You are an expert at upgrading Anthropic SDK packages in the vscode-copilot-chat project.

Packages

Package	Description
`@anthropic-ai/claude-agent-sdk`	Official Claude Agent SDK - provides the core agent runtime, tools, hooks, sessions, and message streaming
`@anthropic-ai/sdk`	Anthropic API SDK - provides base types, API client, and message structures used by the agent SDK

Upgrade Process

Follow these steps exactly:

1. Check Current Versions and Changelog

Before upgrading, review the current versions in package.json and check the release notes:

Claude Agent SDK Releases: https://github.com/anthropics/claude-agent-sdk-typescript/releases
Anthropic SDK Releases: https://github.com/anthropics/anthropic-sdk-typescript/releases

2. Summarize All Changes

Create a consolidated summary of changes between the current version and the target version. Group changes by category, not by individual version:

Summary Format:

### `@anthropic-ai/package-name` (oldVersion → newVersion)

#### Features
- **Category:** Description of new feature or capability

#### Bug Fixes
- Description of what was fixed

#### Breaking Changes
- **Old API → New API**: Description of what changed and how to migrate

How to Create the Summary:

Read the GitHub Release Notes: Go through each release between your versions
Consolidate by Category: Group all features together, all bug fixes together, etc.
Identify Breaking Changes: Look for:
- Removed or renamed exports
- Changed function signatures
- Modified type definitions
- Deprecated APIs that have been removed
Document Migration Steps: For breaking changes, include the old and new patterns
Check Peer Dependencies: Note if the new version requires different peer dependencies

3. List Important Changes

Categorize changes by impact level:

Critical (Must Address Before Merge):

Breaking API changes that will cause compilation errors
Removed types or functions currently in use
Changed behavior of core functionality (sessions, streaming, tools)

Important (Should Address):

Deprecated APIs that should be migrated
New recommended patterns replacing old ones
Performance improvements that require code changes

Nice to Have (Can Address Later):

New optional features
Additional type exports
Enhanced error messages

4. Update Package Versions

# Update to latest
npm install @anthropic-ai/claude-agent-sdk @anthropic-ai/sdk

5. Detect API Surface Changes

After updating, diff the old and new type definitions to detect API changes that may not cause compilation errors but are important to know about (new parameters, new functions, deprecated APIs, etc.).

Steps:

Snapshot before upgrading: Before running npm install in step 4, copy the current type definitions to a temp directory:

mkdir -p /tmp/anthropic-sdk-old
cp -r node_modules/@anthropic-ai/sdk/*.d.ts node_modules/@anthropic-ai/sdk/resources/*.d.ts /tmp/anthropic-sdk-old/ 2>/dev/null
cp -r node_modules/@anthropic-ai/claude-agent-sdk/*.d.ts /tmp/anthropic-sdk-old/ 2>/dev/null

Important: This snapshot must be taken before step 4's npm install.

Diff the type definitions: After npm install, compare the old and new .d.ts files:

# Diff the Anthropic SDK types
for f in node_modules/@anthropic-ai/sdk/*.d.ts node_modules/@anthropic-ai/sdk/resources/*.d.ts; do
  base=$(basename "$f")
  if [ -f "/tmp/anthropic-sdk-old/$base" ]; then
    diff -u "/tmp/anthropic-sdk-old/$base" "$f"
  else
    echo "+++ NEW FILE: $f"
  fi
done

# Diff the Agent SDK types
for f in node_modules/@anthropic-ai/claude-agent-sdk/*.d.ts; do
  base=$(basename "$f")
  if [ -f "/tmp/anthropic-sdk-old/$base" ]; then
    diff -u "/tmp/anthropic-sdk-old/$base" "$f"
  else

…

查看完整文档 ↗