用途:对 .NET / ASP.NET Core Web API 项目执行全面的项目健康审计,覆盖技术栈、支持生命周期、依赖安全、架构、SOLID 设计、API 设计、数据层、测试、CI/CD、文档与 AI 工具链,最终输出带评分的 Markdown 报告。
主要能力:按 17 条专用分析规则顺序执行;在支持 Agent 工具的环境(如 Claude Code、Cursor)中采用三层子代理架构(cheap 机械扫描、mid 推理分析、frontier 报告综合),由 agents/orchestrator.md 协调;somnio run CLI 路径则按规则执行顺序单模型串行运行。评分包含 9 个维度、15 个编号章节,并计算加权总分。
使用方式:先执行 MANDATORY 步骤 0,读取并遵循 references/tool-installer.md、version-alignment.md、version-validator.md、test-coverage.md,验证 .NET SDK 与 global.json 对齐、还原/构建解决方案并生成覆盖率;随后按波次执行步骤 1-12(部分可并行),最后执行步骤 13 生成报告、步骤 14 导出。导出命令:mkdir -p reports,报告保存至 ./reports/<YYYY-MM-DD>-<project>-dotnet-health-audit.md。
适用场景:需要客观、基于证据评估 .NET 项目技术健康度、技术债与成熟度的团队。
限制:仅关注技术层面,不提供治理或运维建议(如 CODEOWNERS、SECURITY.md、runbook);证据缺失时报告 Unknown,不臆测;.NET SDK 对齐为建议而非硬性阻断,仅当 dotnet restore/build 真正失败时停止;支持状态由发布节奏规则计算,不硬编码日期表。更深入的安全审查建议使用独立 Security Audit(/somnio:security-audit)。