dotnet-patterns

dotnet-patterns 技能概览

dotnet-patterns 适合做什么

dotnet-patterns 技能帮助你编写和审查符合 C# 习惯的后端代码：更清晰的模型、更明确的依赖、更安全的 async 代码，以及更易维护的 ASP.NET Core 服务。它更适合想要一份实用的 .NET 模式指南，而不是泛泛的“把代码写好一点”提示的开发者。

适合谁安装

如果你用 C# 开发 API、服务或类库，并且希望在不可变性、显式性、依赖注入以及 async/await 上有更稳妥的默认做法，就应该安装 dotnet-patterns 技能。它尤其适合 dotnet-patterns for Backend Development 这类场景：当代码质量、可维护性和重构速度比快速原型更重要时，它会特别有用。

它有什么不同

这个技能对实现方式有明确倾向，不只是停留在架构口号上。它的价值在于把宽泛的最佳实践变成可执行的习惯：什么时候用 records，怎样让依赖关系更显式，以及如何避免不清楚的可空性或隐藏副作用。也正因为如此，当你需要可重复的输出时，dotnet-patterns 比一次性的提示词更有用。

如何使用 dotnet-patterns 技能

安装并激活它

先通过你的技能工具链走 dotnet-patterns install 流程，然后在任务涉及新 C# 代码、代码审查、重构或 ASP.NET Core 服务设计时启用该技能。如果你的环境使用的是类似 Claude Code 的技能管理方式，仓库里展示的安装命令是最快路径：npx skills add affaan-m/everything-claude-code --skill dotnet-patterns。

给它一个具体的 .NET 任务

这个技能在你的提示词明确说明目标层、代码形态和约束时效果最好。比较好的输入会包含仓库上下文、框架版本，以及你想解决的痛点。例如：“在不改变对外行为的前提下，把这个 ASP.NET Core 服务重构为使用不可变请求模型、显式空值检查和构造函数注入。” 这比“改进这段代码”强得多。

先读对文件

先从 SKILL.md 开始，因为这里包含了激活线索和技能要执行的核心规则。如果你的仓库还有更多技能资源，再查看 README.md、AGENTS.md、metadata.json，以及任何 rules/、resources/ 或 references/ 目录。在这个仓库里，主要信号集中在 SKILL.md，所以没必要在一大堆辅助树里来回翻找。

把这个技能当作审查清单

用于代码生成时，要求它输出代码，并为每个模式选择附上简短理由。用于审查时，要求它标出哪些地方的可变性、隐式行为或不清晰的生命周期管理削弱了设计。如果你在比较方案，让它给出推荐做法和简短的权衡总结，这样 dotnet-patterns usage 会更聚焦于后端可维护性，而不是单纯的风格偏好。

dotnet-patterns 技能常见问题

dotnet-patterns 只适合后端吗？

不完全是，但它最适合的确实是后端和服务端代码。dotnet-patterns 指南围绕 C# 应用结构展开，因此在 ASP.NET Core、API、领域服务和共享类库中最有价值。

这会取代普通提示词吗？

它会通过加入一致的约束来增强普通提示词。普通提示词可以要求“最佳实践”，但 dotnet-patterns 技能提供的是可复用的模式视角：不可变数据、显式依赖和清晰意图。这样通常能产出更可预测的代码，也更少需要后续修正。

对初学者友好吗？

如果你已经懂基本的 C# 语法，那答案是肯定的。这个技能对需要示例来理解什么是“好”的 .NET 代码的初学者很有帮助，但它默认你是在构建真实应用代码，而不是从零学习 C#。

什么时候不该用它？

如果你要的是 UI 密集型指导、非 .NET 技术栈，或者那种刻意打破模式的高实验性架构，就不要依赖它。如果任务只是一个一次性脚本，或者一次性的迁移，那么它附带的主张可能比你真正需要的更多。

如何改进 dotnet-patterns 技能

提供更强的代码上下文

最好的结果来自你直接展示想要修改的实际类、接口或端点，以及真正重要的约束。请包含框架版本、代码是否属于 public API，以及行为是否必须保持稳定。dotnet-patterns 在能看到权衡面，而不是靠猜测时，效果最好。

要求你想要的模式，而不只是要一个修复

如果你想要不可变性，就明确说明。如果你想要显式的空值处理，就要求重构优先使用 guard clauses 和 required members。如果你要的是 dotnet-patterns for Backend Development，就把服务边界、DI 风格和 async 预期说清楚，这样输出才能真正贴合使用场景。

留意常见失败模式

最常见的问题是过度重构：答案看起来“更干净”，但对你的代码库来说却更不实用。另一个失败模式是表层模式匹配，也就是响应里用了 records 或构造函数注入，却没有先判断对象到底是 value object、DTO 还是长期存在的服务。遇到第一版忽略这些区别时，要及时指出来。

通过有针对性的追问继续迭代

在第一版输出之后，再来一轮聚焦明确的追问：“减少分配”、“保持 public 签名不变”、“补上可空性注解”或“让服务更容易测试”。这类追问能帮助 dotnet-patterns 技能产出更小、更准确的改进，而不是给出一份笼统的大重写。