跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

coverage

The 95% line coverage gate - what counts, what is excluded and why, and how to measure it locally the same way the pipeline does. Use when coverage fails, when adding code that is hard to test, or before opening a pull request.

LeanMeanCleanApps · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add LeanMeanCleanApps/CleanMinimalApi --skill coverage

技能说明


name: coverage description: The 95% line coverage gate - what counts, what is excluded and why, and how to measure it locally the same way the pipeline does. Use when coverage fails, when adding code that is hard to test, or before opening a pull request. metadata: scope: shared

Coverage

The rule

Total line coverage across every test project, merged into one report, must be at least 95%. The pipeline fails below that, and nobody lowers the number. Coverage comes from Coverlet (coverlet.msbuild).

Excluded on purpose, and only these:

ExcludedHowWhy
Program.csExcludeByFileStartup glue, exercised by integration tests but not meaningfully measurable
Migrations/*.csExcludeByFileGenerated by EF Core
obj/** and [GeneratedCode]ExcludeByFile, ExcludeByAttributeSource generators (Mediator, Mapperly, JSON)
Wiring and plain models[ExcludeFromCodeCoverage] on the classDependency registration (DependencyInjection), startup extensions, database models with no logic

Steps

  1. Measure locally with the same settings as the pipeline (run from the repository root):

    dotnet test -m:1 \
      -p:CollectCoverage=true -p:CoverletOutput=../results/ -p:MergeWith="../results/coverage.json" \
      -p:CoverletOutputFormat=opencover%2cjson \
      -p:ExcludeByFile="**/Program.cs%2c**/Migrations/*.cs%2c**/obj/**/*.cs" \
      -p:ExcludeByAttribute="GeneratedCodeAttribute"
    

    The last table printed shows the merged total.

  2. Uncovered lines? Write a test for the behaviour (unit-tests, integration-tests). Branches that can't happen usually mean the code can be simpler.

  3. Use [ExcludeFromCodeCoverage] only for wiring and plain data classes, never for code with decisions in it.

Don't

  • Lower the threshold, or add a file pattern to the exclusions to get green.
  • Add [ExcludeFromCodeCoverage] to a handler, validator, repository, endpoint or mapper.
  • Write tests that execute lines without asserting anything.

Check

The command in step 1, or push and read the Test row of the pipeline's Summary comment.