Anthropic SDK 升级助手
系统化升级 Anthropic SDK，并检查 API 变更、编译问题与 Claude 相关测试。
技能明确说明涉及的 Anthropic SDK 包和升级步骤，未见恶意代码、凭据窃取或隐蔽外传；但要求 npm install、修改代码、删除固定临时目录并创建提交，未要求用户确认，也未说明数据流、回滚方案或升级失败后的恢复策略，因此扣分。
流程覆盖版本检查、类型差异、编译、测试和文档更新，且仓库存在相关 CI 与版本同步测试；但本技能自身没有可执行测试，命令依赖特定目录和文件结构，使用 npm install latest，缺少异常输入、网络失败和命令失败的诊断处理，按静态上限扣分。
触发条件、目标用户和 Anthropic SDK 升级场景描述清楚，包含多个示例；但未定义不适用场景、目标版本输入约束、权限边界或中文使用指导，也未讨论中国大陆网络访问 GitHub release 的可达性，因此仅给中等分数。
技能采用分步骤结构，包含包说明、输出格式、常见问题、命令示例和限制性提示；仓库提供 MIT 许可、Microsoft 来源和 CI 维护信号，但技能没有自身版本、变更记录、维护责任或明确更新路径，且安装前提与回滚说明不完整。
该流程可能帮助完成 SDK 升级、API 差异分析、编译修复和测试验证，产出格式也较明确；但目标版本未定义，默认升级到 latest，要求提交变更并依赖外部 release notes，结果仍需人工审查，静态证据不足以证明可直接使用，因此按静态上限给分。
仓库文件提供依赖版本、相关源码路径、测试命令和部分 CI 证据，具备有限审计基础；但没有该技能的专门测试、示例执行记录或升级结果，且本次未执行任何命令，无法独立复现关键路径，因此低分。
- 升级到“latest”可能引入未经评估的破坏性变更；应先明确目标版本并在修改或提交前取得用户确认。
- npm install 会访问外部注册表，GitHub release notes 依赖外部网络；应记录实际版本、锁文件变化和失败恢复方案。
- 固定执行 rm -rf /tmp/anthropic-sdk-old 前应确认目录归属，并采用可恢复的清理方式。
- 技能未说明敏感代码、环境变量或 SDK 请求数据是否会被发送到外部服务。
它能做什么 & 适用场景
该技能面向需要升级 Anthropic SDK 包的开发者，重点处理 @anthropic-ai/sdk 和 @anthropic-ai/claude-agent-sdk。它要求先检查当前版本和发布说明，再汇总版本差异、识别 API 表面变化并交叉检查代码使用情况。升级后，它会指导开发者运行编译和 Claude 相关单元测试，并在需要时更新文档和提交信息。它针对 vscode-copilot-chat 项目中的 Claude 代理代码，适合需要可审计升级流程而不是单纯修改 package.json 的场景。
读取 package.json 中的当前 SDK 版本，并查看两个 Anthropic SDK GitHub 发布页面；按功能、缺陷修复和破坏性变更整理版本差异；使用 npm install 更新 @anthropic-ai/claude-agent-sdk 和 @anthropic-ai/sdk；在升级前复制 .d.ts 类型定义到 /tmp/anthropic-sdk-old，并在升级后用 diff 比较新增导出、新增参数、签名变化、移除或重命名项目及弃用项；使用 grep 检查受影响 API 在 Claude 代理代码中的使用情况；运行 npm run compile 和 Claude 相关单元测试；最后指导文档更新、临时文件清理和详细提交信息编写。
- 维护 vscode-copilot-chat 的开发者准备将 @anthropic-ai/sdk 升级到新版本，需要了解破坏性 API 变化。
- 使用 Claude Agent SDK 的团队需要从一个版本迁移到另一个版本，并希望按类别汇总所有发布说明。
- 升级后出现类型错误的工程师需要检查导出、接口、函数签名和类型定义的变化。
- 负责代码审查的开发者需要确认 SDK 升级是否影响会话、消息流、工具、钩子或权限处理代码。
- 项目维护者需要在升级后执行编译和 Claude 相关测试，并生成包含版本、功能和迁移信息的提交说明。
优缺点一览
- 覆盖版本检查、发布说明汇总、类型定义差异、代码使用交叉检查、编译、测试和提交说明。
- 明确区分 Critical、Important 和 Nice to Have 三个影响级别。
- 特别关注会话、流式消息、工具、钩子和权限处理等 Claude 代理相关 API。
- 提供升级前快照和升级后 diff 的具体 shell 命令，便于复核 API 表面变化。
- 范围仅针对两个 Anthropic SDK 包，不是通用依赖升级技能。
- 说明明确面向 vscode-copilot-chat 项目，并列出了该项目中的特定代码路径，迁移到其他项目可能需要调整。
- 资料没有提供独立安装命令、自动化脚本或固定 SDK 版本。
- 流程需要访问 GitHub 发布说明，并使用 shell、文件系统、npm、编译和测试命令；资料没有说明其他平台或环境的测试情况。
如何安装
该技能位于 microsoft/vscode 仓库的 extensions/copilot/.agents/skills/anthropic-sdk-upgrader/SKILL.md。提供的资料没有说明将该技能单独安装到其他客户端的命令；它属于仓库中 61 个技能的一部分。若已获取该仓库，可从上述路径读取其 SKILL.md。
如何使用
在支持该技能的 Agent Skills 客户端中提出具体升级请求，例如：“升级 Anthropic SDK 到最新版本”或“帮我迁移到最新的 claude-agent-sdk”。实际流程会围绕 vscode-copilot-chat 项目执行：先检查版本和发布说明，再运行 npm install，比较类型定义，检查使用点，执行 npm run compile 和 npm run test:unit -- --testPathPattern="agents/claude"。资料未说明独立于该项目运行时所需的额外配置。