AIKraft/Skills/dotnet-breaking-changes

dotnet-breaking-changes

Проверяет .NET/C# код на скрытые нарушения обратной совместимости (ApiCompat, nullability, optional parameters) до изменения публичных API. Полезно при добавлении методов, изменении сигнатур или рефакторинге библиотек с PublicAPI.Shipped/Unshipped.txt.

DOdotnet official Разработка ★ 6.1k

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

Skill проверяет .NET/C# код на скрытые нарушения обратной совместимости (ApiCompat, nullability, optional parameters) до изменения публичных API. Он помогает избежать поломок у потребителей, других целевых платформ или сборок-друзей, даже если код компилируется и тесты проходят.

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

  • Добавление новых методов, перегрузок или целевых платформ в библиотеку.
  • Изменение сигнатур существующих публичных API.
  • Рефакторинг библиотек с использованием файлов PublicAPI.Shipped/Unshipped.txt.
  • Проверка поведения многоцелевых (multi-targeted) или частичных (partial) типов на всех платформах.

Как работает

  1. Определите, какие поверхности (surfaces) фактически существуют в репозитории, ориентируясь на присутствующие маркеры.
  2. Проверьте только те поверхности, которые выявлены, не предполагая наличие тех, маркеры которых отсутствуют.
  3. Оцените изменения на предмет соблюдения контракта, учитывая, что добавленная поверхность является постоянным обязательством.
  4. Убедитесь, что добавленное поведение корректно на каждой целевой платформе и переживет следующую генерацию кода.

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

Проверь, не нарушит ли добавление нового публичного метода обратную совместимость в этой библиотеке.
Оцени изменения сигнатуры существующего API на предмет скрытых нарушений для downstream-потребителей.
Проверь корректность поведения partial-типа на всех целевых платформах после рефакторинга.

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

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

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

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