这个 Skill 能做什么,适合哪些场景?
这是微软 Visual Studio Code Code-OSS 仓库中的一个开发技能,专门检查内置工具和工具集重命名时的向后兼容性。它要求将旧的引用名称保留在对应的 legacy 数组中,同时保护稳定的 id 或 name 字段。技能还检查提示词解析、工具启用、自动批准和工具集成员关系等消费者。它适合审查修改工具注册代码的 TypeScript 或 package.json 变更,而不是通用的工具开发助手。
检查工具或工具集注册代码中的 toolReferenceName、referenceName、id 和 name 变更;核对 legacyToolReferenceFullNames 或 legacyFullNames 是否包含所有旧名称;检查工具从工具集移动时是否保留旧的 toolSet/toolName 全路径;验证提示词文件、工具配置、工具启用映射和 eligibleForAutoApproval 设置是否仍能识别旧名称;检查扩展贡献工具的 package.json 中 name 是否被错误修改;提示更新系统提示词、内置 .prompt.md 文件、文档和测试中的一方引用。
- 维护 VS Code 内置工具的工程师重命名 toolReferenceName 时,用它确认旧名称已加入 legacyToolReferenceFullNames。
- 修改工具集 referenceName 或 createToolSet 注册逻辑的开发者,用它检查 legacyFullNames 是否保留旧名称。
- 将工具从一个工具集移动到另一个工具集的开发者,用它验证旧的 toolSet/toolName 路径仍可解析。
- 审查涉及 IToolData、createToolSet 或 package.json languageModelTools/languageModelToolSets 的拉取请求的评审者,用它查找回归。
- 维护扩展贡献工具的开发者,用它确认只重命名 toolReferenceName,而不改变作为稳定标识符的 package.json name。
如何安装这个 Skill?
- 这是静态文档审查,未执行技能、测试或实际重命名回归验证。
- 使用时应确认旧名称确实加入对应 legacy 数组,并检查所有消费者;文档中的行号和示例可能随版本变化。
- 文档未定义结构化输出或遇到无法定位注册点时的失败处理,审查者需要自行记录证据和结论。
- 本地文件系统
提供的资料没有给出独立的技能安装命令。该技能位于 GitHub 仓库 https://github.com/microsoft/vscode 的 .github/skills/tool-rename-deprecation/SKILL.md;它属于该仓库包含的 61 个技能之一。仓库整体采用 MIT 许可证。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/microsoft/vscode.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.github/skills/tool-rename-deprecation" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 审查这次工具注册修改,确认所有旧的 toolReferenceName 或 referenceName 都已加入对应的 legacy 数组,并检查稳定的 name/id 是否被修改。
在审查任何工具注册变更时调用此技能,例如:"审查这次工具注册修改,确认所有旧的 toolReferenceName 或 referenceName 都已加入对应的 legacy 数组,并检查稳定的 name/id 是否被修改。"随后按技能步骤检查实际 diff、注册字段、消费者和工具集成员列表。资料未提供可执行脚本或专用命令。
这个 Skill 有哪些优点和局限?
- 覆盖工具重命名、工具集重命名和跨工具集移动等具体场景。
- 不仅检查提示词解析,还覆盖工具启用、自动批准和 RunInTerminalTool 的本地检查。
- 明确区分可变的引用名称与不可变的稳定 id/name,适合代码审查。
- 给出了 runInTerminal、todo 和 getTaskOutput 等真实重命名案例及相关参考 PR。
- 它是审查与指导型技能,资料没有显示包含可直接运行的修复脚本或自动化测试。
- 使用者仍需读取实际 diff 和数组内容,不能只依赖字段是否存在。
- 范围仅限 VS Code 工具和工具集注册兼容性,不是通用的重构或版本迁移工具。
- 资料没有说明独立安装流程、支持的平台矩阵或运行时性能。
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| 工具重命名兼容性检查 本页 ✓ Microsoft · 官方 | 63 · 推荐 | ★ 194k | 11 天前 | MIT |
| 代码简化审查 | 57 · 谨慎使用 | ★ 107k | 12 天前 | MIT |
| Workers 生产实践审查 | 57 · 谨慎使用 | ★ 3.1k | 11 天前 | Apache-2.0 |
| OpenChamber 变更纪律 | 52 · 谨慎使用 | ★ 12k | 11 天前 | MIT |
| 稳定接口设计指南 | 50 · 谨慎使用 | ★ 107k | 12 天前 | MIT |
FollowSkills 如何评估这个 Skill?
技能仅指导检查工具重命名兼容性,不要求执行命令、访问外部服务或处理敏感数据,并明确稳定 ID、旧名称保留及自动批准配置影响,风险边界较清楚;但未明确用户确认、回滚流程、数据流披露或依赖安全检查,因此未满分。
步骤、字段映射、消费者检查和回归清单相互一致,覆盖工具、工具集及扩展场景;但没有可执行脚本、失败输入处理、诊断错误信息或静态可复现测试,按静态限制扣分。
触发条件明确,涵盖重命名、迁移和注册代码审查,并区分 TypeScript 与 package.json;但输入、输出格式、非适用范围和中文使用指导不够明确。核心功能不依赖海外服务,未因网络可达性扣分。
文档包含分层步骤、表格、代码示例、关键文件、真实案例、参考 PR 和反模式,仓库还提供 MIT 许可及 Microsoft 维护来源;但技能自身缺少版本号、变更日志、明确维护责任和更新路径。
该清单可直接支持人工审查工具名称兼容性,重点覆盖稳定 ID、旧名称解析和自动批准等关键结果;但没有静态证据证明代表性变更已成功完成,且仍需人工搜索和验证,因此达到静态上限但未更高。
技能引用具体源码位置、字段和 PR,仓库文件提供可审计的测试与 CI 背景;但未提供针对该技能关键路径的提交测试或第三方执行结果,静态评估按上限给予有限分数。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →