# consuming-dotnettool

Правило consuming-dotnettool для Claude Code организует локальные .NET-инструменты через manifest-файл, фиксирует версии и добавляет их восстановление в CI/CD.

- правило · `type=rule` · Claude Code, Cursor, Codex, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 138 у репозитория
- Автор: Aaronontheweb
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Aaronontheweb/dotnet-cursor-rules/tree/HEAD/dotnet-tools/consuming-dotnettool.mdc
- Обновлён: 2025-03-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/consuming-dotnettool

## Что делает

consuming-dotnettool задаёт порядок работы с зависимостями `dotnet tool` в .NET-проектах. Оно требует хранить manifest в `.config/dotnet-tools.json`, указывать явные версии и добавлять файл в систему контроля версий. Для нового manifest используется `dotnet new tool-manifest`, а инструменты добавляются через `dotnet tool install <tool-package> --version <version>`.

Правило описывает установку, обновление и проверку инструментов, а также документацию в README или contributing guidelines. В CI/CD нужно запускать `dotnet tool restore` до сборки или тестов и проверять, что версии в manifest не изменились самовольно. Отдельные рекомендации касаются доверенных источников, лицензий и отказа от диапазонов версий.

В CI/CD `dotnet tool restore` должен выполняться до build или test, иначе этот процесс не восстановит инструменты из manifest заранее.

## Установка

### Cursor (родная платформа)

**Вручную: положить файлы**
- Файл: `.cursor/rules/consuming-dotnettool.mdc` — Во frontmatter: description, globs, alwaysApply

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/consuming-dotnettool.md` — Поле paths во frontmatter ограничивает файлы: globs из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/consuming-dotnettool.instructions.md` — Поле applyTo задаёт, к каким файлам применять: globs из источника → applyTo

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/consuming-dotnettool.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/consuming-dotnettool.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Aaronontheweb/dotnet-cursor-rules/tree/HEAD/dotnet-tools/consuming-dotnettool.mdc

## Когда брать
- создать manifest для локальных .NET-инструментов
- зафиксировать версии `dotnet tool` в проекте
- восстановить инструменты перед сборкой и тестами
- обновить инструмент с заданной версией
- проверить manifest на устаревшие зависимости

## Примеры запросов агенту
- Проверь, как подключить `dotnet tool` к этому проекту через `.config/dotnet-tools.json`.
- Создай manifest командой `dotnet new tool-manifest` и добавь в него `<tool-package>` версии `<version>`.
- Подготовь шаги CI/CD: восстановление через `dotnet tool restore`, проверка версий и описание инструментов в README.

## Похожие
- [dotnet-devcert-trust](https://affpapa.org/nevibecode/skills/dotnet-devcert-trust.md) — скилл · 468 установок
- [migrate-vstest-to-mtp](https://affpapa.org/nevibecode/skills/migrate-vstest-to-mtp.md) — скилл · 4300 установок
- [setup-local-sdk](https://affpapa.org/nevibecode/skills/setup-local-sdk.md) — скилл · 4000 установок
- [dotnet-local-tools](https://affpapa.org/nevibecode/skills/dotnet-local-tools.md) — скилл · 560 установок
- [powershell-7-expert](https://affpapa.org/nevibecode/agents/powershell-7-expert.md) — субагент · 256 установок
- [dotnet-upgrade](https://affpapa.org/nevibecode/rules/dotnet-upgrade.md) — правило · ★ 41430 у репозитория

Из того же набора: [aaronontheweb/dotnet-cursor-rules](https://affpapa.org/nevibecode/by/aaronontheweb/dotnet-cursor-rules.md) — 11 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
