| name | dotnet-build-test |
| description | Build and test the DotSerial project. Use when asked to build, run tests, check CI status, or verify that changes don't break the build or test suite.
|
| allowed-tools | shell |
DotSerial Build and Test Skill
When asked to build or test DotSerial, follow this process:
1. Restore dependencies (if needed)
dotnet restore
2. Build (check for zero warnings — TreatWarningsAsErrors is on)
dotnet build
A clean build must produce zero errors and zero warnings.
3. Run unit tests
dotnet test tests/DotSerial.Tests.Unit
4. Run a specific test class or method
dotnet test --filter "FullyQualifiedName~{ClassName}"
dotnet test --filter "FullyQualifiedName~SerialPortSettingsTests"
5. Run with coverage report
dotnet test tests/DotSerial.Tests.Unit --collect:"XPlat Code Coverage"
6. Run all tests (unit + integration)
Integration tests require a real or virtual COM port — skip on machines without one.
dotnet test
Interpreting results
- If the build fails with warnings: fix every warning (they are errors here).
- If a test fails: read the failure message, identify the failing test class, and investigate the relevant source file.
- Do NOT suppress warnings with
#pragma warning disable or <NoWarn> unless absolutely necessary and documented.
