GitHub Copilot SDK 升级助手
在 VS Code Copilot Chat 项目中升级并验证 @github/copilot。
技能明确要求升级 npm 包并运行 postinstall、编译和测试，存在外部依赖安装及代码执行影响，但未说明权限范围、数据流、敏感信息处理、用户确认、回滚或锁定版本；仓库具备 MIT 许可和官方来源信息，因此保留少量信任分。
步骤覆盖快照、安装、编译和单元测试，但“必须运行集成测试”与“不要运行任何集成测试”直接矛盾，且多处拼写、编号和路径表述错误；仓库有相关 CI 证据，但未证明该技能路径可复现，故分数很低。
目标场景和主要输入（VS Code Copilot 项目中的 @github/copilot 升级）较明确，但未声明适用边界、失败条件、环境要求或触发排除条件；依赖 npm/GitHub 生态，未提供中文使用支持或网络可达性说明。
文档按升级阶段组织，并包含命令和输出文档位置；但缺少安装前置条件、版本策略、变更日志、维护责任、更新路径、故障排查和已知限制，TODO 要求还存在编号缺失及重复总结。MIT 许可和 Microsoft 归属可由仓库文件确认。
若按 happy path 执行，可能完成依赖升级、类型差异记录和测试；但集成测试要求自相矛盾，未定义升级失败时的恢复方式，也未给出代表性输出或替代方案，最终结果仍可能需要较多人工判断。
技能给出具体命令和目标文件，仓库也提供部分 GitHub Actions、依赖锁定和测试代码作为审计线索；但这些材料未覆盖该升级技能的关键路径，且本次仅静态阅读，不能验证命令、输出或测试结果。
- 集成测试要求相互矛盾，执行前必须由用户明确选择是否运行。
- npm install @github/copilot@latest 会引入未锁定的最新版本，缺少回滚和变更审批说明。
- 技能未说明凭据、网络请求、postinstall 脚本副作用及失败后的恢复步骤。
- 未提供中文交互、网络受限环境适配或 npm/GitHub 不可达时的替代方案。
它能做什么 & 适用场景
该技能面向 vscode-copilot-chat 项目中的 @github/copilot npm 包升级。它要求先记录旧版类型定义，再安装最新版依赖、执行 postinstall，并比较升级前后的 index.d.ts。随后它会指导编译、修复、单元测试和升级说明文档的整理。SKILL.md 同时列出集成测试步骤，但明确注明不要运行任何集成测试。
它要求创建并持续更新 TODO Markdown 文件，作为升级过程的跟踪机制。它读取 node_modules/@github/copilot/sdk/index.d.ts 的旧版本快照，运行 npm install @github/copilot@latest 和 npm run postinstall。它要求比较新旧类型定义，并将 API 变化、新功能、破坏性变化或移除内容记录到 .build/upgrade-notes.md。它还要求运行 npm run compile、npx tsc --noEmit --project tsconfig.json 和 npm run test:unit，在发现问题后分析并修复，最后汇总代码、测试和类型定义变化。
- VS Code Copilot Chat 维护者需要将 @github/copilot 更新到最新版时，使用它按规定顺序执行升级检查。
- TypeScript 项目需要确认 npm 包升级是否引入类型错误时，使用它对比 index.d.ts 并运行编译检查。
- 开发者需要在依赖升级后验证现有单元测试并记录变更时，使用它生成 .build/upgrade-notes.md。
- 团队需要保留升级过程中的 TODO、类型差异和测试结果时，使用它作为操作清单。
优缺点一览
- 覆盖依赖安装、postinstall、类型定义对比、编译、类型检查、单元测试和总结文档。
- 要求使用 TODO 文件跟踪每个步骤，并在完成后更新记录。
- 明确要求分析编译和测试失败，而不是仅为通过测试改变代码行为。
- 针对 @github/copilot npm 包和 vscode-copilot-chat 项目，范围较明确。
- 来源没有说明独立安装方法、所需 Node.js 版本或完整运行环境。
- SKILL.md 的步骤编号和文字存在拼写及顺序问题，例如“Repease”“Repeate”和缺失的编号 10。
- 步骤列表要求运行集成测试，但后续注释明确写着不要运行任何集成测试，存在直接冲突。
- 未提供具体的修复策略、测试覆盖范围或成功标准之外的失败处理方案。
- 它依赖本地文件读写、npm 命令和网络访问，但来源未说明跨平台验证情况。
如何安装
该仓库 README 未提供此单个技能的独立安装步骤，也未说明应将技能文件复制到哪个客户端目录。技能文件位于 extensions/copilot/.agents/skills/github-copilot-upgrader/SKILL.md。README 说明整个 VS Code Code - OSS 仓库采用 MIT 许可证，但没有给出该技能的单独安装命令。
如何使用
在已配置该技能的 Agent Skills 客户端中，向代理提出与 vscode-copilot-chat 项目升级 @github/copilot 相关的请求，例如：“请将 vscode-copilot-chat 中的 @github/copilot 升级到最新版，并按技能要求记录类型差异、编译结果和单元测试结果。”具体触发方式、工作目录配置和客户端集成方式未在来源中说明。