К основному содержанию
правило CX Codex

publishing-dotnettool — правило для Claude Code и Cursor

Правило publishing-dotnettool для Claude Code и Cursor направляет ИИ-агента при создании и публикации dotnet-инструментов в NuGet. Гарантирует семантическое версионирование, правильную упаковку и совместимость с разными версиями .NET.

Apache-2.0 ★ 138 обновлён 2025-03-29

Установить в Cursor · Вручную: положить файлы Все способы и платформы ↓
.cursor/rules/publishing-dotnettool.mdc
Открыть на GitHub

Что делает publishing-dotnettool

Правило описывает роль ИИ как .NET-эксперта и автора open-source, который должен убедиться, что проект содержит правильный .csproj с флагом <PackAsTool>true</PackAsTool>, метаданные пакета (PackageId, Authors, Description, License) и полную документацию с примерами использования и FAQ.

При подготовке проекта агент проверяет зависимости, нацеливает сборку на .NET 8 (если нет явных требований к другой версии) и добавляет <RollForward>LatestMajor</RollForward> для автоматической совместимости с новыми runtime. На этапе упаковки используется команда dotnet pack для генерации .nupkg-файла с верификацией содержимого и локального установки инструмента.

Правило применяется к файлам .cursor/rules/, .claude/rules/ и аналогичных директорий IDE, актуально для разработчиков, которые публикуют собственные dotnet-инструменты и хотят автоматизировать проверку качества с помощью Cursor или Claude Code.

Какие задачи решает

  • проверить соответствие dotnet-инструмента семантическому версионированию
  • убедиться, что проект правильно упакован как NuGet-пакет
  • валидировать метаданные и зависимости перед публикацией
  • задать совместимость инструмента с новыми версиями .NET без переиздания

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

  • Создай dotnet-инструмент с правильной конфигурацией для публикации в NuGet
  • Проверь, что мой проект содержит <PackAsTool>true</PackAsTool> и все нужные метаданные
  • Упакуй и протестируй инструмент перед выпуском нового релиза

Как установить publishing-dotnettool

Вручную: положить файлы

.cursor/rules/publishing-dotnettool.mdc

Во frontmatter: description, globs, alwaysApply

По шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules

Вопросы о publishing-dotnettool

Как установить правило publishing-dotnettool в Claude Code?

Скопируй файл правила в директорию .claude/rules/publishing-dotnettool.md в корне проекта. Claude Code автоматически подхватит его при работе с dotnet-инструментами.

Что делает это правило?

Направляет ИИ-агента на проверку и применение best practices при создании dotnet-инструментов: семантическое версионирование, правильная упаковка в NuGet, совместимость с разными версиями .NET, полная документация.

Какую версию .NET должен использовать инструмент?

По умолчанию правило рекомендует .NET 8 (текущий LTS). Если проект нацелен на другую версию или multi-target, инструмент это учитывает. Добавь <RollForward>LatestMajor</RollForward> для совместимости с новыми runtime.

Исходный текст

publishing-dotnettool.mdc · Apache-2.0
---
description: This file serves as a guideline for the Cursor AI Agent to ensure the proper creation, packaging, and publishing of a `dotnet tool`. Follow these rules to maintain consistency, quality, and security across published tools.
globs: 
alwaysApply: false
---

# Cursor Rules File: Best Practices for Publishing a dotnet Tool
# This file serves as a guideline for the Cursor AI Agent to ensure the proper
# creation, packaging, and publishing of a dotnet tool. Follow these rules to
# maintain consistency, quality, and security across published tools.


Role Definition:
 - .NET Expert
 - OSS author
 - Aware that users running on multiple versions of .NET in different environments might need access to this tool

General:
  Description: >
    The dotnet tool must be packaged as a NuGet package that adheres to
    semantic versioning, proper dependency management, and includes comprehensive
    documentation. This file outlines the steps and checks that need to be performed.
  Requirements:
    - Use a project file (.csproj) with the property <PackAsTool>true</PackAsTool>
    - Follow semantic versioning (MAJOR.MINOR.PATCH)
    - Ensure the tool is documented with a README and inline help support

Preparation:
  - Validate that the project file includes:
      - <PackAsTool>true</PackAsTool>
      - Proper versioning and package metadata (e.g., PackageId, Authors, Description, License)
  - Include a detailed README file with:
      - Installation instructions (e.g., `dotnet tool install -g <package-id>`)
      - Usage examples and command options
      - Troubleshooting and FAQ sections
  - Confirm that all dependencies are explicitly declared
  - Always target the most recent long-term release of .NET (currently .NET 8) unless the project is explicitly set to multi-target or targets and older version of the runtime
  - Always include a `<RollForward>LatestMajor</RollForward>` so the tool can automatically be used with newer runtimes without a new version needing to be released

Packaging:
  - Use the `dotnet pack` command to generate the NuGet package:
      - Ensure that all necessary files (binaries, assets, configuration files) are included
      - Verify that the output .nupkg file contains the expected metadata and assets
  - Run tests to verify that the tool functions correctly in a local install scenario

# End of Cursor Rules File

© Aaronontheweb · Apache-2.0 · Aaronontheweb/dotnet-cursor-rules

Похожие правила IDE

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
nuget-trusted-publishing dotnet Скилл nuget-trusted-publishing настраивает публикацию пакетов в nuget.org через GitHub Actions и OIDC без постоянных API-ключей. Пригодится при переводе сборки на NuGet/login или создании нового пайплайна. CX Codex +1 4 400установок dotnet-inspect richlander Скилл dotnet-inspect для Claude Code и Codex помогает исследовать сборки, метаданные и IL-код в .NET. Вытягивает точные сигнатуры API, зависимости пакетов и различия между версиями. CX Codex +1 516установок nuget-manager davila7 Команда nuget-manager управляет пакетами NuGet в проектах .NET через CLI. Команда следит за корректным добавлением зависимостей и обновлением версий через централизованные конфиги. CX Codex +1 128установок csharp-scripts dotnet Скилл csharp-scripts для Claude Code запускает однофайловый C#-код через dotnet без создания проекта. Так проверяют языковые фичи и выполняют мелкие утилиты. CX Codex +1 4 900установок tiktok-video-publishing social-media-skills Скилл tiktok-video-publishing для Claude Code настраивает публикацию TikTok-видео через WoopSocial и пишет поисковую подпись. Перед загрузкой выставляет подпись, обложку, приватность, дуэты и дисклеймеры. CX Codex +1 1 200установок package-management Aaronontheweb Скилл package-management для Claude Code управляет пакетами NuGet через команды dotnet. Он включается при добавлении, удалении и обновлении пакетов или настройке CPM. CX Codex +1 623установок

Из того же набора11

Весь набор →
meta Правило meta задаёт, как менять файлы .mdc в репозитории: сохранять форматирование и обновлять существующие правила, а не плодить новые без причины. CX Codex +1 ★ 138звёзд репо code-signing Правило code-signing задаёт стандарты подписи сборок и пакетов NuGet через SignClient в проектах на .NET. Применяется при настройке CI/CD. CX Codex +1 ★ 138звёзд репо consuming-dotnettool Правило consuming-dotnettool для Claude Code организует локальные .NET-инструменты через manifest-файл, фиксирует версии и добавляет их восстановление в CI/CD. CX Codex +1 ★ 138звёзд репо dependency-management Правило dependency-management для безопасного управления NuGet-зависимостями: проверка уязвимостей, совместимость лицензий, версионирование через dotnet CLI. Применяется к файлам проекта автоматически. CX Codex +1 ★ 138звёзд репо solution-management Правило solution-management задаёт стандарты организации решений .NET: фиксирует версии SDK, общие свойства сборки и централизованное управление NuGet-пакетами. CX Codex +1 ★ 138звёзд репо benchmarking Правило benchmarking для Claude Code учит агента писать корректные тесты производительности .NET через BenchmarkDotNet. Тесты измеряют скорость кода и отслеживают регрессии. CX Codex +1 ★ 138звёзд репо nuget-package-publishing Правило nuget-package-publishing, которое учит агента упаковывать .NET-библиотеки в NuGet по стандартам: с SPDX-лицензией, README и символами для отладки. CX Codex +1 ★ 138звёзд репо testing Правило testing задаёт стандарты написания тестов на C# с xUnit: настройку .NET 8 проектов, фикстуры, проверку покрытия кода и запуск интеграционных тестов. CX Codex +1 ★ 138звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой