SuperAPI AI 工具集

tool-rename-deprecation

通用与其它

查看项目

更新于 10-16 00:32

技能介绍

用途:这是一个针对 VS Code 源码中内置工具与工具集注册代码的重命名兼容性技能。当工具或工具集的引用名(referenceName)发生变更时,必须把旧名称加入 deprecated/legacy 数组,否则已有的 .prompt.md 文件、工具配置和用户保存的引用将无法继续解析。

主要能力:识别变更类型(工具或工具集、TypeScript 注册或扩展 package.json 注册);将旧名写入 legacyToolReferenceFullNames(工具)或 legacyFullNames(工具集);检查所有按引用名查找工具的消费方,包括提示解析、工具启用映射与自动批准配置;对变更工具注册的 PR 做回归检查。

使用方式:在改动工具或工具集注册代码后运行此技能。对 TypeScript 的 IToolData 工具,保留 id 不变、修改 toolReferenceName 并添加 legacyToolReferenceFullNames;工具集调用 createToolSet 时用 legacyFullNames 传入旧名;扩展工具只重命名 toolReferenceName 并添加旧名,绝不修改 name 字段(它映射为 id,还用于激活事件)。多次重命名须累积所有旧名,不得删除既有条目。工具若在工具集间迁移,使用 toolSet/toolName 完整路径形式记录旧名。

适用场景:重命名工具的 toolReferenceName、重命名工具集的 referenceName、工具在工具集间移动、审查修改工具注册的 PR 时验证旧名未被丢弃。

限制:资料仅给出三类实际重命名示例与若干参考 PR,未提供安装命令、运行方式、支持平台或收费信息;缺失事实暂未提供。核心约束是不可改 id 与扩展工具的 name 字段、不可假设旧名已在数组中、不可移除旧名,且兼容性需在所有消费方生效,而不仅提示解析。