Agent Skills
› managedcode/dotnet-skills
› project-setup
project-setup
GitHub用于创建或重构 .NET 解决方案，建立清晰的项目边界、共享构建配置及 CI/测试基线。触发场景包括新建项目、重组现有结构、设置 Directory.Build.props 等。
Trigger Scenarios
创建新的 .NET 解决方案
重构现有 .NET 项目结构
设置 Directory.Build.props 或共享包管理
Install
npx skills add managedcode/dotnet-skills --skill project-setup -g -y
SKILL.md
Frontmatter
{
"name": "project-setup",
"description": "Create or reorganize .NET solutions with clean project boundaries, repeatable SDK settings, and a maintainable baseline for libraries, apps, tests, CI, and local development. USE FOR: creating a new .NET solution or restructuring an existing one; setting up Directory.Build.props, shared package management, or repo-wide defaults; defining project. DO NOT USE FOR: unrelated stacks; generic tasks that do not need this specific guidance. INVOKES: inspect the repository context, edit targeted files, and run relevant build, test, lint, or validation commands when changes are made.",
"compatibility": "Best for new repositories or structural refactors of existing .NET solutions."
}
.NET Project Setup
Trigger On
- creating a new .NET solution or restructuring an existing one
- setting up
Directory.Build.props, shared package management, or repo-wide defaults - defining project layout for apps, libraries, and test projects
Workflow
- Start from the app model and deployment target, then choose the smallest correct SDK and target framework set.
- Use solution folders and project names that reflect bounded contexts or product areas, not temporary implementation details.
- Centralize shared build settings, analyzer rules, nullable context, and package versions where it reduces duplication without hiding important differences.
- Create test projects and CI hooks early so new projects do not drift into unverified templates.
- Prefer project references and composition over circular dependencies or utility dumping grounds.
- Document the local build, test, and run path in repo docs or
AGENTS.mdwhen the workflow is not obvious.
Current Upstream Notes
- The August 2026 "Build apps with .NET" Learn overview reinforces app-model-first setup: console, web, worker, desktop, mobile, cloud, and AI entry points should drive SDK/template choice.
.NET SDK 10.0.400is the current 10.0.4xx feature band. It expands file-based app support, adds Microsoft.Testing.Platform--projectand--solutionselection todotnet test, accepts@as thedotnet newoption separator, and fixes hardlink and incremental-build paths. Keepglobal.json, workloads, and CI images explicit for the selected feature band.
Deliver
- a coherent solution structure
- shared build defaults that are easy to reason about
- starter quality and testing hooks for future work
Validate
- projects have explicit responsibility boundaries
- shared MSBuild settings do not accidentally override platform-specific needs
- a new contributor can build and test the repo without guessing
References
- patterns.md: solution layout conventions,
Directory.Build.props,Directory.Build.targets, Central Package Management,global.json,nuget.config, analyzers, multi-targeting, and source link - templates.md:
dotnet newtemplates for console apps, class libraries, ASP.NET Core APIs, worker services, Blazor, test projects, .NET Aspire, and gRPC services
Version History
-
0559476
Current 2026-08-19 23:35
更新上游笔记至 August 2026，SDK 版本升级至 10.0.400，新增 dotnet test 选择参数及 @ 分隔符支持。
- 7ab7f03 2026-07-25 05:25
