copy-to-output-directory
Управляет режимами MSBuild CopyToOutputDirectory и CopyToPublishDirectory (Never, PreserveNewest, Always, IfDifferent). Полезно для устранения накладных расходов на копирование и сброса изменённых файлов. Не используйте для диагностики инкрементальных сборок.
Что делает навык
Навык управляет метаданными MSBuild CopyToOutputDirectory и CopyToPublishDirectory, определяя, копируются ли файлы рядом с выходными данными сборки и при каких условиях. Выбор правильного режима предотвращает появление устаревших файлов в папке bin/ и устраняет ненужные накладные расходы на производительность при каждой сборке.
Когда применять
- Выбор режима для файлов, которые не требуются во время выполнения (runtime).
- Копирование часто редактируемых исходных файлов с минимальными затратами на проверку временных меток.
- Обработка файлов, которые могут быть изменены между сборками (мутированы).
- Отказ от устаревших решений, требующих безусловного копирования при каждой сборке.
Как работает
- Определите тип элемента (Content, None, EmbeddedResource или Compile), для которого требуется настройка.
- Выберите один из четырех режимов: Never, PreserveNewest, Always или IfDifferent.
- Учтите накладные расходы: Avoid Always из-за дорогого копирования даже при no-op сборках.
- Используйте PreserveNewest для типичных случаев редактирования исходных файлов.
- Применяйте IfDifferent, если файл назначения может быть изменен между сборками.
- Настройте CopyToPublishDirectory аналогично для публикации.
Примеры запросов агенту
Что понадобится
- MSBuild 17.13 или .NET SDK 9.0.2xx
Описание составлено по SKILL.md навыка, сверено 09.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.