dependency-management — правило для Claude Code и Cursor
Правило dependency-management для безопасного управления NuGet-зависимостями: проверка уязвимостей, совместимость лицензий, версионирование через dotnet CLI. Применяется к файлам проекта автоматически.
Apache-2.0 ★ 138 обновлён 2025-03-29
.cursor/rules/dependency-management.mdcЧто делает dependency-management
Правило задаёт workflow для работы с пакетами в .NET-проектах. Оно помогает ИИ-кодеру выбирать команды dotnet CLI вместо прямого редактирования .csproj и .fsproj, проверять лицензии перед установкой и отслеживать уязвимости с помощью dotnet list package --vulnerable.
Внутри есть примеры команд: как добавить пакет конкретной версии (dotnet add package Serilog -v 3.1.1), как найти устаревшие версии (dotnet list package --outdated), как сгенерировать lock-файл и запустить сканирование. Правило охватывает файлы конфигурации Directory.Packages.props, *.csproj, *.fsproj, nuget.config — они будут проанализированы в контексте.
Предполагает центральное управление версиями через Directory.Packages.props с использованием семантического версионирования: блокировка мажорных версий для стабильности, допуск минорных обновлений для новых функций, автообновление патчей для безопасности. Требует запуска проверок в CI/CD и отслеживания лицензий перед каждой установкой.
Какие задачи решает
- выбрать между
dotnet addи ручным редактированием конфигов - найти устаревшие и уязвимые пакеты в решении
- установить пакет с соблюдением лицензионных требований
- обновить пакет и проверить совместимость кода
- настроить версионирование с учётом мажорных и минорных обновлений
Примеры запросов агенту
- Добавь пакет Serilog версии 3.1.1 в основной проект
- Найди все устаревшие пакеты и покажи доступные версии
- Проверь, какие пакеты имеют известные уязвимости
Как установить dependency-management
Вручную: положить файлы
.cursor/rules/dependency-management.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.claude/rules/dependency-management.mdПоле paths во frontmatter ограничивает файлы: globs из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.github/instructions/dependency-management.instructions.mdПоле applyTo задаёт, к каким файлам применять: globs из источника → applyTo
Вручную: положить файлы
.devin/rules/dependency-management.mdВручную: положить файлы
.clinerules/dependency-management.mdПо шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules
Вопросы о dependency-management
Как установить правило dependency-management в Claude Code?
Создай файл .claude/rules/dependency-management.md в корне проекта и скопируй содержимое правила. Claude Code загрузит его автоматически при следующем запуске.
Что делает это правило?
Правило направляет ИИ-кодера использовать dotnet CLI для управления пакетами вместо прямого редактирования файлов, проверять лицензии перед установкой и отслеживать уязвимости через dotnet list package --vulnerable. Оно также рекомендует версионирование через Directory.Packages.props.
Какая команда проверяет уязвимости в пакетах?
Используй dotnet list package --vulnerable. Для полного анализа сначала сгенерируй lock-файл: dotnet restore --use-lock-file.
Исходный текст
dependency-management.mdc · Apache-2.0
---
description: This file provides guidelines for safely managing NuGet package dependencies in .NET projects, focusing on security, licensing, and maintainability.
globs: Directory.Packages.props,*.csproj,*.fsproj,Directory.Build.props,nuget.config
alwaysApply: false
---
# Cursor Rules File: Best Practices for .NET Dependency Management
Role Definition:
- Package Management Expert
- Security Analyst
- License Compliance Specialist
General:
Description: >
.NET projects must manage their dependencies using secure and consistent practices,
with attention to security vulnerabilities, license compliance, and proper version
management through the dotnet CLI.
Requirements:
- Use dotnet CLI for package management
- Verify package licenses before installation
- Monitor for security vulnerabilities
- Maintain consistent versioning strategies
Package Installation:
- Always use dotnet CLI commands:
- Preferred: `dotnet add package <PackageId> [-v <Version>]`
- Avoid manual .csproj/.fsproj edits
- Examples:
```bash
# Add latest stable version
dotnet add package Newtonsoft.Json
# Add specific version
dotnet add package Serilog -v 3.1.1
# Add package to specific project
dotnet add MyProject/MyProject.csproj package Microsoft.Extensions.Logging
```
- Before installation:
- Check package license compatibility
- Review package download statistics
- Verify package authenticity (signed packages)
- Consider package maintenance status
Check and Upgrade NuGet Packages:
To check for outdated packages and upgrade them in your .NET solution:
1. **Check for outdated packages**
```bash
dotnet list package --outdated
```
This command will show:
- Currently used version ("Resolved")
- Latest available version ("Latest")
- The version you're requesting ("Requested")
2. **Update package versions**
- If using central package management (Directory.Packages.props):
- Update the versions in `Directory.Packages.props`:
```xml
<PackageVersion Include="PackageName" Version="NewVersion" />
```
- If using traditional package references:
```bash
dotnet add package PackageName --version NewVersion
```
3. **Restore and verify**
```bash
dotnet restore
dotnet build
dotnet test
```
Example output of `dotnet list package --outdated`:
```
Project `MyProject` has the following updates to its packages
[netstandard2.1]:
Top-level Package Requested Resolved Latest
> Akka.Streams 1.5.13 1.4.45 1.5.38
```
Note: After updating packages, always:
1. Check for breaking changes in the package's release notes
2. Build the solution to catch any compatibility issues
3. Run tests to ensure everything still works
4. Review and update any code that needs to be modified for the new versions
Security Considerations:
- Enable security scanning:
- Run `dotnet restore --use-lock-file` to generate lock file
- Use `dotnet list package --vulnerable` to check for known vulnerabilities
- Configure GitHub Dependabot or similar tools
- Monitor security:
- Subscribe to security advisories
- Regular vulnerability scanning in CI/CD
- Automated security updates for patch versions
- Example workflow:
```bash
# Generate lock file
dotnet restore --use-lock-file
# Check for vulnerabilities
dotnet list package --vulnerable
# Update vulnerable package
dotnet add package VulnerablePackage -v SecureVersion
# Regenerate lock file
dotnet restore --force-evaluate
```
License Compliance:
- Verify licenses before adding dependencies:
- Check license compatibility with your project
- Document license requirements
- Maintain license inventory
- Common OSS-friendly licenses:
- MIT
- Apache 2.0
- BSD
- MS-PL
- Warning signs:
- No license specified
- Restrictive licenses (GPL for commercial software)
- License changes between versions
Version Management:
- Use semantic versioning:
- Lock major versions for stability
- Allow minor updates for features
- Auto-update patches for security
- Version constraints:
- Avoid floating versions (*)
- Use minimum version constraints when needed
- Document version decisions
- Example in Directory.Packages.props:
```xml
<Project>
<ItemGroup>
<!-- Locked major version -->
<PackageVersion Include="Important.Package" Version="2.0.0" />
<!-- Allow minor updates -->
<PackageVersion Include="Feature.Package" Version="[3.0,4.0)" />
<!-- Allow patch updates -->
<PackageVersion Include="Stable.Package" Version="[1.2.3,1.3.0)" />
</ItemGroup>
</Project>
```
Maintenance:
- Regular housekeeping:
- Remove unused packages
- Consolidate duplicate dependencies
- Update documentation
- Automation:
- Implement automated vulnerability scanning
- Set up dependency update workflows
- Configure license compliance checks
- Commands for maintenance:
```bash
# List all packages
dotnet list package
# Check for unused dependencies
dotnet remove package UnusedPackage
# Clean solution
dotnet clean
dotnet restore --force
```
Integration with CI/CD:
- Implement checks:
- Vulnerability scanning
- License compliance
- Package restore verification
- Example GitHub Actions workflow:
```yaml
- name: Security scan
run: |
dotnet restore --use-lock-file
dotnet list package --vulnerable
- name: License check
run: dotnet-project-licenses
```
# End of Cursor Rules File
© Aaronontheweb · Apache-2.0 · Aaronontheweb/dotnet-cursor-rules