用途:为 .NET 仓库在 CI 中建立或收紧代码质量门禁,适用于新增或调整格式化、静态分析、覆盖率、变异测试、架构测试等质量栈决策,以及统一 .editorconfig、dotnet format 与警告策略。不适用于非 .NET 仓库、无 .NET 质量栈决策的通用 CI/CD 指导,或与质量门禁无关的框架测试编写。
主要能力:以仓库原生基线为起点(仓库根 .editorconfig、dotnet format --verify-no-changes、显式 EnableNETAnalyzers/AnalysisLevel 与警告策略);仅在确有缺口时引入第三方分析器(StyleCopAnalyzers、Roslynator、Meziantou.Analyzer 及 xUnit/MSTest/TUnit 等框架分析器);按用途拆分门禁(格式化与风格、正确性与静态分析、覆盖率与报告、架构规则、安全扫描、变异测试);复杂度采用 CA1502 阈值、AGENTS.md 可维护性限制与架构测试等组合方式;在 AGENTS.md 与 CI 中明确各命令归属。
使用方式:先读取最近的 AGENTS.md 确认范围与约束,按 Workflow 经 Ralph Loop 迭代执行,返回规定结果格式(status、plan、actions_taken、validation_skills、verification、remaining)。若门禁未配置,先检测 .csproj、Directory.Build.*、.editorconfig、工具清单与 CI 工作流现状,每类门禁只选一个负责命令,安装最小依赖并提交配置文件,接入 AGENTS.md 与 CI 后运行首次验证。工具专属设置尽量路由到 format、code-analysis、analyzer-config、stylecop-analyzers、roslynator、meziantou-analyzer、coverlet、reportgenerator、netarchtest、archunitnet、codeql 等专用技能。
限制与注意:避免工具职责重叠,引入有主见的格式化器时需说明其替代还是补充 dotnet format;测试输出需控制预算,保留原生 runner 进度与 ANSI,仅展示警告、错误与最终摘要,失败时给出失败测试、根异常与相关栈帧,单次诊断响应上限 80 行或 8 KiB,不自动倾倒完整日志;工具默认保持开源免费,任何许可或托管限制须在成为默认门禁前记录。具体安装命令与版本资料暂未提供。