用途:该技能为生成与审计生产级 C# / .NET 代码提供统一规则源,分为 BUILD(生成)与 AUDIT(审计)两种模式。BUILD 模式下按规则作为默认写法;AUDIT 模式下用各规则文件的审计清单排查违规,按严重级别分类并给出发现报告。
主要能力:规则覆盖现代 C# 惯用法(record、可空引用类型、模式匹配、span、LINQ、C# 12–14 特性)、类型与 API 设计、异步与并发、安全、性能、构建工具链与 CI,共 01 至 06 六个规则文件,并列出十条不可协商项:禁止字符串拼接 SQL(须参数化)、禁止不安全反序列化、异步全链路不阻塞、全程传递 CancellationToken、库代码使用 ConfigureAwait(false)、启用并遵守可空引用类型、确定性释放 IDisposable、使用正确加密原语、服务端强制认证授权、以分析器与可空性和锁文件把关 CI。
使用方式:新项目建议目标 net10.0,启用 <Nullable>enable</Nullable>、<TreatWarningsAsErrors>true</TreatWarningsAsErrors>、<AnalysisLevel>latest-Recommended</AnalysisLevel>,使用 NuGet 锁文件与 CI 的 RestoreLockedMode,并从一开始运行 dotnet format。审计时按规则清单运行 grep 与 Roslyn 分析器(含安全 CA 规则),人工确认命中,并对照已知 CVE 数据库检查依赖树。发现格式包含严重级别、文件与行号、规则出处、证据、影响、修复与工作量,按严重级别分组,CRITICAL 优先。
适用场景:编写或审查 .NET Web API、涉及不可信输入、数据库访问与异步的代码,以及配置构建与 CI 流程。
限制:资料未提供具体价格、平台支持范围、性能数据或与其它技能的集成细节;具体控制项所需的最低 .NET 版本需在规则文件中标注,部分高级特性(反射、unsafe、DynamicMethod)需加 NOTE(sota) 说明理由。