AgentSkillsCN

write-xaml-tests

在Controls.Xaml.UnitTests项目中，为GitHub问题创建XAML单元测试，重点测试XAML解析、编译（XamlC）以及源代码生成功能。当您需要测试XAML特有的行为，而非关注UI交互时，这一方法将助您事半功倍。

SKILL.md
--- frontmatter
name: write-xaml-tests
description: Creates XAML unit tests for GitHub issues in the Controls.Xaml.UnitTests project. Tests XAML parsing, compilation (XamlC), and source generation. Use when testing XAML-specific behavior, not UI interactions.
metadata:
  author: Stephane Delcroix
  version: "1.0"
compatibility: Requires .NET SDK for building and running xUnit tests.

Write XAML Tests Skill

Creates XAML unit tests that verify XAML parsing, XamlC compilation, and source generation behavior.

When to Use

  • •✅ Testing XAML parsing/inflation behavior
  • •✅ Testing XamlC (IL generation) correctness
  • •✅ Testing Source Generator output
  • •✅ XAML-specific bugs (bindings, markup extensions, x:Name, etc.)

When NOT to Use

  • •❌ Testing UI interactions or visual behavior → Use write-ui-tests skill
  • •❌ Testing runtime behavior after page loads → Use write-ui-tests skill
  • •❌ Testing platform-specific rendering → Use write-ui-tests skill

Required Input

Before invoking, ensure you have:

  • •Issue number (e.g., 12345)
  • •Issue description - what XAML behavior is broken
  • •Expected vs actual behavior

Workflow

Step 1: Read the XAML Unit Test Guidelines

bash
cat .github/instructions/xaml-unittests.instructions.md

This contains the authoritative conventions for:

  • •File naming (MauiXXXXX.xaml and MauiXXXXX.xaml.cs)
  • •File location (src/Controls/tests/Xaml.UnitTests/Issues/)
  • •Test patterns with [Values] XamlInflator
  • •XamlC testing with MockCompiler
  • •Source Generator testing with MockSourceGenerator
  • •Special file extensions for invalid codegen (.rt.xaml, .rtsg.xaml, .rtxc.xaml)

Step 2: Create Test Files

Following the conventions from Step 1, create:

  • •src/Controls/tests/Xaml.UnitTests/Issues/MauiXXXXX.xaml
  • •src/Controls/tests/Xaml.UnitTests/Issues/MauiXXXXX.xaml.cs

Step 3: Verify Tests Compile and Run

bash
# Build the test project
dotnet build src/Controls/tests/Xaml.UnitTests/Controls.Xaml.UnitTests.csproj -c Debug --no-restore -v q

# Run specific test
dotnet test src/Controls/tests/Xaml.UnitTests/Controls.Xaml.UnitTests.csproj --filter "FullyQualifiedName~MauiXXXXX" --no-build

Step 4: Verify Test Behavior

  • •For bug reproduction tests: Tests should FAIL before fix, PASS after fix
  • •For regression tests: Tests should PASS to confirm behavior works

Output

After completion, report:

markdown
✅ XAML unit test created for Issue #XXXXX

**Files:**
- `src/Controls/tests/Xaml.UnitTests/Issues/MauiXXXXX.xaml`
- `src/Controls/tests/Xaml.UnitTests/Issues/MauiXXXXX.xaml.cs`

**Test method:** `DescriptiveTestName`
**Inflators tested:** Runtime, XamlC, SourceGen
**Verification:** Tests [PASS/FAIL] as expected

References

  • •Full conventions: .github/instructions/xaml-unittests.instructions.md
  • •Test project: src/Controls/tests/Xaml.UnitTests/
  • •Existing issue tests: src/Controls/tests/Xaml.UnitTests/Issues/