AIKraft/Skills/tool-rename-deprecation

tool-rename-deprecation

Обеспечивает обратную совместимость при переименовании встроенных инструментов (toolReferenceName, tool set referenceName). Применяется при любом изменении кода регистрации инструментов, включая legacyToolReferenceFullNames и legacyFullNames.

MIMicrosoft official Разработка ★ 193.5k

Что делает навык

Навык обеспечивает обратную совместимость при переименовании встроенных инструментов (toolReferenceName) или наборов инструментов (referenceName) в VS Code. Он предотвращает регрессии, требуя добавления старых имён в массивы legacy (legacyToolReferenceFullNames или legacyFullNames), чтобы существующие промпты и конфигурации продолжали работать.

Когда применять

  • Переименование поля toolReferenceName у инструмента (IToolData) или referenceName у набора инструментов (IToolSet).
  • Перемещение инструмента из одного набора инструментов в другой.
  • Ревью Pull Request, изменяющего код регистрации инструментов, для проверки отсутствия потери legacy-имён.
  • Обновление ссылок на инструменты в системных промптах и документации после их переименования.

Как работает

  1. Определите тип изменённой сущности (инструмент или набор) и поле, которое переименовывается (toolReferenceName, referenceName или name в package.json).
  2. Добавьте старое значение имени в соответствующий legacy-массив (legacyToolReferenceFullNames для инструментов, legacyFullNames для наборов), не удаляя существующие записи.
  3. Проверьте всех потребителей имён: файлы .prompt.md, конфигурации активации инструментов и настройки авто-одобрения (auto-approval).
  4. Обновите прямые ссылки на новое имя в системных промптах, документации и тестах (опционально, для чистоты кода).
  5. Выполните проверку регрессии: убедитесь, что поле name (stable id) у инструментов расширения не было изменено, так как оно маппится на id.

Примеры запросов агенту

Я переименовал инструмент runInTerminal в runCommands. Добавь старое имя в legacyToolReferenceFullNames и проверь, что авто-одобрение для старого имени всё ещё работает.
В Pull Request изменён referenceName набора инструментов. Убедись, что старое имя добавлено в legacyFullNames и не удалено из других мест.
Проверь, что при переименовании инструмента не было изменено поле name в package.json, так как это стабильный идентификатор.

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «tool-rename-deprecation» из репозитория: # https://github.com/microsoft/vscode
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r tool-rename-deprecation/ ~/.claude/skills/tool-rename-deprecation/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.