需要对 .NET 项目做整体健康度评分…

适用于 .NET 项目整体健康评估、预发布质量门禁、月度维护审查和清理后复评，输出带 GPA 与优先修复项的报告卡。

适用场景

解决思路

1. 运行数据驱动的 8 维健康评估，每维给 A-F 等级，并记录产生该等级的具体数据点，最后汇总为 GPA；不要凭感觉评分。
2. 每个低于 A 的维度都必须给出具体、按优先级排序、带工作量估算的修复建议；例如指出具体类型/文件，而不是泛泛写“提高测试覆盖率”。
3. 该技能拥有套件的规范评分系统；运行评估时加载 references/grading-rubric.md 获取完整评分细则、GPA 量表和报告模板。
4. 保持诊断性而非惩罚性的语气：C 是改进路径，不是失败。
5. 按场景选择评估范围：完整评估（入职、预发布、月度审查）评估全部 8 维；快速健康检查（迭代中检查、演示前、合并后）只评估 1-4 维；重大重构后评估 1 Build、3 Architecture、4 Tests；依赖更新后评估 1 Build、7 Security；清理冲刺后只重新评分已清理维度。
6. 先阅读 references/grading-rubric.md 获取各维度等级阈值，再逐维度收集数据；对于深度代码质量维度，委派给 code-reviewer agent 并搭配 code-review skill。
7. 维度 1 Build Health：运行 dotnet build --no-restore，收集错误和警告。
8. 维度 2 Code Quality：使用 MCP detect_antipatterns，读取 summary，只对高置信度发现评分。
9. 维度 3 Architecture：使用 MCP get_project_graph + detect_circular_dependencies，检查项目和类型两个层面的循环依赖。
10. 维度 4 Test Coverage：使用 MCP get_test_coverage_map，先检查 applicable（这是结构性指标，不是行覆盖率）。
11. 维度 5 Dead Code：使用 MCP find_dead_code(scope: "solution")，只对高置信度评分；忽略 conventionFiltered。
12. 维度 6 API Surface：使用 MCP get_public_api + find_references，检查过度暴露和返回类型一致性。
13. 维度 7 Security Posture：运行 dotnet list package --vulnerable --include-transitive，并抽查 secrets/auth；深度扫描用 /security-scan。
14. 维度 8 Documentation：检查公共 API 的 XML 文档覆盖率以及 README 是否最新。
15. 在任何评分前执行分诊门：检测器输出只是证据，不是等级；每个发现都要先过门。
16. 读取 summary，不要读取违规列表本身；summary.byId 即使列表被截断也是完整的；绝不要抽样截断列表后外推。
17. 丢弃 suppressed：记录数量和 summary.suppressionConfig，使压制情况在报告中保持可见。
18. 搁置 medium：它们是审查项，不是评分输入；按类别汇总，不修复也不计数。
19. 只对 high 评分：这些无论上下文都是错误。
20. 检查不变量：如果某信号与目标仓库 CLAUDE.md 中记录为有意为之的内容矛盾，以不变量为准，评分前先验证。
21. 先阅读再断言：不要描述未打开的发现；如果不能打开全部，只报告已打开的并说明。
22. 逐步填写 references/grading-rubric.md 中的分诊表；如果表无法填写，该维度就不具备评分条件。
23. 严格套用评分细则阈值，绝不按曲线评分（“对这个项目规模来说已经不错”会导致标准滑坡；15 个警告无论项目大小都是 C）。
24. 转换为 GPA（A=4.0 … F=0.0），只对实际已评分维度取平均；标记为 Not assessed 的维度从 GPA 中排除，绝不能按 F 计分。
25. 用 references/grading-rubric.md 模板生成报告卡：等级表含关键发现、总体 GPA、优先建议；每条建议包含具体类型/文件、优先级顺序和工作量估算。
26. 如果存在上一次报告，追加趋势对比表。

适用边界 · 注意事项

• 不适用于只评估单个变更集的通过/失败验证；该场景用 /verify。
• 不适用于替代深度安全扫描；第 7 维只做漏洞包检查与 secrets/auth 抽查，深潜用 /security-scan。
• 不适用于逐变更代码审查；该场景用 /code-review。