Cursor与.NET周报：七个实战规则

Rule 5：Minimal API Groups

对 .NET 9 服务使用 MapGroup 和 EndPoints。这样可以保持 context window 精简且聚焦，相比庞大的 Controllers，AI 能提供更精准的代码建议。

→ 博客永久链接

Rule 4：Validator Enforcement

每个 MediatR Request 必须有一条 FluentValidation 规则。强制 AI 在编写 handler 逻辑之前先检查 validator。这能防止"上下文腐化"——即 AI 遗忘你的业务约束条件。

→ 博客永久链接

Rule 3：Structured Logging

强制使用带结构化模板的 ILogger。日志中绝不要使用字符串插值。这样当把日志反馈给 Cursor 用于调试时，AI 能立即识别出模式。

→ 博客永久链接

Rule 2：Persistence Boundaries

绝不允许 AI 在 Controllers 里写数据库逻辑。严格执行边界规则，所有 IQueryable 访问都必须在 Infrastructure 层完成。这让业务逻辑对 LLM 保持"纯粹"和可读。

→ 博客永久链接

Rule 1：The Result Pattern

停止用 null 做流程控制。使用 Result 对象强制 Cursor 显式处理成功和失败两种情况。这能将 Web API 中 AI 生成的逻辑错误减少 90%。

→ 博客永久链接

Rule 25：ActivitySource for OpenTelemetry

仅靠日志无法调试分布式系统。每个项目添加一个 static readonly ActivitySource，并用 StartActivity 包装所有外部调用（DB、HTTP、队列）。Cursor 自身不会添加 OTEL spans——你需要制定一条规则，让它识别外部调用模式并建议添加 trace。

→ 博客永久链接

Rule 24：ValueTask Only When Justified

ValueTask 是针对频繁同步返回的热路径的性能优化手段。它并不是 Task 的替代品。Cursor 会不加思索地来回替换它们。标记 ValueTask 返回值，并追问该方法是否实际上是偏向同步的。如果不是，就改回 Task。

→ 博客永久链接

Try one rule before you trust the whole kit

免费的 arch-core-lite.mdc 是一份可以直接注入的 Cursor 规则，能终结每天早上重新解释一遍的 ritual。60 秒安装完毕，看看 Cursor 到底能不能记住你的 DI 生命周期，然后自行判断完整工具包值不值 £9.00。

Free sample：arch-core-lite.mdc on GitHub

Full kit（£9.00，一次性购买）：Agentic Architect Kit

Daily rules feed：https://agentic-architect.dev/blog/

所有摘要内容的规范来源：https://agentic-architect.dev/blog/。