wpf-coding-standards

WPF Coding Standards - 통합 패키지

포함 파일

wpf-coding-standards/
├── SKILL.md                              # 이 파일 (핵심 예시)
├── agents/                               # source-only 규칙 참고 (명시적 로드)
│   └── wpf-coding-standards.md           # 런타임 에이전트로 등록하지 않음
└── templates/                            # 코드 템플릿 (on-demand)
    ├── wpf-patterns.md                   # MVVM, DI, Navigation, Converter, Behavior
    └── threading-memory.md              # 스레딩 상세, 메모리 프로파일링, GPU 최적화

---

참조 로딩 규칙

1. 이 SKILL.md를 워크플로와 예시의 소유자로 사용합니다.
2. 스킬을 명시적으로 호출했을 때 agents/wpf-coding-standards.md를 읽고 현재 프로젝트에 필요한 규칙만 적용합니다.
3. MVVM/Navigation 또는 스레딩/메모리 상세가 필요할 때만 해당 templates/ 파일을 추가로 읽습니다.

agents/ 파일이 자동 로드되거나 커스텀 에이전트로 등록되어 있다고 가정하지 마세요.

---

MVVM Toolkit 설정 (.NET 8+)

NuGet 패키지

<ItemGroup>
    <PackageReference Include="CommunityToolkit.Mvvm" Version="8.*" />
    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="8.*" />
</ItemGroup>

App.xaml.cs (DI 설정)

public partial class App : Application
{
    private readonly IServiceProvider _services;

    public App()
    {
        var services = new ServiceCollection();

        // 서비스 (Singleton = 앱 수명 동안 1개)
        services.AddSingleton<IAppSettings, AppSettings>();
        services.AddSingleton<INavigationService, NavigationService>();
        services.AddSingleton<IDataService, DataService>();

        // ViewModel (Transient = 매번 새로 생성)
        services.AddTransient<MainViewModel>();
        services.AddTransient<SettingsViewModel>();

        // View
        services.AddSingleton<MainWindow>();

        _services = services.BuildServiceProvider();
    }

    protected override void OnStartup(StartupEventArgs e)
    {
        _services.GetRequiredService<MainWindow>().Show();
    }
}

---

ViewModel 코드 예시

MVVM Toolkit (Source Generator)

public partial class ItemListViewModel : ObservableObject
{
    private readonly IDataService _dataService;
    private CancellationTokenSource? _cts;

    public ItemListViewModel(IDataService dataService)
    {
        _dataService = dataService;
    }

    [ObservableProperty]
    private ObservableCollection<ItemViewModel> _items = [];

    [ObservableProperty]
    private ItemViewModel? _selectedItem;

    [ObservableProperty]
    private bool _isLoading;

    [ObservableProperty]
    private string _searchText = string.Empty;

    // 소스 제너레이터가 LoadItemsCommand 자동 생성
    [RelayCommand]
    private async Task LoadItemsAsync()
    {
        _cts?.Cancel();
        _cts = new CancellationTokenSource();
        IsLoading = true;

        try
        {
            var data = await Task.Run(
                () => _dataService.GetAllAsync(_cts.Token), _cts.Token);

            Items = new ObservableCollection<ItemViewModel>(
                data.Select(d => new ItemViewModel(d)));
        }
        catch (OperationCanceledException) { /* 취소됨 */ }
        finally
        {
            IsLoading = false;
        }
    }

    [RelayCommand(CanExecute = nameof(CanDeleteItem))]
    private void DeleteItem(ItemViewModel item)
    {
        Items.Remove(item);
    }

    private bool CanDeleteItem(ItemViewModel? item) => item is not null;

    // SearchText 변경 시 자동 필터링
    partial void OnSearchTextChanged(string value)
    {
        // 필터링 로직
    }
}