AIKraft/Skills/Отладка активации clr

Отладка активации clr

Diagnoses .NET Framework CLR activation issues using CLR activation logs (CLRLoad logs) produced by mscoree.dll. Use when: the shim picks the wrong runtime, fails to load any runtime, shows unexpected .NET 3.5 Feature-on-Demand (FOD) dialogs, unexpectedly does NOT show FOD dialogs, loads both v2 and v4 into the same process causing failures, or any time someone is wondering

dotnet official Разработка

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

Навык диагностирует проблемы активации среды выполнения .NET Framework, анализируя логи CLRLoad, создаваемые модулем mscoree.dll. Он позволяет отследить каждое решение, принимаемое шимом при выборе и загрузке версии CLR.

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

  • Процесс не может загрузить CLR вообще с ошибкой "Unable to find a version of the runtime to use"
  • Шим выбирает неверную версию CLR (например, v2.0 вместо v4.0)
  • Появляются неожиданные диалоги установки .NET 3.5 Feature-on-Demand (FOD)
  • Ожидаемые диалоги FOD не появляются
  • В один процесс загружаются одновременно CLR v2 и CLR v4, что вызывает сбои

Как работает

  1. Собрать логи активации CLR (CLRLoad logs), генерируемые shim (mscoree.dll)
  2. Проанализировать логи, чтобы определить, какие решения принимал shim при выборе версии
  3. Сопоставить поведение shim с ожидаемым (например, правильная версия или наличие FOD)
  4. Выявить причину несоответствия, если загрузка не удалась или произошла загрузка нескольких версий
  5. Исключить проблемы, не связанные с активацией (например, сбои после загрузки или ошибки привязки сборок)

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

Почему моя программа выдает ошибку Unable to find a version of the runtime to use?
Шим загружает v2.0 вместо v4.0, помоги разобраться по логам CLRLoad
Почему появляется диалог установки .NET 3.5 FOD, хотя он не нужен?

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

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

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

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