重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
dotnet-api by novotnyllc/dotnet-artisan
npx skills add https://github.com/novotnyllc/dotnet-artisan --skill dotnet-apiASP.NET Core API、数据访问、后端服务、安全性和云原生模式。此整合技能涵盖 32 个主题领域。请根据下方的路由表从 references/ 目录加载相应的配套文件。
基线依赖:references/minimal-apis.md 定义了适用于大多数 API 开发任务的核心 ASP.NET Core 最小 API 模式(路由组、终结点过滤器、TypedResults、参数绑定)。构建 HTTP 端点时默认加载此文件。
最常用的配套文件:references/architecture-patterns.md 涵盖了几乎所有 ASP.NET Core 项目中使用的垂直切片、请求管道、错误处理、缓存和幂等性模式。
| 主题 | 关键词 | 描述 | 配套文件 |
|---|---|---|---|
| 最小 API | endpoint, route group, filter, TypedResults | 最小 API 路由组、过滤器、TypedResults、OpenAPI | references/minimal-apis.md |
| 中间件 | pipeline ordering, short-circuit, exception | 管道排序、短路、异常处理 | references/middleware-patterns.md |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| EF Core 模式 | DbContext, migrations, AsNoTracking | DbContext、AsNoTracking、查询拆分、迁移 | references/efcore-patterns.md |
| EF Core 架构 | read/write split, aggregate boundaries, N+1 | 读写分离、聚合边界、N+1 问题 | references/efcore-architecture.md |
| 数据访问策略 | EF Core vs Dapper vs ADO.NET decision | EF Core、Dapper、ADO.NET 决策矩阵 | references/data-access-strategy.md |
| gRPC | proto, code-gen, streaming, auth | Proto 定义、代码生成、ASP.NET Core 宿主、流式传输 | references/grpc.md |
| 实时通信 | SignalR, SSE, JSON-RPC, gRPC streaming | SignalR 中心、SSE、JSON-RPC 2.0、扩展 | references/realtime-communication.md |
| 弹性 | Polly v8, retry, circuit breaker, timeout | Polly v8 重试、断路器、超时、速率限制器 | references/resilience.md |
| HTTP 客户端 | IHttpClientFactory, typed/named, DelegatingHandler | IHttpClientFactory、类型化/命名客户端、DelegatingHandlers | references/http-client.md |
| API 版本控制 | Asp.Versioning, URL/header/query, sunset | Asp.Versioning.Http/Mvc、URL/头部/查询、弃用 | references/api-versioning.md |
| OpenAPI | MS.AspNetCore.OpenApi, Swashbuckle, NSwag | MS.AspNetCore.OpenApi、Swashbuckle 迁移、NSwag | references/openapi.md |
| API 安全 | Identity, OAuth/OIDC, JWT, CORS, rate limiting | Identity、OAuth/OIDC、JWT 持有者、CORS、速率限制 | references/api-security.md |
| OWASP | injection, auth, XSS, deprecated APIs | 针对 .NET 的 OWASP Top 10 加固 | references/security-owasp.md |
| 密钥管理 | user secrets, env vars, rotation | 用户密钥、环境变量、轮换 | references/secrets-management.md |
| 密码学 | AES-GCM, RSA, ECDSA, hashing, key derivation | AES-GCM、RSA、ECDSA、哈希、PQC 密钥派生 | references/cryptography.md |
| 后台服务 | BackgroundService, IHostedService, lifecycle | BackgroundService、IHostedService、生命周期 | references/background-services.md |
| Aspire | AppHost, service discovery, dashboard | AppHost、服务发现、组件、仪表板 | references/aspire-patterns.md |
| Semantic Kernel | AI/LLM plugins, prompts, memory, agents | AI/LLM 插件、提示模板、内存、智能体 | references/semantic-kernel.md |
| 架构 | vertical slices, layered, pipelines, caching | 垂直切片、分层、管道、缓存 | references/architecture-patterns.md |
| 消息传递 | Wolverine, Azure Service Bus, RabbitMQ, pub/sub, sagas | Wolverine、Azure 服务总线、RabbitMQ、发布/订阅、Saga | references/messaging-patterns.md |
| 服务通信 | REST vs gRPC vs SignalR decision matrix | REST、gRPC、SignalR 决策矩阵 | references/service-communication.md |
| API 表面验证 | PublicApiAnalyzers, Verify, ApiCompat | PublicApiAnalyzers、Verify 快照、ApiCompat | references/api-surface-validation.md |
| 库 API 兼容性 | binary/source compat, type forwarders | 二进制/源代码兼容性、类型转发器、SemVer | references/library-api-compat.md |
| I/O 管道 | PipeReader/PipeWriter, backpressure, Kestrel | PipeReader/PipeWriter、背压、Kestrel | references/io-pipelines.md |
| 智能体常见问题 | async misuse, NuGet errors, DI mistakes | .NET 代码中常见的智能体错误 | references/agent-gotchas.md |
| 基于文件的应用 | .NET 10, directives, csproj migration | .NET 10 基于文件的 C# 应用 | references/file-based-apps.md |
| API 文档 | DocFX, OpenAPI-as-docs, versioned docs | DocFX、OpenAPI 即文档、版本化文档 | references/api-docs.md |
| HybridCache | HybridCache, L1/L2, stampede, tag eviction | HybridCache (.NET 9+)、防缓存击穿、基于标签的驱逐 | references/hybrid-cache.md |
| YARP | reverse proxy, load balancing, API gateway, BFF | YARP 反向代理、负载均衡、健康检查、转换 | references/yarp.md |
| 输出缓存 | OutputCache, response caching, compression | 输出/响应缓存、压缩、CDN、标签失效 | references/output-caching.md |
| 身份认证 | ASP.NET Core Identity, login, MFA, scaffolding | Identity 设置、脚手架、外部提供程序、MapIdentityApi | references/identity-setup.md |
| Office 文档和 PDF | Excel, Word, PowerPoint, PDF, Open XML SDK, spreadsheet, docx, xlsx, PDFsharp, MigraDoc, merge PDF, split PDF, watermark | Open XML SDK、ClosedXML、用于 PDF 创建/读取/合并/拆分/水印的 PDFsharp/MigraDoc | references/office-documents.md |
每周安装次数
51
代码仓库
GitHub 星标数
196
首次出现
2026年2月27日
安全审计
安装于
github-copilot47
codex47
cursor46
amp46
cline46
kimi-cli46
ASP.NET Core APIs, data access, backend services, security, and cloud-native patterns. This consolidated skill spans 32 topic areas. Load the appropriate companion file from references/ based on the routing table below.
Baseline dependency: references/minimal-apis.md defines the core ASP.NET Core Minimal API patterns (route groups, endpoint filters, TypedResults, parameter binding) that apply to most API development tasks. Load it by default when building HTTP endpoints.
Most-shared companion: references/architecture-patterns.md covers vertical slices, request pipelines, error handling, caching, and idempotency patterns used across nearly all ASP.NET Core projects.
| Topic | Keywords | Description | Companion File |
|---|---|---|---|
| Minimal APIs | endpoint, route group, filter, TypedResults | Minimal API route groups, filters, TypedResults, OpenAPI | references/minimal-apis.md |
| Middleware | pipeline ordering, short-circuit, exception | Pipeline ordering, short-circuit, exception handling | references/middleware-patterns.md |
| EF Core patterns | DbContext, migrations, AsNoTracking | DbContext, AsNoTracking, query splitting, migrations | references/efcore-patterns.md |
| EF Core architecture | read/write split, aggregate boundaries, N+1 | Read/write split, aggregate boundaries, N+1 | references/efcore-architecture.md |
| Data access strategy | EF Core vs Dapper vs ADO.NET decision | EF Core vs Dapper vs ADO.NET decision matrix | references/data-access-strategy.md |
| gRPC | proto, code-gen, streaming, auth | Proto definition, code-gen, ASP.NET Core host, streaming | references/grpc.md |
| Real-time | SignalR, SSE, JSON-RPC, gRPC streaming | SignalR hubs, SSE, JSON-RPC 2.0, scaling | references/realtime-communication.md |
| Resilience | Polly v8, retry, circuit breaker, timeout | Polly v8 retry, circuit breaker, timeout, rate limiter | references/resilience.md |
| HTTP client | IHttpClientFactory, typed/named, DelegatingHandler | IHttpClientFactory, typed/named clients, DelegatingHandlers | references/http-client.md |
| API versioning | Asp.Versioning, URL/header/query, sunset | Asp.Versioning.Http/Mvc, URL/header/query, sunset | references/api-versioning.md |
| OpenAPI | MS.AspNetCore.OpenApi, Swashbuckle, NSwag | MS.AspNetCore.OpenApi, Swashbuckle migration, NSwag | references/openapi.md |
| API security | Identity, OAuth/OIDC, JWT, CORS, rate limiting | Identity, OAuth/OIDC, JWT bearer, CORS, rate limiting | references/api-security.md |
| OWASP | injection, auth, XSS, deprecated APIs | OWASP Top 10 hardening for .NET | references/security-owasp.md |
| Secrets | user secrets, env vars, rotation | User secrets, environment variables, rotation | references/secrets-management.md |
| Cryptography | AES-GCM, RSA, ECDSA, hashing, key derivation | AES-GCM, RSA, ECDSA, hashing, PQC key derivation | references/cryptography.md |
| Background services | BackgroundService, IHostedService, lifecycle | BackgroundService, IHostedService, lifecycle | references/background-services.md |
| Aspire | AppHost, service discovery, dashboard | AppHost, service discovery, components, dashboard | references/aspire-patterns.md |
| Semantic Kernel | AI/LLM plugins, prompts, memory, agents | AI/LLM plugins, prompt templates, memory, agents | references/semantic-kernel.md |
| Architecture | vertical slices, layered, pipelines, caching | Vertical slices, layered, pipelines, caching | references/architecture-patterns.md |
| Messaging | Wolverine, Azure Service Bus, RabbitMQ, pub/sub, sagas | Wolverine, Azure Service Bus, RabbitMQ, pub/sub, sagas | references/messaging-patterns.md |
| Service communication | REST vs gRPC vs SignalR decision matrix | REST vs gRPC vs SignalR decision matrix | references/service-communication.md |
| API surface validation | PublicApiAnalyzers, Verify, ApiCompat | PublicApiAnalyzers, Verify snapshots, ApiCompat | references/api-surface-validation.md |
| Library API compat | binary/source compat, type forwarders | Binary/source compat, type forwarders, SemVer | references/library-api-compat.md |
| I/O pipelines | PipeReader/PipeWriter, backpressure, Kestrel | PipeReader/PipeWriter, backpressure, Kestrel | references/io-pipelines.md |
| Agent gotchas | async misuse, NuGet errors, DI mistakes | Common agent mistakes in .NET code | references/agent-gotchas.md |
| File-based apps | .NET 10, directives, csproj migration | .NET 10 file-based C# apps | references/file-based-apps.md |
| API docs | DocFX, OpenAPI-as-docs, versioned docs | DocFX, OpenAPI-as-docs, versioned documentation | references/api-docs.md |
| HybridCache | HybridCache, L1/L2, stampede, tag eviction | HybridCache (.NET 9+), stampede protection, tag-based eviction | references/hybrid-cache.md |
| YARP | reverse proxy, load balancing, API gateway, BFF | YARP reverse proxy, load balancing, health checks, transforms | references/yarp.md |
| Output caching | OutputCache, response caching, compression | Output/response caching, compression, CDN, tag invalidation | references/output-caching.md |
| Identity | ASP.NET Core Identity, login, MFA, scaffolding | Identity setup, scaffolding, external providers, MapIdentityApi | references/identity-setup.md |
| Office documents and PDF | Excel, Word, PowerPoint, PDF, Open XML SDK, spreadsheet, docx, xlsx, PDFsharp, MigraDoc, merge PDF, split PDF, watermark | Open XML SDK, ClosedXML, PDFsharp/MigraDoc for PDF create/read/merge/split/watermark | references/office-documents.md |
Weekly Installs
51
Repository
GitHub Stars
196
First Seen
Feb 27, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
github-copilot47
codex47
cursor46
amp46
cline46
kimi-cli46
lark-cli 共享规则:飞书资源操作指南与权限配置详解
47,000 周安装